Drive Details and Configuration
Drive details are the read-only view of a drive's specification: its size and format, the users and virtual machines it is shared with, its identifier, and its cache and IO strategy. This page is for inspecting and exporting that record rather than changing it.
Why you would need a drive's details
The drive ID is how drives are referenced outside the interface. Support requests, audit queries, and API calls identify a drive by its ID rather than its name, because names are not unique and, for NTFS drives, cannot be changed after creation.
The shared-users list is the authoritative answer to "who can read this". Because access to a drive is a key grant rather than a server-enforced permission, this list is the record of who holds a key. Review it before adding data to a drive that already exists, not after.
Cache and IO strategy affect throughput, not safety. These settings change how the host buffers reads and writes for the drive. They are a performance decision; the encryption is unaffected either way.
Before you begin
- You have the View drives permission, and View drive keys to see the shared-user list.
Access Drive Details
- Go to the Virtual Machines icon in the top left taskbar.
- Click the Drives section on the top left panel.
- Select the drive to view its details.
- Click the View button in the top panel.
- In the new window, view the drive name, format, project tag, and team at the top.
View Drive Specifications
- Go to the Virtual Machines icon in the top left taskbar.
- Click the Drives section on the top left panel.
- Select the drive to view its specifications.
- Click the View button in the top panel.
- In the new window, under Specification, view the drive format, mounting options, capacity, and attachment.
The drive format may be any of ext4, ntfs, btrfs, xfs, or zfs.
View Drive Basic Information
- Go to the Virtual Machines icon in the top left taskbar.
- Click the Drives section on the top left panel.
- Select the drive to view its basic information.
- Click the View button in the top panel.
- In the new window, scroll down to the Basic Info section.
- View the drive owner, backup, creation date & time, and ID for debugging purposes.
View Drive Shared Users and VMs
- Go to the Virtual Machines icon in the top left taskbar.
- Click the Drives section on the top left panel.
- Select the drive to view its shared users and VMs.
- Click the View button in the top panel.
- In the new window, scroll down to the Shared with users section.
- View all users the drive is shared with.
- Under Attached to VMs, view all VMs the drive is attached to.
Copy Drive ID
- Go to the Virtual Machines icon in the top left taskbar.
- Click the Drives section on the top left panel.
- Select the drive to view its ID.
- Click the View button in the top panel.
- In the new window, scroll down to the Basic Info section.
- Click the Copy button next to ID.
- Paste the drive ID where necessary.
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
- Go to the Virtual Machines icon in the top left taskbar.
- Click the Drives section on the top left panel.
- Select the drive(s) to view for JSON export.
- Click the Export JSON button in the top right corner.
- Select View selected items.
- In the new prompt, click the Expand all fields button in the top left panel.
- 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.
- Once done, click Close.
Download or Copy Drives Data in JSON
bulk-action
- Go to the Virtual Machines icon in the top left taskbar.
- Click the Drives section on the top left panel.
- Select the drive(s) to view for JSON export.
- Click the Export JSON button in the top right corner.
- Select View selected items.
- In the new prompt, click the Expand all fields button in the top left panel.
- 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.
- Click Copy to copy drive data to the clipboard or click Download to download drive data locally.
- Once done, click Close.
Export Drive Data in JSON Format
bulk-action
- Go to the Virtual Machines icon in the top left taskbar.
- Click the Drives section on the top left panel.
- Select the drive(s) to export in JSON format.
- Click the Export JSON button in the top panel.
- Select Export selected items.
- In the new prompt, choose the local export destination.
- Click Save.
Export Drive Data in CSV Format
bulk-action
- Go to the Virtual Machines icon in the top left taskbar.
- Click the Drives section on the top left panel.
- Select the drive(s) to export in CSV format.
- Click the Export CSV button in the top panel.
- Select Export selected items.
- In the new prompt, choose the local export destination.
- Click Save.
Prepare the Drive to Store Applications and Databases
- Go to the Virtual Machines icon in the top left taskbar.
- Click the Drives section on the top left panel.
- Select the drive to store applications and databases.
- Click the Edit drive button in the top panel list.
- In the prompt, click the Advanced Options button.
- Change the permission management setting from Disable to Enable.
- Click Update.
Enabling this option disables tiCrypt's permission management for this drive; the application using it becomes responsible for permissions instead. No access directories can be created, and the data will not be available to regular users. This is useful for applications such as databases that store large amounts of data.
Change the Cache Strategy of a Drive
- Go to the Virtual Machines icon in the top left taskbar.
- Click the Drives section on the top left panel.
- Select the drive for which you want to change the cache strategy.
- Click the Edit drive button in the top panel list.
- In the prompt, click the Advanced Options button.
- Change the cache strategy from default to none, writethrough, writeback, or directsync.
- Click Update.
Change the IO Strategy of a Drive
- Go to the Virtual Machines icon in the top left taskbar.
- Click the Drives section on the top left panel.
- Select the drive for which you want to change the IO strategy.
- Click the Edit drive button in the top panel list.
- In the prompt, click the Advanced Options button.
- Change the IO strategy from default to threads or native.
- Click Update.
Use dedicated threads when handling many concurrent IO operations. Use native for high-performance databases or large-scale storage systems.
Change Drive Capacity & Type
Drive capacity and format are fixed after creation. To increase capacity, create a new drive and migrate data.