Skip to main content
Version: 3.25

Setting up remote partitions

The orbit partition command allows you to list, add, or remove remote partitions that are used to forward the backup database, session files, and encrypted information with the master key.

mt4adm@vmdf-giskard:~$ sudo orbit partition --help
Usage: orbit partition

File system partitions management tools

Flags:
--help Show context-sensitive help.

-l, --local="/srv/backup_remoto" Local path to mount point
-h, --remote-host=STRING Remote host address
-r, --remote-path=STRING Remote path to mount
--type="cifs" The filesystem type: [nfs|cifs]
-o, --options=STRING Adcional options to mount
-u, --user=STRING Samba credentials username
-p, --password=STRING Samba credentials password
-d, --domain=STRING Samba credentials domain
--remount Remount the local partition
--umount Unmount the partition configuration
--delete Unmount and delete the partition configuration
--force Force the command execution, never prompt
--show

Adding a remote CIFS partition

You should be familiar with the CIFS protocol and mounting options available for Linux environment. In the case of security passwords we use the Debian2 package cifs-utils. This package is maintained by SAMBA3 developers. More details on the mounting options can be found in your official manual4.

caution

When using the CIFS protocol, the orbit command will create an authentication file located at /root/.smbcred that contains the authentication data for the assembly. Use this file in the options argument.

The argument –remote-path should start with the bar and contain only the target directory.

mt4adm@vmdf-giskard:~$ sudo orbit partition  
--local="/srv/backup_remoto"
--remote-host="192.168.214.37"
--remote-path="/backup"
--type="cifs"
--user="senhasegura"
--password="@qwemaster88"
--domain="sandbox.local"
--options="credentials=/root/.smbcred,uid=1001,gid=1001,file_mode=0750,dir_mode=0750,noexec"

Are you sure you want to proceed: y
Done!
No errors reported

Reattach a registered remote partition

To reattach a partition, if the target server has been inaccessible for a while generating an error on the remote partition, use the command orbit partition –remount.

mt4adm@vmdf-giskard:~$ sudo orbit partition --remount
Are you sure you want to proceed: y█
Partition remounted with success
- domain=sandbox.local
mount.cifs kernel mount options: ip=192.168.214.37,
unc=\\192.168.214.37\backup,file_mode=0750,dir_mode=0750,
uid=1001,gid=1001,user=senhasegura,domain=sandbox.local,pass=********

Detach a registered remote partition

To detach the remote partition, use the command orbit partition –umount. This command will unmount the partition but will keep it on the /etc/fstab file.

mt4adm@vmdf-giskard:~$ sudo orbit partition --unmount
Are you sure you want to proceed: y
Done!
No errors reported

Detach and remove a registered remote partition

To detach the remote partition, use the command orbit partition –delete. This command will unmount the partition and remove it from the /etc/fstab file.

mt4adm@vmdf-giskard:~$ sudo orbit partition --delete
Are you sure you want to proceed: y
Done!
No errors reported