stepw66 / ishare2

Tool designed to download images into a PNETLab server

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

ishare2

CLI-based Bash tool used to download and install images into a PNETLab server automatically and with minimal efforts

⭐New: Since v1.5.7, a web app was released to use ishare2 in a browser. App is named ishare2 GUI

πŸ› οΈ Language

Bash 

πŸš€ Installation

There are two methods to install ishare2 in your terminal. Choose one of the following options:

wget

wget -O /usr/sbin/ishare2 https://raw.githubusercontent.com/pnetlabrepo/ishare2/main/ishare2 > /dev/null 2>&1 && chmod +x /usr/sbin/ishare2 && ishare2

curl

curl -o /usr/sbin/ishare2 https://raw.githubusercontent.com/pnetlabrepo/ishare2/main/ishare2 > /dev/null 2>&1 && chmod +x /usr/sbin/ishare2 && ishare2

Note: There is no need to be in the same directory where ishare2 file is installed in order to execute it

βœ… Syntax

ishare2 [action] [param1] [param2]

action:
  search      : Search for images by type
  pull        : Download an image by type and number
  installed   : Show installed images on server
  labs        : Show labs on server and download images for those labs
  mylabs      : Same as labs command but using a customized path to labs
  relicense   : Generate a new iourc license for bin images
  upgrade     : Retrieves a menu that allows users to upgrade ishare2 and PNETLab VM
  changelog   : Show the latest changes made to ishare2
  gui         : Web app to use ishare2 in browser
  help        : Show useful information

param1:
  type = all, bin, qemu, dynamips, docker or name

param2:
  number = This number can be obtained using ishare2 search <type>

Examples of usage

πŸ’Ž Search for images

- ishare2 search <type>
    - ishare2 search all
    - ishare2 search bin
    - ishare2 search qemu
    - ishare2 search dynamips
    - ishare2 search <name>
        Examples:
          - ishare2 search vios
          - ishare2 search win-
          - ishare2 search winserver
          - ishare2 search kali
          - ishare2 search mikro
          - ishare2 search forti
          - ishare2 search nxos
          - ishare2 search vmx
          - ishare2 search esxi
          - ishare2 search palo
          - ishare2 search Licensed

You can get more <name> options by using ishare2 search all

πŸ’Ž Pull images by number

- ishare2 pull bin <number>
- ishare2 pull qemu <number>
- ishare2 pull dynamips <number>

<number> can be obtained by using ishare2 search <type>

πŸ’Ž Pull all images at once

- ishare2 pull bin all
- ishare2 pull qemu all (Not available for qemu type due to its large size)
- ishare2 pull dynamips all

πŸ’Ž Show which images were installed

- ishare2 installed all
- ishare2 installed bin
- ishare2 installed qemu
- ishare2 installed dynamips
- ishare2 installed docker

πŸ’Ž Download every image available in a lab that was downloaded from PNETLab Store

- ishare2 labs
- ishare2 labs <number>
- ishare2 labs all

Not available to every lab because some of them were encrypted by authors and cannot be analyzed

πŸ’Ž Download every image available in a lab downloaded at a custom location in your server

- ishare2 mylabs <path>
- ishare2 mylabs <path> <number>
- ishare2 mylabs <path> all

πŸ’Ž GUI

- ishare2 gui download
- ishare2 gui start
- ishare2 gui stop
- ishare2 gui restart

πŸ’Ž Extras

- ishare2 relicense
- ishare2 upgrade
- ishare2 changelog
- ishare2 help

Useful information

HELP.md

See the latest changes on ishare2

CHANGELOG.md

How to upgrade your PNETLab server

Note: You can also upgrade PNETLab using ishare2 upgrade, then using the option 2 and finally selecting an option from the displayed list

Known limitations

  • Avoid to cancel a download in progress: (IN PROCESS TO FIX IT)

    If you cancel a download in progress, next time you try to download it you will not be allowed to do it because ishare2 will recognize it already exists in the server

    In this case, you will have to manually remove it in order to be able to restart the download

✨ Links

✨ Useful resources

Check these links to get information on device credentials

❓Need help?

Get in touch with us using our Chat on Telegram

About

Tool designed to download images into a PNETLab server


Languages

Language:Shell 77.8%Language:Python 15.1%Language:Batchfile 4.0%Language:PHP 1.8%Language:Perl 1.3%