Attaching, Mounting and Expanding Recording Volumes

June 26, 2023 15:33

i	Before making any changes to your recording volume, it's a good idea to backup your volume. If you need any help with these instructions, please contact Teramind Support at support@teramind.co. Or, click the Chat option from your Teramind Dashboard or Teramind website.

Attaching a Recording Volume

To attach a recording volume to your Teramind appliance, follow the steps below:

Create and attach a disk with your Hypervisor tools
Stop the Teramind service, execute:
```
systemctl stop teramind
```
Run the ‘lsblk’ command to check if the OS is able to recognize the new disk:
```
lsblk
```
Create a new partition with the following command:
```
fdisk /dev/sdb
```
Press n to create a new partition, then p to specify it’s a primary one. Leave the rest of the options (First and Last sector) as is: Press p again to print/view the new partition table: Press w to write changes to the disk
Create a file system on the new partition using the following command:
```
mkfs.ext4 /dev/sdb1
```
Verify the new partition is visible by executing the following command:
```
lsblk
```
Find the new partition’s ID by executing the 'blkid' command:
```
blkid /dev/sdb1
```
Copy the UUID:
Edit /etc/fstab, put the UUID from Step 7 above to a mounted record:
This step is optional. If you don't have any existing recordings in your rec directory, please go to Step 10. Otherwise, do the following to keep the recordings intact (so that you can later resync them in Step 13).
Rename your current recordings directory to something else (e.g., rec_old):
```
cd /usr/local/teramind
mv rec rec_old
```
Create a new directory where future screen recordings will be stored (you can use your old directory name 'rec' since you renamed it already):
```
mkdir rec
```
Execute the following command to mount the disk:
```
mount -o remount -a
```
Ensure the disk is mounted with lsblk and df:
Fix the recording volume permissions to allow the Teramind service to record files with the following commands:
```
chown -R prod. /usr/local/teramind/rec
chmod -R 775 /usr/local/teramind/rec
```
Start the Teramind service and start recording the screen data to the new disk with the following command:
```
systemctl start teramind 
```
If you created a backup of your previously captured screen recordings (in Step 9), you can now transfer the backup data to the newly mounted disk with the following command:
```
rsync -a /usr/local/teramind/rec_old/ /usr/local/teramind/rec
```
This might take some significant amount of time depending on how many records currently exist in your rec_old directory. Once rsync is finished, you can safely delete your rec_old directory with the following command:
```
rm -rf /usr/local/teramind/rec_old
```
Open your admin dashboard and verify if the disk is being displayed properly

Mounting a Recording Volume to a NAS

To mount a recording volume to a NAS (Network Attached Storage), follow the steps below:

Add access to files on the NAS within the local network (NFS). Here's an example of how to do that on a Synology NAS:

How to access files on Synology NAS within the local network (NFS)

i	The information provided on the link above is from a third party. The link is provided for your convenience. Teramind cannot verify the accuracy of the information nor is responsible for any damage that may occur from using the instructions.

You can find similar instructions for other NAS disks online. If not, please contact your NAS provider's technical support.

Stop the Teramind service using the following command:
```
sudo systemctl stop teramind
```
Transfer your existing recording to NAS with rsync. For example:
```
rsync -av /usr/local/teramind/rec/ 192.168.1.88:mnt/Teramind/
```

Insert the values into the kv_store row. For example:

insert into kv_store(key,value) values ('nfs.rec_dir','ipaddress:/volumes2/Teramind');

Restart the service using the following command:
```
sudo systemctl restart teramind
```

Expanding a Recording Volume

To expand a recording volume, follow the steps below:

Ensure the OS is able to recognize a resized disk. You might need to reboot it. Use the lsblk command to check:

If it isn’t recognized, force rescan of the disk devices using one of the following commands:
```
echo 1>/sys/class/block/sdX/device/rescan
```
OR
```
echo 1>/sys/class/scsi_device/X:X:X:X/device/block/device/rescan
```
Execute the fdisk command below to see a partition table:
```
fdisk -l /dev/sdX
```
Here, sdX stands for your volume. For example:
Execute the fdisk command below to edit the partition:
```
fdisk /dev/sdX
```
Here, sdX stands for your volume. For example:
Type d at the Command prompt to delete the primary partition:
Type n at the Command prompt to create a new partition:
Type p for a primary partition and just press Enter at the partition number, first sector and last sector prompts to keep the default values. IMPORTANT: answer No to the "Do you want to remove the signature?" prompt:
Type p to print/view the partition table and ensure the partition has been resized successfully:
Make the root partition bootable by typing a at the Command prompt:
Type p to print/view the partition table and ensure everything looks good:
Type w to write a modified table:
Update the OS kernel’s table to recognize new disk size by executing the following commands:
```
partx --update /dev/sdX
partx --update /dev/sdX1
```
Here, sdX stands for your volume. For example:
Execute the lsblk command to ensure the OS can recognize the new partition size. If it hasn’t, reboot the OS:
If everything looks good, execute the resize2fs command to expand the file system. For example:
```
resize2fs /dev/sdX1
```
Here, sdX stands for your volume. For example:
Execute the following command to see if the changes have been applied successfully:
```
df -h
```

Expanding a Recording Volume Greater Than 2TB (Secondary Volumes Only)

i	This method will work on secondary volumes only. Please do not attempt this on a primary volume or a root partition.

To attach a recording volume to your Teramind appliance, follow the steps below:

First, you need to access your instance via SSH or directly from your VM's management console (contact support@teramind.co for your login password if you don't already have it):
Use the sudo and fdisk commands on the volume you have to increase to more than 2 terabytes.
```
sudo fdisk /dev/sdX
```
Here, sdX stands for your volume. For example:
You might see a warning message about DOS partition size limit. You can ignore it:
Type p to show the partition table:
Type g to create a new empty GPT partition table:
Type n to add that partition (leave all entries to their default values):
Type p to check that the partition table had been modified:
Type w to save changes to the table:
Run the following command:
```
sudo partprobe
```
Run the following command to resize the volume:
```
sudo resize2fs /dev/sdX1
```
Here, sdX stands for your volume. For example:
```
sudo resize2fs /dev/sdb1
```
In some cases, you may need to reboot for the changes to take effect.