Skip to main content

Drives Table

Prerequisites

Access Level:User, Sub-admin, Admin
Permission Requirements
  • . Basic Project Interaction
    • View projects they are a member of
    • View other members in projects they are a member of
    • Classify resources with projects they are active in
  • . Project Management
    • Declassify resources tagged with projects they manage
  • . Basic VM Interaction
    • View drives (inconsistent, see notes)
    • Create drives
    • Edit drives (name and whether to disable backup)
    • View drive keys (necessary to share/attach)
    • Share drives
    • Unshare drives
    • Attach drives to VMs
    • Detach drives from VMs
    • Delete drives they own

View Existing Drives​

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. View all listed drives you have access to.

Access Drives from the Virtual Machines UI​

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Virtual Machines section on the top left panel.
  3. In the left panel, select the virtual machine to access its drive(s).
  4. Scroll down and click the File Explorer option in the center.
  5. In the new window, on the right panel select your Drive(s) (1, 2, ...).
  6. View the contents of your drive(s).

Manage Drives from the Virtual Machines UI​

bulk-action

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Virtual Machines section on the top left panel.
  3. In the left panel, select the virtual machine to manage its drive(s).
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, select the Drives section in the left panel.
  6. Manage your drive(s) from the list.

Create a New Drive​

Method one:​

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. Click the Create new drive in the top right corner.
  4. In the prompt, enter the drive name, capacity, and format.
  5. Add an optional owner, team, optional project, and realm.
  6. Click Create.

Method two:​

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Virtual Machines section on the top left panel.
  3. In the left panel, select the virtual machine to create a new drive in.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, select the Drives section in the left panel.
  6. Click Attach drive(s) icon in the top panel.
  7. In the prompt, select Create a new drive.
  8. In the prompt, enter the drive name, capacity, and format.
  9. Add an optional owner, team, optional project, and realm.
  10. Click Create.
note
  • Your drive capacity depends on your allocated team resources.
  • Click the Advanced options button to set up permission management status, Cache & IO strategy for the drive.

Attach an Existing Drive to an Existing VM​

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Virtual Machines section on the top left panel.
  3. In the left panel, select the virtual machine to attach the drives to.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, select the Drives section in the left panel.
  6. Click Attach drive(s) icon in the top panel.
  7. In the prompt, select Attach drive(s).
  8. Next, select the partition order for the drive, the drive name to attach and the type.
  9. Click Attach and mount.
info
  • A read-write drive can only be attached to a single VM. A read-only drive can be attached to multiple VMs.
  • To automatically share the newly created or attched drive with the VM co-owners, tick Add drive(s) to the VM configuration and share drive(s) with co-owners box.

Detach a Drive from an Existing VM​

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Virtual Machines section on the top left panel.
  3. In the left panel, select the virtual machine to detach the drive from.
  4. Click the VM Settings and Details option in the bottom center.
  5. In the new window, select the Drives section in the left panel.
  6. From the list, select the drive you want to detach.
  7. Click the Open Full Menu button by the selected drive in the left panel list.
  8. Select Detach drive(s).
  9. In the prompt, click Yes to proceed.
danger

Detaching a drive will revoke user access and stop applications from the drive.

Add or Change a Project in a Drive​

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. Select the drive to add or change the project.
  4. Click the Open Full Menu button in the top right corner.
  5. Select Change project.
  6. In the pop-up, select a project to tag the drive.
  7. Click Classify.
tip

Check your changes in the drive. The project will display the project tag name by the drive in the list or in the drive details under drive owner name.

Forcefully Add or Change a Project in a Drive​

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. Click the Open Full Menu button in the top right corner.
  4. Select Change project.
  5. In the pop-up, tick Use my permission to override rules, re-tag resources with any visible project, regardless of current project relations.
  6. Select any project to tag the drive.
  7. Click Force change with admin privilege.
note

Forcefully tagging a drive with a project is only available to users with admin or super-admin roles in the system.

Remove a Project from a Drive​

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. Click the Open Full Menu button in the top right corner.
  4. Select Change project.
  5. In the pop-up, select No project (unlocked) to remove the project tag from drive.
  6. Click Declassify.
note

If you are a super-admin and do not belong to the project, you can use the Force change with admin privilege option to forcibly remove a project tag.

Share a Drive with Other Users​

bulk-action

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. Select the drive to share.
  4. Click the Open Full Menu button by the selected drive in the left panel list.
  5. Select Share.
  6. In the prompt, click the Share with a user button in the top right corner.
  7. In the pop-up, enter and select the user names to share the drive with.
  8. Click Share.
  9. Once done, click Close.

Give Full-Access (Read-Write) of a Drive to a User​

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. Select the drive to give full-access to.
  4. Click the Share button in the top panel.
  5. In the prompt, select Full-access next to the shared user(s) in the right column.
  6. Once done, click Close.

Give Read-Only Access of a Drive to a User​

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. Select the drive to give read-only access to.
  4. Click the Share button in the top panel.
  5. In the prompt, select Read-Only next to the shared user(s) in the right column.
  6. Once done, click Close.

Edit Drive Details​

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. Select the drive to edit.
  4. Click the Edit drive button in the top panel list.
  5. In the prompt, edit the drive name, relation to team,project, or realm, backup settings and other advanced metadata.
  6. Click Update.

Migrate a Drive to a Different Storage Pool​

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. Select the drive to migrate.
  4. Click the Migrate drive button in the top panel list.
  5. In the prompt, select the destination pool.
  6. Click Migrate.

Bulk Email All Drive Users​

