services:eecsvm
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
services:eecsvm [2025/05/29 15:49] – [List Available Virtual Machines] jas | services:eecsvm [2025/07/04 09:09] (current) – [EECSVM Service] jas | ||
---|---|---|---|
Line 3: | Line 3: | ||
The EECSVM service allows students to use virtual machines required by courses they are taking. | The EECSVM service allows students to use virtual machines required by courses they are taking. | ||
- | Users will use [[https:// | + | Users will use [[https:// |
- | The lab machines which will support EECSVM service | + | These lab workstations |
^ Lab ^ Cores per Workstation ^ Memory ^ | ^ Lab ^ Cores per Workstation ^ Memory ^ | ||
Line 21: | Line 21: | ||
^ Server ^ Cores per Server ^ Memory ^ | ^ Server ^ Cores per Server ^ Memory ^ | ||
- | | rose | + | | ruby |
- | | ruby | + | | rose |
- | | scarlet | 24 | 256 GB | | + | | scarlet | 28 cores, 56 threads |
- | **NOTE: Due to Microsoft restrictions, | + | **NOTE: Due to Microsoft restrictions, |
===== Check If You Have Access ===== | ===== Check If You Have Access ===== | ||
Line 36: | Line 36: | ||
</ | </ | ||
- | ===== List Available Virtual Machines ===== | + | If you see, "You do not have access to EECSVM service.", |
- | To list available virtual machines that you can install: | + | If you see the following error, then you are attempting to use the EECSVM service from from a system which is not in the above list of workstations or servers: |
< | < | ||
- | % eecsvm list available | + | EECSVM service is not available |
+ | Please view this webpage to see where you can access the EECSVM service: | ||
+ | https:// | ||
+ | </ | ||
+ | |||
+ | ===== List Available Virtual Machines ===== | ||
- | Available VMs To Install: | + | To list available virtual machines that you can install: |
+ | < | ||
+ | % eecsvm list vms | ||
3482-w24-win10 | 3482-w24-win10 | ||
4421 | 4421 | ||
Line 55: | Line 62: | ||
ubuntu-24.04.2-lts-server (alias: ubuntu) | ubuntu-24.04.2-lts-server (alias: ubuntu) | ||
windows11 | windows11 | ||
+ | </ | ||
- | Available | + | ===== List Available |
- | eecs3481-alomari | + | If you are enrolled in a course to which multiple virtual machines will be installed, a VM bundle has likely already been created for the course. |
- | eecs3482-alomari | + | |
- | eecs3482-rts | + | To list available virtual machine bundles: |
- | eecs4484-alomari | + | |
+ | < | ||
+ | % eecsvm list bundles | ||
+ | eecs3481-alomari: | ||
+ | | ||
+ | eecs3482-alomari: | ||
+ | | ||
+ | | ||
+ | | ||
+ | | ||
+ | eecs3482-rts: | ||
+ | | ||
+ | | ||
+ | | ||
+ | eecs4484-alomari: | ||
+ | | ||
+ | | ||
</ | </ | ||
- | Individual VMs (such as Ubuntu) are listed. | + | For example, you can see that the "eecs3482-alomari" |
- | VM bundles are also available (eg. "eecs3481-alomari" | + | |
===== Install A Virtual Machine ===== | ===== Install A Virtual Machine ===== | ||
Line 73: | Line 96: | ||
< | < | ||
% eecsvm install ubuntu-24.04.2-lts-server | % eecsvm install ubuntu-24.04.2-lts-server | ||
- | Installing | + | ubuntu-24.04.2-lts-server |
Virtual machine ' | Virtual machine ' | ||
- | UUID: e00def12-af80-4c38-854e-49a1bcaf0cbc | + | UUID: 3d9d73f1-f655-453a-8555-aa38f84fd350 |
Settings file: '/ | Settings file: '/ | ||
0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% | 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% | ||
- | Medium created. UUID: 95e2c8be-f5f0-43f8-9a1f-ee9a31b6b505 | + | Medium created. UUID: eebee866-d94d-4751-81ad-f538962e14be |
</ | </ | ||
Ubuntu server is installed immediately. | Ubuntu server is installed immediately. | ||
+ | |||
+ | In the listing of available VMs, you can see that ubuntu-24.04.2-lts-server is also aliased to just " | ||
+ | |||
+ | < | ||
+ | % eecsvm install ubuntu | ||
+ | ubuntu VM: | ||
+ | Virtual machine ' | ||
+ | UUID: 69d452a3-d2d5-4f93-98ac-65c6ce921884 | ||
+ | Settings file: '/ | ||
+ | 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% | ||
+ | Medium created. UUID: 5e33e04b-53c2-4e60-b17b-0669b9a390dc | ||
+ | </ | ||
===== Installing a Virtual Machine Multiple Times ===== | ===== Installing a Virtual Machine Multiple Times ===== | ||
- | If you need to install multiple copies of the same VM (say, 3 copies of Ubuntu), then you can give each install its own name: | + | If you need to install multiple copies of the same virtual machine |
< | < | ||
- | % eecsvm install ubuntu-24.04.2-lts-server | + | % eecsvm install ubuntu ubuntu1 |
- | Installing ubuntu1 ... | + | ubuntu VM: |
Virtual machine ' | Virtual machine ' | ||
- | UUID: 2577f6d7-99c3-4818-ace2-cd88dd46ed69 | + | UUID: 8ccb442a-4e77-4b01-bf04-20573072de7e |
Settings file: '/ | Settings file: '/ | ||
0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% | 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% | ||
- | Medium created. UUID: da90b8d3-054e-4414-877b-faacce7c1bb5 | + | Medium created. UUID: 354c50c3-d424-4582-881d-60fcd2623092 |
- | + | % eecsvm install ubuntu ubuntu2 | |
- | % eecsvm install ubuntu-24.04.2-lts-server | + | ubuntu VM: |
- | Installing ubuntu2 ... | + | |
Virtual machine ' | Virtual machine ' | ||
- | UUID: 67417f56-7064-471a-8918-31796dec8abc | + | UUID: ab673026-1ba9-4166-82b0-dcc7da5c35d0 |
Settings file: '/ | Settings file: '/ | ||
0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% | 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% | ||
- | Medium created. UUID: 09c32bb6-59a4-4764-982c-697e0651415a | + | Medium created. UUID: 42d86496-d566-4f19-b8ab-68a42e07fdd6 |
- | + | % eecsvm install ubuntu ubuntu3 | |
- | % eecsvm install ubuntu-24.04.2-lts-server | + | ubuntu VM: |
- | Installing ubuntu3 ... | + | |
Virtual machine ' | Virtual machine ' | ||
- | UUID: 0096fab4-1759-4d5b-9852-bd7ad58de15b | + | UUID: 61aeaf0e-b0a7-4e17-9efc-702e312f1040 |
Settings file: '/ | Settings file: '/ | ||
0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% | 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% | ||
- | Medium created. UUID: 153c6fb2-3898-477a-b401-4738b517652d | + | Medium created. UUID: e9456026-7214-4ed0-b7d2-4be551af7fa8 |
</ | </ | ||
- | ==== Optional Installation Options ==== | + | ==== Optional |
- | Other options which you can use when installing a VM with " | + | Other options which you can use when installing a virtual machine |
- | * -f = force the install to overwrite a previous | + | * --force Force install |
- | * --immutable | + | * --immutable |
- | * --netname | + | * --netname |
For example, to overwrite a previous Ubuntu install, and to create an immutable VM which uses the network name " | For example, to overwrite a previous Ubuntu install, and to create an immutable VM which uses the network name " | ||
< | < | ||
- | % eecsvm install -f --immutable --netname mynet ubuntu-24.04.2-lts-server | + | % eecsvm install --force |
- | Installing ubuntu1 ... | + | ubuntu VM: |
Virtual machine ' | Virtual machine ' | ||
- | UUID: 4e038be3-a871-44bb-a25a-ca90cbf57031 | + | UUID: 3565008e-f109-486a-b47d-dc6b4df96d66 |
Settings file: '/ | Settings file: '/ | ||
0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% | 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% | ||
- | Medium created. UUID: ca1771c7-e9a3-4c9a-9373-9842d144326d | + | Medium created. UUID: 34f31b21-f166-40c5-ae14-9a8b619ac5f8 |
+ | </ | ||
+ | |||
+ | If you haven' | ||
+ | |||
+ | < | ||
+ | % eecsvm install --immutable --netname mynet ubuntu ubuntu1 | ||
+ | ubuntu VM: | ||
+ | error: VM ubuntu1 already exists. | ||
</ | </ | ||
===== Installing a Virtual Machine Bundle ===== | ===== Installing a Virtual Machine Bundle ===== | ||
- | To install a virtual machine bundle, pass the bundle name to the " | + | To install a virtual machine bundle, pass the bundle name to the " |
< | < | ||
% eecsvm installbundle eecs3482-alomari | % eecsvm installbundle eecs3482-alomari | ||
Installing bundle eecs3482-alomari | Installing bundle eecs3482-alomari | ||
- | Installing | + | Processing install --netname secnet |
+ | kali-linux-2025.1c VM: | ||
Virtual machine ' | Virtual machine ' | ||
- | UUID: dfa82c7a-23c8-4132-bfdf-c39922b5ff98 | + | UUID: bf97f58f-1ffe-49d4-8a0e-b27b6ade338a |
Settings file: '/ | Settings file: '/ | ||
0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% | 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% | ||
- | Medium created. UUID: ac99f4ec-68e6-4ab8-a5c6-721fe915512a | + | Medium created. UUID: 9c1610c4-0ff2-4440-8ff5-787d58b673f1 |
- | Installing seed ... | + | Processing install --netname secnet SEED-Ubuntu20.04 seed: |
+ | SEED-Ubuntu20.04 VM: | ||
Virtual machine ' | Virtual machine ' | ||
- | UUID: 8aa22a36-c9fd-4a40-aca0-9225c51871a6 | + | UUID: 56a28c1f-107a-41f4-a557-d9f3d607069e |
Settings file: '/ | Settings file: '/ | ||
0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% | 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% | ||
- | Medium created. UUID: 67d7e11d-9dbf-469a-a441-259325030e86 | + | Medium created. UUID: b1086ee0-4d64-4307-a7cc-6876256fab0b |
- | Installing | + | Processing install --netname secnet metasploitable3-ubuntu14: |
+ | metasploitable3-ubuntu14 | ||
Virtual machine ' | Virtual machine ' | ||
- | UUID: eb0da547-df9f-44ba-9838-12bc1215bf83 | + | UUID: 9f8d52c0-f328-4d23-a4ab-6db8ac647412 |
Settings file: '/ | Settings file: '/ | ||
0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% | 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% | ||
- | Medium created. UUID: f9990525-5538-4a64-8cf6-49cac97bd657 | + | Medium created. UUID: 0f2c9f6c-25e8-4828-940b-cd06aa6d8385 |
- | Installing | + | Processing install --netname secnet metasploitable3-win2k8: |
+ | metasploitable3-win2k8 | ||
Virtual machine ' | Virtual machine ' | ||
- | UUID: 54e13c70-1d5f-4955-95a6-bc430775c2d6 | + | UUID: 37966072-5e59-422f-849c-912d15568b6e |
Settings file: '/ | Settings file: '/ | ||
0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% | 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% | ||
- | Medium created. UUID: bb899898-a7b5-44f4-a2a7-33c765a5ea05 | + | Medium created. UUID: e5a123ab-2c3d-4d27-ac41-5a11129bfbe5 |
</ | </ | ||
- | Here, we can see that several | + | Here, we can see that several |
===== Check Which Virtual Machines You Have Installed ===== | ===== Check Which Virtual Machines You Have Installed ===== | ||
- | To check which virtual machines | + | To check which virtual machines you have installed: |
< | < | ||
% eecsvm list installed | % eecsvm list installed | ||
- | |||
- | User installed VMs: | ||
- | |||
kali | kali | ||
metasploitable3-ubuntu14 | metasploitable3-ubuntu14 | ||
Line 194: | Line 236: | ||
===== Starting a Virtual Machine ===== | ===== Starting a Virtual Machine ===== | ||
- | To start a virtual machine, start the VirtualBox GUI using the " | + | To start a virtual machine: |
< | < | ||
- | % virtualbox | + | % eecsvm start kali |
+ | Waiting for VM " | ||
+ | VM " | ||
</ | </ | ||
- | You can also start the VM from the command line: | + | The virtual machine starts, and you see the VM output in a separate window. |
+ | |||
+ | If you want to start the VM in the background (AKA headless), do it like this: | ||
< | < | ||
- | % vboxmanage startvm | + | % eecsvm start kali --headless |
Waiting for VM " | Waiting for VM " | ||
VM " | VM " | ||
</ | </ | ||
- | **WARNING: | + | Since EECSVM is a wrapper for VirtualBox, you can also start VMs in the VirtualBox GUI. Start VirtualBox by using the " |
+ | |||
+ | **WARNING: | ||
===== Stopping A Virtual Machine ===== | ===== Stopping A Virtual Machine ===== | ||
- | You can stop a running | + | To stop a virtual machine |
- | You can also shut down your VM from the command line: | + | < |
+ | % eecsvm stop kali | ||
+ | Stop sent to VM " | ||
+ | </ | ||
+ | |||
+ | The virtual machine shuts down. | ||
+ | |||
+ | You can also shutdown VMs in the VirtualBox GUI. Right-click on the virtual machine in the left side of the display, and choose " | ||
+ | |||
+ | ===== SSH Access ===== | ||
+ | |||
+ | If your VM is running VirtualBox Guest Additions, and an SSH server, then you can SSH to it from the EECS system where you are running the VM. | ||
+ | |||
+ | For example, if " | ||
< | < | ||
- | vboxmange controlvm | + | % eecsvm ssh kali |
+ | ssh into the VM kali with: ssh < | ||
+ | % ssh kali@localhost -p 26600 | ||
+ | The authenticity of host ' | ||
+ | ED25519 key fingerprint is SHA256: | ||
+ | This key is not known by any other names. | ||
+ | Are you sure you want to continue connecting (yes/ | ||
+ | Warning: Permanently added ' | ||
+ | kali@localhost' | ||
+ | Linux kali 6.12.13-amd64 #1 SMP PREEMPT_DYNAMIC Kali 6.12.13-1kali1 (2025-02-11) x86_64 | ||
+ | |||
+ | The programs included with the Kali GNU/Linux system are free software; | ||
+ | the exact distribution terms for each program are described in the | ||
+ | individual files in / | ||
+ | |||
+ | Kali GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent | ||
+ | permitted by applicable law. | ||
+ | ┌──(kali㉿kali)-[~] | ||
+ | └─$ | ||
</ | </ | ||
+ | NOTE: Every time you run the " | ||
+ | |||
+ | NOTE: As most VMs have well documented username and password, if you are enabling SSH access on a VM, please make sure that you've changed the username or password on your local VM copy. Otherwise, another student could connect to your running VM. | ||
===== Check Your Virtual Machine Storage Quota ===== | ===== Check Your Virtual Machine Storage Quota ===== | ||
Line 229: | Line 311: | ||
</ | </ | ||
- | By default, you have a 20 GB storage quota. | + | By default, you have a 20 GB storage quota. |
===== Reset Your EECSVM Environment ===== | ===== Reset Your EECSVM Environment ===== | ||
Line 237: | Line 319: | ||
< | < | ||
% eecsvm reset | % eecsvm reset | ||
+ | ************************* WARNING ****************************************** | ||
- | *** WARNING | + | This operation will delete |
+ | your VirtualBox configuration. | ||
- | This operation will delete ALL of your virtual machines, and | + | Please ensure that VirtualBox |
- | VirtualBox | + | |
Do you wish to proceed (YES/[no]) ?YES | Do you wish to proceed (YES/[no]) ?YES | ||
- | Deleting /cs/home/testuser/ | + | Deleting /cs/home/jas/ |
Deleting VMs ... | Deleting VMs ... | ||
Done | Done | ||
</ | </ | ||
- | ===== Access Your EECS Home Directory From Inside Your VM ===== | + | ===== Access Your EECS Home Directory From Inside Your Virtual Machine |
- | Your EECS home directory | + | Your EECS home directory |
**Linux** | **Linux** | ||
- | With Linux, your EECS home directory will be available as: / | + | With Linux, your EECS home directory will be available as: / |
- | NOTE: If you are setting up a new virtual machine, or adding additional users to an existing VM, you need to ensure that the user who should be able to access your EECS home directory is in the vboxsf group. | + | NOTE: If you are setting up a new virtual machine, or adding additional users to an existing VM, you need to ensure that: |
- | < | + | * 1) The VirtualBox "Guest Additions" |
+ | * 2) The " | ||
+ | * 3) the user who should be able to access your EECS home directory is in the vboxsf group. | ||
% sudo usermod -aG vboxsf $(whoami) | % sudo usermod -aG vboxsf $(whoami) | ||
</ | </ | ||
Line 265: | Line 350: | ||
**Windows** | **Windows** | ||
- | If the share is available to a Windows VM, it can be mounted | + | * 1) The VirtualBox "Guest Additions" |
+ | * 2) Your home directory is accessible | ||
===== Creating Your Own Virtual Machine ===== | ===== Creating Your Own Virtual Machine ===== | ||
Line 274: | Line 360: | ||
< | < | ||
- | % eecsvm install ubuntu-24.04.2-lts-server | + | % eecsvm install ubuntu my-custom-ubuntu |
- | Installing my-custom-ubuntu | + | ubuntu |
Virtual machine ' | Virtual machine ' | ||
- | UUID: 406608ad-6804-4849-9342-4cab53715ed9 | + | UUID: 6e317972-2718-46c8-aa9e-501cf8c1c5ba |
Settings file: '/ | Settings file: '/ | ||
0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% | 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% | ||
- | Medium created. UUID: 8fc44cdc-125a-475b-8fe3-5599f3ffc785 | + | Medium created. UUID: 6ceff68d-d00a-44dd-958d-714085bcfeed |
</ | </ | ||
- | Next, start the VM, and all the required | + | Next, start the VM, and make any required |
When you're done testing, shut down the VM, and export the VM to tech: | When you're done testing, shut down the VM, and export the VM to tech: | ||
Line 289: | Line 375: | ||
< | < | ||
% eecsvm export my-custom-ubuntu | % eecsvm export my-custom-ubuntu | ||
- | |||
Exporting my-custom-ubuntu (this will take some time) ... | Exporting my-custom-ubuntu (this will take some time) ... | ||
0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% | 0%...10%...20%...30%...40%...50%...60%...70%...80%...90%...100% | ||
Line 298: | Line 383: | ||
This will automatically package up your VM, put it into a holding directory, and send an e-mail to tech to let them know that you've exported a VM. It's a good idea to follow this up with an email to tech to let us know your intention. | This will automatically package up your VM, put it into a holding directory, and send an e-mail to tech to let them know that you've exported a VM. It's a good idea to follow this up with an email to tech to let us know your intention. | ||
- | NOTE: Since all users who use a VM from the repository | + | NOTE: Once a user has installed |
WARNING: While you can install a VM from an ISO image, if you do this, ALL of the disk usage will be counted in your VM quota, and you will likely run out of space. | WARNING: While you can install a VM from an ISO image, if you do this, ALL of the disk usage will be counted in your VM quota, and you will likely run out of space. | ||
Line 304: | Line 389: | ||
===== Other Important Information About EECSVM Service ===== | ===== Other Important Information About EECSVM Service ===== | ||
- | * Data is the EECSVM area is **not backed up**. If you corrupt your disk image, you will need to start again. | + | * Data in the EECSVM area is **not backed up**. If you corrupt your VM disk image, you will need to start again. |
- | * VirtualBox will not monitor if you are running your VM simultaneously on multiple machines. | + | * VirtualBox will not monitor if you are running your VM simultaneously on multiple machines. |
- | * If you're using a lab machine, check the [[https:// | + | * If you're using a lab workstation, please |
* All supported VMs must run on the current VirtualBox version. | * All supported VMs must run on the current VirtualBox version. | ||
Line 314: | Line 399: | ||
* The EECSVM service is intended for **education** students. | * The EECSVM service is intended for **education** students. | ||
- | * At the end of each term, ALL student storage on the EECSVM service will be **deleted** without notice. | + | * At the end of each term, ALL student storage on the EECSVM service will be **deleted** without notice. |
- | * Each user can choose which VMs they install in their storage space. | + | * Each user can choose which VMs they install in their storage space. |
* For additional VirtualBox assistance, refer to the [[https:// | * For additional VirtualBox assistance, refer to the [[https:// | ||
Line 322: | Line 407: | ||
* For more information on VirtualBox command line options, use command " | * For more information on VirtualBox command line options, use command " | ||
- | Here's information on the currently installed VMs for use with the EECSVM service: | + | Here' |
===== Currently Installed VMs ===== | ===== Currently Installed VMs ===== | ||
Line 332: | Line 417: | ||
|4421|4421 VM|na| | |4421|4421 VM|na| | ||
|flarevm|Windows 11 FlareVM with default packages|u: common, p: common| | |flarevm|Windows 11 FlareVM with default packages|u: common, p: common| | ||
- | |kali-linux-2024.4-virtualbox-amd64|Kali Linux|u: kali, p: kali| | + | |kali-linux-2025.1c|Kali Linux|u: kali, p: kali| |
|metasploitable2|Metasploitable 2|u: mfsadmin, p: mfsadmin| | |metasploitable2|Metasploitable 2|u: mfsadmin, p: mfsadmin| | ||
|metasploitable3-ubuntu14|Metasploitable 3|u: vagrant, p: vagrant| | |metasploitable3-ubuntu14|Metasploitable 3|u: vagrant, p: vagrant| | ||
Line 343: | Line 428: | ||
^Name^Description^ | ^Name^Description^ | ||
- | |ecs3481-alomari|SEED| | + | |eecs3481-alomari|SEED| |
|eecs3482-alomari|Kali, | |eecs3482-alomari|Kali, | ||
+ | |eecs3482-rts|Kali, | ||
|eecs4484-alomari|SEED, | |eecs4484-alomari|SEED, | ||
+ | |||
+ | **NOTE: Due to Microsoft restrictions, | ||
services/eecsvm.1748548168.txt.gz · Last modified: by jas