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, thenp
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
Create a new directory where future screen recordings will be stored (you can use your old directory name 'rec' since you renamed it already):
mv rec rec_oldmkdir rec
- Execute the following command to mount the disk:
mount -o remount -a
Ensure the disk is mounted withlsblk
anddf
: - 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 yourrec_old
directory. Oncersync
is finished, you can safely delete yourrec_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)
iThe 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
ORecho 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: answerNo
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/sdX1Here,
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
andfdisk
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.