Virtual Machine Action Bar
VM Action Bar Overview
Once a virtual machine is launched, there are a variety of actions that can be done that are seen in an action bar as well as the usage statistics and the virtual machine management.
| Action | Notes |
|---|---|
| ShutDown | A user can completely shut down their virtual machine |
| Disconnect | Frontend stops talking to your virtual machine. It is still running |
| Transfer | A user can transfer files from their vault into their VM. |
| Open application | A user can view and use the VM on their local machine |
| Open Terminal | A user can open the virtual machine terminal. |
| Launch SFTP | A user can utilize SFTP to transfer files directly from their local computer to the virtual machine. |
Shut Down
To shut down a VM navigate to tab, in the Virtual Machines section.
Select the connected VM you want to shut down.
Click the
Three dotsicon on the right of the VM.Click the
Shut Downbutton.In the prompt, click on the bottom right.
Side note: In case of emergency, you can check the box "I accept the risk" and click .
A tiCrypt user may want to disconnect from a virtual machine if they still have things running or downloading onto it. If they are completely done with the virtual machine, it may be better for them to shut it down.
In the case a virtual machine refuses to shut down, the user has the option to force shutdown. Though, force shutdown should be used as a last resort.
Forcing a shutdown may result in the VM non-persistent data being lost and may damage the filesystems on mounted drives, making them unmountable.
Shutting down a virtual machine will cause all non-persistent data to be lost. Shutdown takes a little while, but usually no longer than a minute.
Disconnect
To disconnect a VM navigate to tab, in the Virtual Machines section.
Select the connected VM you want to disconnect.
Click the
Disconnect VMbutton from the right of the VM name.
The feature allows the VM to run its workload in the background even when the connection to the frontend is broken.
There is a fundamental difference between shutting down a virtual machine and disconnecting a virtual machine.
Example: When a person unplugs their computer from the power source, they are shutting it down. When a person steps away from their computer, they are disconnecting from it.
Transfer
A user can transfer files from their vault into the VM. A user can do so by selecting the transfer button. A modal will appear on the left and right side. The user can then drag files in their vault into the VM. What is seen on the right side in the home drive of the virutal machine. The act of transferring makes a copy, meaning that the original will remain in the vault.
To transfer files between VM and Vault navigate to tab, in the Virtual Machines section.
Select the connected VM you want to transfer to/from.
Click the
Transfer files to/from Vaultbutton in the center right.In the window, drag-and-drop files and directories from the VM(right side) to the Vault (left side) and vice-versa.
Once you finished, click the
Exitbutton in the top left.
Side note: To change the display layout during transfers click Change layout button in the top right.
The VM where you move the files to/from must be Connected.
If the file is tagged by a project that is not less than or equal to that of the VM, then the file will not be able to be transferred from the vault into the VM.
If a file is tagged by a lesser project than that of the virtual machine, it can be moved into the virtual machine. As a result, the file's project will now tag the virtual machine.
For more information about this, please reference to the tree diagram in the project section.
View Drive Letters
Users can view drive slots letters in the file tree when transferring files between the Vault and the VM.
Create a Symbolic Link
Symbolic links allow a file or a directory to be accessible from another location.
To create a Symbolic Link navigate to tab, in the Virtual Machines section.
Select the connected VM you want to create the symbolic link for.
Click the
Transfer files to/from Vaultbutton in the center right.In the window, select the drop-downs under
DrivesorAccess Directorieson top right center.Select the directory where you want to create the symbolic link.
Click
Create symlinkbutton in the top right corner.Type the symbolic link name.
Select a directory for your symbolic link.
Click .
You may as well right-click the file/directory and select Create symlink option.
Change File / Directory Permissions
To change file/directory permissions navigate to tab, in the Virtual Machines section.
Select the connected VM you want to change file/directory permissions for.
Click the
Transfer files to/from Vaultbutton in the center right.In the window, select the drop-downs under
DrivesorAccess Directorieson top right center.Select the file/directory where you want to change permissions.
Click
Change permissionsbutton in the top right corner.In the prompt, type the name of the owner to who permissions will be applied.
Type the group where the permission applies.
Everybodyto everyone who is a member of the VM.Managersto the managers of the VM only.Nobodyto the owner of the VM only.
Select the appropriate permissions from the list.
Select whether or not the children files and subdirectories will inherit the same permissions.
Click .
You may as well right-click the file/directory and select Change permissions option.
You can select Custom permissions and add your own unix-based permissions.
You can check on the status of the permissions by going to the terminal, going into the directory and running ls -l.
Open Application
To open the virtual machine application navigate to tab, in the Virtual Machines section.
Select the connected VM you want to open.
Click the
Open remote applicationbutton in the center right.In the prompt, follow the
Accesssteps and copy-paste theCredentialsfrom the top to login into your VM.Download the RDP file to your local machine.
Open the RDP file and enter your username and password from the prompt.
Click .
Side note: The home screen for the VM will appear. This may take a minute.
Mac users must download Microsoft desktop in order to open the RDP file.
To exit from the VM remote application, click Menu button in the top left then click Disconnect
Open Terminal
A user may wish to interact with their VM via commandline. A user can do this by selecting the terminal button. This terminal has absolutely nothing to do with the local machine.
To open the virtual machine terminal navigate to tab, in the Virtual Machines section.
Select the connected VM you want to open the terminal of.
Click the
Open terminalbutton in the center right.In the prompt, follow the
Accesssteps and copy-paste theCredentialsfrom the top to login into your VM.
While in the terminal, you can access Transfer files to/from Vault option or Hide terminal from the top left.
Hiding the terminal window does not terminate it.
Launch SFTP
SFTP transfers allow you to transfer files directly from your local machine into the VM.
To launch an SFTP transfer navigate to tab, in the Virtual Machines section.
Select the connected VM where you want to launch the SFTP transfer.
Click the
Launch SFTPbutton in the center right.In the prompt, copy-paste the
User name, Password, Host, PortandCommanddetails to your SFTP provider.Once you finished the transfer, click .
Mac users must download an SFTP client in order to utilize this feature.
Use the SFTP transfer when the files are too large and there is no use for them in the vault.
To see more about SFTP check out How to create an SFTP endpoint section.