ishare2

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

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

## :hammer_and_wrench: Language
Bash 
## πŸš€ Installation Apply this command using the terminal ```linux 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 : 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 ## Examples of usage ## πŸ’Ž Search for images - ishare2 search - ishare2 search all - ishare2 search bin - ishare2 search qemu - ishare2 search dynamips - ishare2 search 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 options by using ishare2 search all` ## πŸ’Ž Pull images by number - ishare2 pull bin - ishare2 pull qemu - ishare2 pull dynamips ` can be obtained by using ishare2 search ` ## πŸ’Ž 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](https://user.pnetlab.com/store/labs/view) - ishare2 labs - ishare2 labs - 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 - ishare2 mylabs - ishare2 mylabs 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](https://github.com/pnetlabrepo/ishare2/blob/main/HELP.md) ## See the latest changes on ishare2 [CHANGELOG.md](https://github.com/pnetlabrepo/ishare2/blob/main/CHANGELOG.md) ## How to upgrade your PNETLab server - Upgrade from v4.2.10 to v5.0.1: [Instructions](https://github.com/pnetlabrepo/ishare2/tree/main/upgrades/from_4.2.10_to_5.0.1) - Upgrade from any to v5.3.11: [Instructions](https://github.com/pnetlabrepo/ishare2/tree/main/upgrades/from_any_to_5.3.11) 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 * qemu, bin and dynamips images can be found at [unetlab.cloud](https://unetlab.cloud/) * Docker images can be found at [hub.docker.com](https://hub.docker.com/) ## ✨ Useful resources Check these links to get information on device credentials * [Excel file #1: passwords_eve.xlsx](https://unetlab.cloud/UNETLAB%20I/addons/passwords/passwords_eve.xlsx) * [Excel file #2: Passwords - QEMU.xls](https://unetlab.cloud/UNETLAB%20II/Passwords%20-%20QEMU.xls) * [PNG file: Eve-NG-Linux.png](https://unetlab.cloud/UNETLAB%20II/qemu/Linux/Eve-NG-Linux/Eve-NG-Linux.png) ## ❓Need help? [ico-telegram]: https://img.shields.io/badge/@PNETLab_Platform_Group-2CA5E0.svg?style=flat-square&logo=telegram&label=Telegram [link-telegram]: https://t.me/PNETLab Get in touch with us using our [![Chat on Telegram][ico-telegram]][link-telegram]