ishare2
CLI-based tool written in Bash used to download and install images into a PNETLab server automatically and with minimal efforts
Installation
Apply this command using the terminal
wget -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 : Upgrade ishare2 code to the latest version
help : Show useful information
param1:
type = all, bin, qemu, dynamips or name
param2:
number = This number can be obtained using ishare2 search <type>
Examples of usage
- 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
- More <name> options using ishare2 search all
- ishare2 pull bin <number>
- ishare2 pull qemu <number>
- ishare2 pull dynamips <number>
- ishare2 pull bin all
- ishare2 pull qemu all (Unavailable for qemu type)
- ishare2 pull dynamips all
- ishare2 installed all
- ishare2 installed bin
- ishare2 installed qemu
- ishare2 installed dynamips
- ishare2 labs
- ishare2 labs <number>
- ishare2 labs all
- ishare2 mylabs <path>
- ishare2 mylabs <path> <number>
- ishare2 mylabs <path> all
- ishare2 relicense
- ishare2 upgrade
- ishare2 help
Useful information
1) For problems, use our Telegram Channel describing your problem and sending a screenshot and/or a video
2) For new files to be uploaded, you can use our Telegram Channel too. In this case, you can send or ask for new images to be uploaded
3) Using ishare2 upgrade will result in upgrading this utility (ishare2). It will not upgrade your PNETLab Ubuntu VM version
4) If CiscoIOUKeygen.py, iourc and/or keepalive.pl files in /opt/unetlab/addons/iol/bin/ are deleted, you can recover them by using ishare2 relicense. This will not affect images in there
Also, this command when used, will generate a new license file called "iourc", needed for bin files
5) Don't cancell a download. In case you do it, you will have to remove incomplete files or folders manually
6) The main difference between ishare2 labs and ishare2 mylabs is that, in the first case, the folder used is the one PNETLab creates when you download a lab from the store and in the second case you are able to select any folder you want in order to download labs
Telegram Channel: https://t.me/unetlab_cloud
How to upgrade your PNETLab server to v5.0.1
Only applicable for cases where your PNETLab version is 4.2.10:
Copy and paste this command in your server
wget -O upgrade.sh https://raw.githubusercontent.com/pnetlabrepo/ishare2/main/upgrades/to_5.0.1/upgrade.sh > /dev/null 2>&1 && chmod +x upgrade.sh && bash upgrade.sh
After a few seconds, the upgrade will be done.
Note: This upgrade does not use ishare2: It just downloads the upgrade.sh file from this repository and executes it using the same instructions described in the PNETLab Official website "How to Upgrade PNETLab? Section 2. PNETLab can not connect to Internet."
Known Limitations
-
Avoid to cancel a download in progress:
You will not be allowed to download that image again because ishare2 will recognize that your file/folder already exists in the server. In this case, you will have to manually remove that file/folder
Links
Images (QEMU, bin and dynamips) can be found at unetlab.cloud
Useful resources
There are 2 Excel and 1 PNG password files for device credentials
Need help?
Get in touch with us using our Telegram Channel: PNETLab platform Group