bulk-action

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. Select the drive to bulk email users.
  4. Click the Open Full Menu button by the selected drive in the left panel list.
  5. Select Bulk email.
  6. In the prompt, click Download to download all drive user emails to your local machine.
  7. Click Copy to copy all drive user emails to your clipoard.
  8. Once done, click Close.

Transfer Ownership of the Drive to a Different User​

bulk-action

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. Select the drive to transfer ownership.
  4. Click the Open Full Menu button by the selected drive in the left panel list.
  5. Select Transfer ownership.
  6. In the prompt, enter the new drive owner name.
  7. Click Transfer.
info

To transfer drive ownership, you must first grant Full-access to the drive to the user(s) you want to transfer ownership to.

Unshare the Drive with a User​

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top right panel.
  3. Select the drive to unshare with a user.
  4. Click the Share button in the top panel.
  5. In the prompt, filter the users by name or email.
  6. Click the Delete button by the user you want to remove from sharing the drive with.
  7. Once done, click Close.

Unshare the Drive with All Users​

bulk-action

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. Select the drive to unshare from everyone else.
  4. Click the Open Full Menu button by the selected drive in the left panel list.
  5. Select Unshare Drive from everyone else.

Delete the Drive​

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. Select the drive to delete.
  4. Click the Open Full Menu button by the selected drive in the left panel list.
  5. Select Delete.
  6. In the prompt, tick the drive(s) without errors to delete.
  7. Type "Confirm" to confirm deletion.
  8. Click Delete.
danger

You cannot delete drives actively attached to VMs. Shutdown the VM first, then delete the drive.

Access Drive Details​

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. Select the drive to view its details.
  4. Click the View button in the top panel.
  5. In the new window, view drive name, format, project tag and team at the top.

View Drive Specifications​

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. Select the drive to view its specifications.
  4. Click the View button in the top panel.
  5. In the new window, under Specification view the drive format, mounting options, capacity and attachment.
info

The drive format may be any of ext4, ntfs,btrfs,xfs or zfs.

View Drive Basic Information​

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. Select the drive to view its basic information.
  4. Click the View button in the top panel.
  5. In the new window, scroll down to Basic Info section.
  6. View the drive owner, backup, creation date & time and ID for debug purposes.

View Drive Shared Users and VMs​

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. Select the drive to view its shared users and VMs.
  4. Click the View button in the top panel.
  5. In the new window, scroll down to Shared with users section.
  6. View all users the drive is shared with.
  7. Under Attached to VMs, view all VMs the drive is attached to.

Copy Drive ID​

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. Select the drive to view ID.
  4. Click the View button in the top panel.
  5. In the new window, scroll down to Basic Info section.
  6. Click the Copy button next to ID.
  7. Paste the drive ID where necessary.
info

The drive ID is a string of numbers and letters such as 590c350a-7c5e-478e-88cf-6f35fd3b56bc.

View Drives Data for JSON Export​

bulk-action

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. Select the drive(s) to view for JSON export.
  4. Click the Export JSON button in the top right corner.
  5. Select View selected items.
  6. In the new prompt, click Expand all fields button in the top left panel.
  7. View all JSON export data by ID, name, owner ID, owner, access, state, project-name-enhanced, team ID, team, size, format, backup, type, and raw.
  8. Once done, click Close.

Download or Copy Drives Data in JSON​

bulk-action

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. Select the drive(s) to view for JSON export.
  4. Click the Export JSON button in the top right corner.
  5. Select View selected items.
  6. In the new prompt, click Expand all fields button in the top left panel.
  7. View all JSON export data by ID, name, owner ID, owner, access, state, project-name-enhanced, team ID, team, size, format, backup, type, and raw.
  8. Click Copy to copy drive data to clipboard or click Download to download drive data locally.
  9. Once done, click Close.

Export Drive Data in JSON Format​

bulk-action

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. Select the drive(s) to export in JSON format.
  4. Click the Export JSON button in the top panel.
  5. Next, select Export selected items.
  6. In the new prompt, choose the export destination locally.
  7. Click Save.

Export Drive Data in CSV Format​

bulk-action

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. Select the drive(s) to export in CSV format.
  4. Click the Export CSV button in the top panel.
  5. Select Export selected items.
  6. In the new prompt, choose the export destination locally.
  7. Click Save.

Prepare the Drive to Store Applications and Databases​

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. Select the drive to store applications and databases.
  4. Click the Edit drive button in the top panel list.
  5. In the prompt, click the Advanced Options button.
  6. Change the permission management setting from Disable to Enable.
  7. Click Update.
caution

Enabling permission management on a drive stops tiCrypt from managing drive permissions. No access directories can be created, and the data will not be available to regular users. This is useful for applications like databases that store large data.

Change the Cache Strategy of a Drive​

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. Select the drive for which you want to change the cache strategy.
  4. Click the Edit drive button in the top panel list.
  5. In the prompt, click the Advanced Options button.
  6. Change the cache strategy from default to none, writethrough, writeback, or directsync.
  7. Click Update.

Change the IO Strategy of a Drive​

  1. Go to the Virtual Machines icon in the top left taskbar.
  2. Click the Drives section on the top left panel.
  3. Select the drive for which you want to change the IO strategy.
  4. Click the Edit drive button in the top panel list.
  5. In the prompt, click the Advanced Options button.
  6. Change the IO strategy from default to threads or native.
  7. Click Update.
tip

Use dedicated threads when handling many concurrent IO operations. Use native when dealing with high-performance databases or large-scale storage systems.

Change Drive Capacity​

You cannot change the capacity of a drive. You must create a new drive from scratch.

info

Transfer the drive to a new migration pool or move all data to a larger drive.