Skip to main content
Version: 3.24

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
  1. https://www.debian.org/↩
  2. https://www.samba.org/↩
  3. https://wiki.samba.org/index.php/LinuxCIFS_utils↩