Install and Manage the Agent on Linux Servers
The Backup agent is now available with different installer packages, providing support on multiple Linux distributions. The following table lists the installer packages and Linux distributions on which the installer package is supported.
| Installer package | Linux distribution |
|---|---|
| (Default) RPM | RHEL and its derivative |
| SUSE RPM | SUSE |
| Script Installer | All supported Linux operating systems |
For IBM Cloud Support information, see Physical Servers.
Linux agent has dependencies on the following packages, which must be installed on the Linux server:
| Command/Package | Linux distribution | ||||
|---|---|---|---|---|---|
| RHEL | SUSE | CentOS | Ubuntu | Debian | |
|
|
|
|
|
|
|
| rsync | rsync | rsync | rsync | rsync | rsync |
| mount | mount | mount | mount | mount | mount |
| lsof | lsof | lsof | lsof | lsof | lsof |
| umount | umount | umount | umount | umount | umount |
| cp | cp | cp | cp | cp | cp |
| chown | chown | chown | chown | chown | chown |
| chmod | chmod | chmod | chmod | chmod | chmod |
| mkdir | mkdir | mkdir | mkdir | mkdir | mkdir |
| rm | rm | rm | rm | rm | rm |
| tee | tee | tee | tee | tee | tee |
| hostname | hostname | hostname | hostname | hostname | hostname |
| stat | stat | stat | stat | stat | stat |
| blkid | blkid | blkid | blkid | blkid | blkid |
| ls | ls | ls | ls | ls | ls |
| losetup | losetup | losetup | losetup | losetup | losetup |
| dmsetup | dmsetup | dmsetup | dmsetup | dmsetup | dmsetup |
| timeout | timeout | timeout | timeout | timeout | timeout |
| lvs | lvs | lvs | lvs | lvs | lvs |
| vgs | vgs | vgs | vgs | vgs | vgs |
| lvcreate | lvcreate | lvcreate | lvcreate | lvcreate | lvcreate |
| lvremove | lvremove | lvremove | lvremove | lvremove | lvremove |
| lvchange | lvchange | lvchange | lvchange | lvchange | lvchange |
| libpcap-progs | null | libpcap-progs | null | null | null |
| nfs-utils Required for Instant Volume Mount, file-folder recovery from block-based backup and VMware backup. |
nfs-utils | nfs-utils | nfs-utils | nfs-utils | nfs-utils |
| wget | wget | wget | wget | wget | wget |
Installing the Linux agent as an LDAP user is supported.
Download and Install the Linux Agent
Installing the agent on a server allows actions such as registering the agent as a source with the IBM Cloud Backup and Recovery or performing file-level recovery.
Install the Agent
-
Navigate to Data Protection > Sources.
-
Click Download Backup agent.
The Download Agents window appears.
-
Follow the installation instructions for the corresponding installer package.
-
Configure the firewall and ports as necessary. For more information, see Manage Firewall Ports.
Install RPM, Debian or SUSE RPM Installer Package
The following table explains the action to be performed for installing the RPM, Debian or SUSE installer package:
In the following commands, replace the Backup agent version with the desired agent version.
| Action | How to |
|---|---|
| Download the Agent installer | From the Download Agents window, based on your Linux distribution, select RPM, Debian, or SUSE RPM and download it to the server you want to protect. |
| Navigate to the downloaded directory | As the root user with local system privileges on that server, change the directory to the location of the installer package. |
| Install the Custom certificates | LINUX If you are using a IBM Cloud Backup and Recovery certificate then run the following commands to install the user certificate followed by agent installation: export ENFORCE_USE_CUSTOM_CERTS=true && export AGENT_CERT_FILE= If you are using a user certificate then run the following commands to install the user certificate followed by agent installation: export ENFORCE_USE_CUSTOM_CERTS=true && export USE_THIRD_PARTY_CERTS=true && export ROOT_CA_FILE= |
| Install the Agent | Run the following command depending on the installer package: * RPM: rpm -i el-cohesity-agent--1.x86_64.rpm or yum localinstall ./el-cohesityagent-7.2-1.x86_64.rpm* Debian: dpkg -i cohesity-agent_-1_amd64.deb* SUSE RPM: rpm -i cohesity-agent--1.x86_64.rpm |
| Install the agent as root user | Run the executable file with the following command syntax: /<path_to_installer_file> -- --install -c 0 -S root -G root Followings are the command options in details: 1. -S this is the user to run the agent, specify root. 2. -G this is the group permission the Agent will use for files and directories installed by the agent, specify root. 3. -c this boolean switch controls if the OS user and group should be created. 0 means do not create the OS user and group, 1 means the agent installation will create the specified OS user and group. (When choose to run with the root user, specify ‘-c 0’ as ‘root’ already exists) |
| Install the agent as non-root user | To start the service as a non-root user, create a new user or use an existing user with sudo permission and run the following command: * RPM: export COHESITYUSER=<username> ; rpm -i el-cohesity-agent--1.x86_64* Debian: COHESITYUSER=<username> dpkg -i cohesity-agent_-1_amd64* SUSE RPM: export COHESITYUSER=<username> rpm -i cohesity-agent--1.x86_64 Where, <username> is the user name with sudo permission.By default, the installation uses the root user permission for all the files, and the service is started as root. Therefore, it is required to add non-root users to the sudoers list by making the following changes in the /etc/sudoers file:<user_name> ALL=(ALL) NOPASSWD:ALLDefaults:<user_name> !requirettyAn example of the sudoers file is as given below: dgoble ALL=(ALL) NOPASSWD:ALL Defaults:dgoble !requiretty cohbackup ALL=(ALL) NOPASSWD:ALL Defaults:cohbackup !requiretty You can add sudo privileges for non-root users using the syntax given below: <user_name> ALL=(ALL) NOPASSWD:/path/to/command1, /path/to/command2, /path/to/command3Remove NOPASSWD from the command above if you do not want to authenticate
every sudo commands with password.The example below shows the sudo commands for user cohesityagent: cohesityagent ALL=NOPASSWD: /bin/mount,/bin/umount,/bin/chmod,/bin/chown,/bin/hostname,/bin/mkdir,/bin/rm,/usr/bin/tee,/usr/bin/stat,/bin/cp,/bin/sed,/usr/bin/touch,/sbin/blkid,/usr/bin/lsof,/bin/ls,/sbin/losetup,/sbin/dmsetup,/usr/bin/rsync,/usr/bin/timeout,/usr/bin/getfacl,/usr/bin/setfacl,/tmp/installer_ch_cohesity_linux_agent,/home/cohesityagent/installer,/home/cohesityagent/cohesityagent/data/agent/tmp/installer_ch_cohesity_linux_agent,/bin/systemctl,/home/cohesityagent/cohesityagent/software/crux/bin/cohesity_linux_agent.shThe actual paths for each command may vary in each system. IBM Cloud Backup and Recovery keeps adding or removing commands across releases. |
| Location | * Installation directory: /opt/cohesity* Log file: /var/log/cohesity |
Install script installer package
The following table explains the action to be performed for installing the script installer package:
In the following commands, replace the Backup agent version with the desired agent version.
| Action | How to |
|---|---|
| Download the Agent installer | From the Download Agents window, based on your Linux distribution, select Script Installer and download it to the server you want to protect. |
| Navigate to the downloaded directory | As the root user with local system privileges on that server, change the directory to the location of the installer package. For SLES 11 SP4, installing the agent as the root user is required. |
| Make the installer executable | Make the installer executable, for example: chmod +x cohesity_agent__linux_x64_installer |
| Install the Agent | Run the executable: sudo /cohesity_agent_6.6.0d_u2_linux_x64_installer – --install |
| Location | * Installation directory:/home/<username>/cohesityagent or /root/cohesityagent* Log file: /home/cohesityagent/cohesityagent/logsYou can specify the option -log-dir <installtion_path> to specify the directory path where the agent logs will be saved. If this option is not provided, the logs will be saved in the default path |
Agent startup behavior following a machine reboot:
- CentOS and RedHat (distributions with the "systemd" init system) - The agent starts automatically.
- Ubuntu (distributions with the "upstart" init system) - The agent starts automatically.
If a Linux server's /etc/sudoers file is managed by a deployment engine such as Chef, Puppet or others, this could impact IBM Cloud Backup and Recovery's interaction with servers that have the Linux agent installed. Take the corresponding
actions below:
| Agent Installation - User type | Action required |
|---|---|
| As default cohesityagent user | The Backup agent is installed using the cohesityagent user by default. For default installations, the cohesityagent is created by the installer. During installation, the installer updates the /etc/sudoers file to allow cohesityagent
sudo and no-tty sudo access. Ensure the following settings in the /etc/sudoers file for the cohesityagent user are preserved:cohesityagent ALL=(ALL) NOPASSWD:ALL Defaults:cohesityagent !requiretty An example of the sudoers file is as given below: #includedir /etc/sudoers.d dgoble ALL=(ALL) NOPASSWD:ALL cohbackup ALL=(ALL) NOPASSWD:ALL Defaults:cohbackup !requiretty |
| As non default user, example foo | Ensure the above settings in the /etc/sudoers file for the foo user are preserved by replacing the occurrences of cohesityagent with foo. |
| As root user | No changes required |
cohesity_linux_agent.sh
The table lists how cohesity_linux_agent.sh interacts with various init systems to issue start/stop/status commands.
If IBM Cloud Backup and Recovery does not detect any of the init systems, the installer uses the undetected init system commands.
| init system | Commands |
|---|---|
| systemd | sudo systemctl start cohesity-agent sudo systemctl stop cohesity-agent sudo systemctl status cohesity-agent |
| upstart | sudo initctl start cohesity-agent sudo initctl stop cohesity-agent sudo initctl status cohesity-agent |
| SysV | sudo /etc/init.d/cohesity-agent start sudo /etc/init.d/cohesity-agent stop sudo /etc/init.d/cohesity-agent status |
| undetected | sudo /etc/init.d/cohesity-agent start sudo /etc/init.d/cohesity-agent stop sudo /etc/init.d/cohesity-agent status |
Download and Install the Backup agent on RHV Hosts
IBM Cloud Supports RHV only until version 6.8.1. While you can still protect your RHV sources, the IBM Cloud Support team will not provide assistance.
Ensure you install the Backup agent on any RHV hosts that you want IBM Cloud Backup and Recovery to protect. For installing the agent on RHV hosts, follow the steps described in the Download and Install the Backup agent on Linux Physical Servers” section based on the Linux distribution
Run the following command on all the RHV hosts after they are connected and configured by the oVirt Manager:
# iptables -I INPUT `iptables -L INPUT --line-numbers | grep REJECT | awk '{ print $1 }'` -p tcp --dport 50051 -j ACCEPT
# service iptables save # service iptables restart
If the firewall is enabled on RHV 4.1 hosts, open the following port 50051 to accept traffic.
To open the ports, run the following command:
firewall-cmd --permanent --add-port 50051/tcp
Linux Script Installer Options
The Backup agent installer has the following options available.
| Option | Description |
|---|---|
| --agent-options, -a [options] | Options to pass to the Backup agent. Used with single mode operation only. |
| --create-user, -c [0|1] | Whether to create --service-user or not. [Default: 1] Used with --install option only. |
| --debug, -d | Enable shell script debugging with set -x [Default: off] |
| --full-uninstall, -U | Uninstall the Backup agent including service-user account and its home directory contents. Destructive operation. Use with care. |
| --help, -h | Print this help. |
| --install, -i | Install/uninstall the Backup agent. |
| --install-dir, -I [dir] | Backup agent installation dir. [Default: /home/<username>/cohesityagent or /root/cohesityagent] |
| --install-log-file, -L [file] | Filename where installer logs should be saved. [Default: /tmp/cohesity_agent_installer_<time_in_seconds>_
|
| --log-dir | Backup agent log installation directory. [Default: /home/cohesityagent/cohesityagent/logs] |
| --service-group, -G [group] | Groupname to use for service. [Default: cohesityagent] |
| --service-user, -S [user] | Username to use for service. [Default: cohesityagent] |
| --single-mode, -s | Install the Backup agent for single mode operation. This installs the agent for one time usage/run only. It does not install the Agent to run as service or daemon to run continuously. This copies all required binaries/files to a location and runs the agent. Example use case: You want to recover files to a Linux VM. IBM Cloud Backup and Recovery pushes the Backup agent and starts it. After performing the usual file/folder recovery by talking to Backup agent and file copying is done, the Agent is removed. The agent is not installed to run as service. It runs for the duration of the recover task only. |
| --skip-lvm-check | 1 - Skip LVM related checks during installation and start the agent in non-lvm mode (only file-based backup will be supported). 0 - Flag is not set. The default value is 0. |
| --skip-mountpoint-check | Skip checks performed on installation directory's filesystem mountpoint. |
| --target | Extract directly to a target directory. Directory path can be either absolute or relative. [Default: /tmp] |
| --update-uninstall, -u | Uninstall the Backup agent. Preserve user, group and agent config. Useful when upgrading software. |
| --yes-all, -y | Accept 'yes' answer to all questions in installer. [Default: off] This is useful for performing silent install/uninstall. |
Install the Backup agent to run with the Root User
Follow the steps below to install the Backup agent to run with the root user:
In the following command, replace the Backup agent version with the desired agent version.
For example, run the following command: sudo ./cohesity_agent__linux_x64_installer -- --install -S root -G root -c 0 -I /opt -y
The above example does the following:
-S root -G rootsets user "root:root" user:group for the agent.-c 0instructs the installer that userrootalready exists on the system, so do not create it.-I /optinstalls the agent in the /opt directory. If you do not specify the directory, then the default home directory of the user will be used, /root/ in this case.
Sudo Privileges for Linux Users
The Linux system administrator can allowlist set of commands that do not need the root rights to be executed from the Backup agent deployed on the Linux servers.
The following tables list the commands that can be allowlisted for Oracle database, volume backups, and file restores for the Backup agent.
Oracle Database
| Argument | Default Behavior | Allowlist Commands |
|---|---|---|
| --skip-oracle-check | The default value is 0. We will allowlist commands required by Oracle database. | mkdirrmteestatcpsrvctl (from Oracle home) |
| If set to 1, we will not add any commands to the allowlist. |
Volume Backup
| Argument | Default Behavior | Allowlist Commands |
|---|---|---|
| --skip-lvm-check | The default value is 0. We will allowlist commands required by volume backup. | lvsvgslvcreatevgcreate |
| If set to 1, we will not add any commands to the allowlist. |
File Restore
| Argument | Default Behavior | Allowlist Commands |
|---|---|---|
| --skip-restore-check | The default value is 0. We will allowlist commands required by file restore. | blkidlsoflslosetupdmsetuprsynctimeout |
| If set to 1, we will not add any commands to the allowlist. |
During a Linux agent upgrade: If NOPASSWD:ALL entry is present in the sudoers file, then all commands can be executed without the root rights. If NOPASSWD:ALL entry is removed from the sudoers file, then you can add the commands listed in the table above for allowlisting.
Upgrade the Linux Agent
You can upgrade the Linux agent either from the IBM Cloud Backup and Recovery UI or using the CLI.
In the following commands, replace the Backup agent version with the desired agent version.
| Upgrade from the IBM Cloud Backup and Recovery UI | Upgrade using CLI |
|---|---|
| 1. Navigate to Data Protection > Sources. 2. Click Download Backup agent. 3. Stop the Agent service on the server. 4. Click Upgrade Agents. 5. Restart the Agent service. |
1. Navigate to the Agent installation directory. 2. Run the following command to install the script installer package: sudo cohesity_agent__linux_x64_installer -- --install 3. Run the following command to install the RPM package: rpm -U el-cohesity-agent--1.x86_64.rpm 4. Run the following command to install the Debian package: dpkg -i cohesity-agent_-1_amd64.deb 5. Run the following command to install the SUSE RPM package: rpm -U cohesity-agent--1.x86_64.rpm 6. Run the following command to install the PowerPC RPM package: rpm -U cohesity-java-agent-7.0.1-1.ppc64le.rpm |
Auto-upgrade of the Backup agent
IBM Cloud Supports auto-upgrade of the Backup agent running on physical servers.
The option to auto-upgrade Backup agent is not available on the IBM Cloud Backup and Recovery with multi-tenancy configured.
To enable auto-upgrade:
- Navigate to Settings > Update, and select Upgrade tab.
- Select the Upgrade Backup agent on all servers in Sources checkbox.
Uninstall the Script-Based Agent
To uninstall script-based agent, follow one of the methods listed below:
-
If the Backup agent is installed in the default installation directory, run the "uninstall" script that is included with the installed software. For example:
cd <bin_directory> [default=/home/cohesityagent/cohesityagent/software/crux/bin] sudo ./uninstall
-
Use the agent installer itself. For example:
sudo ./cohesity_agent__linux_x64_installer -- --full-uninstall
Replace the Backup agent version with the desired agent version.
Uninstall RPM/PKG Agents
To unistall the RPM/PKG agents, follow the steps listed below:
-
To uninstall the SUSE RPM/RPM package, run the following command:
rpm -e cohesity-agent
-
To uninstall the Debian package, run the following command:
dpkg -r cohesity-agent
-
To uninstall the PowerPC package, run the following command:
rpm -e cohesity-java-agent
Sample Ubuntu Linux Installation Output
Sample output for the following command:

sudo ./cohesity_linux_agent_installer -- -i -y
Verifying archive integrity... All good.
Uncompressing Backup agent 100%
==> User asked to accept 'yes' answer to all questions in installer.
------------------------------------------------------------------------------
==> UserId = uid=0(root) gid=0(root) groups=0(root)
==> Umask = 0077
==> Setting umask to 022
==> Umask = 0022
------------------------------------------------------------------------------
==> SUDO_COMMAND_PREFIX=
/sbin/init: unrecognized option '--version'
==> INIT system detected: systemd
==> Checking if user has provided overrides from command line...
==> Service user : cohesityagent
==> Finding service user group based user input ...
==> Service user group : cohesityagent
==> Finding installation directory ...
==> Installation directory for agent: /home/cohesityagent/cohesityagent
==> Generating set_env.sh ...
==> Sourcing /tmp/selfgz30348/set_env.sh
==> Backup agent Software Version: 5.0.1
==> Installed Backup agent will be run with user=cohesityagent.
------------------------------------------------------------------------------
==> Installing Backup agent version 5.0.1
------------------------------------------------------------------------------
COHESITY_USER=cohesityagent
COHESITY_GROUP=cohesityagent
COHESITY_USER_CREATED=1
COHESITY_HOME_DIR=/home/cohesityagent
COHESITY_INSTALL_DIR=/home/cohesityagent/cohesityagent
------------------------------------------------------------------------------
==> User has given '--yes-all' option. Using that for next question...
Do you want to continue installing? (y/n) yes
==> Continuing installation...
------------------------------------------------------------------------------
==> This is x86_64 system
==> LVM: Using lvs from path: /sbin/lvs
==> LVM: 2.02.133(2)(2015-10-30)
==> Rsync: Using rsync from path: /usr/bin/rsync
==> Rsync: rsync version 3.1.1 protocol version 31
==> Installing on Linux Distribution: "Ubuntu 16.04.2 LTS"
==> No previous Backup agent is detected on this system.
==> Agent process linux_agent_exec is not running.
==> Checking mountpoint for install directory: /home/cohesityagent/cohesityagent
==> Parent of installation directory (existing): /home
==> Mountpoint of parent installation directory: /
==> Checking if mountpoint / has required option "rw" set.
(rw,relatime,errors=remount-ro,data=ordered)
==> Checking if mountpoint / has unsupported option "nosuid" set.
==> Checking if mountpoint / has unsupported option "noexec" set.
==> User=cohesityagent does not exist in /etc/passwd
==> Checking if User=cohesityagent exists using getent command.
==> User=cohesityagent not found with getend command.
==> Group=cohesityagent does not exist in /etc/group
==> Group=cohesityagent not found with getent command.
id: ‘cohesityagent’: no such user
==> Group=cohesityagent is not found with id command
==> Adding cohesityagent to sudoers list
==> Directory structure created under /home/cohesityagent/cohesityagent
==> Copied software contents to /home/cohesityagent/cohesityagent
==> Old installation directory is empty. Skipping copying data from older installation.
/home/cohesityagent/cohesityagent/software/crux/bin/linux_agent_exec = cap_dac_override,cap_sys_resource+ep
Synchronizing state of cohesity-agent.service with SysV init with /lib/systemd/systemd-sysv-install...
Executing /lib/systemd/systemd-sysv-install enable cohesity-agent
insserv: warning: current start runlevel(s) (empty) of script `cohesity-agent' overrides LSB defaults (2 3 4 5).
insserv: warning: current stop runlevel(s) (empty) of script `cohesity-agent' overrides LSB defaults (2 3 4 5).
Created symlink from /etc/systemd/system/multi-user.target.wants/cohesity-agent.service to /usr/lib/systemd/system/cohesity-agent.service.
==> Service cohesity-agent added to systemd
==> Starting cohesity-agent...
● cohesity-agent.service - Backup agent
Loaded: loaded (/usr/lib/systemd/system/cohesity-agent.service; enabled; vendor preset: enabled)
Active: active (running) since Mon 2018-01-29 23:22:01 PST; 5ms ago
Process: 30796 ExecStart=/etc/init.d/cohesity-agent start (code=exited, status=0/SUCCESS)
Process: 30793 ExecStartPre=/bin/chown -R cohesityagent:cohesityagent /var/run/cohesity-agent (code=exited, status=0/SUCCESS)
Process: 30788 ExecStartPre=/bin/mkdir -p /var/run/cohesity-agent (code=exited, status=0/SUCCESS)
Main PID: 30927 (linux_agent_exe)
Tasks: 10
Memory: 280.0K
CPU: 142ms
CGroup: /system.slice/cohesity-agent.service
‣ 30927 /home/cohesityagent/cohesityagent/software/crux/bin/linux_agent_exec --log_dir=/home/cohesityagent/cohesityagent/data/logs --max_log_size=30 --stop_logging_if_full_disk=true --logbuflevel=-1 --linux_agent_nfs_mountpoint_base_dir=/home/cohesityagent/cohesityagent/data/agent//tmp/nfs_mounts --linux_agent_volume_mountpoint_base_dir=/home/cohesityagent/cohesityagent/data/agent//tmp/vol_mounts --linux_agent_config_file_path=/home/cohesityagent/cohesityagent/data/config/cohesity_agent.cfg --util_misc_mount_command=/bin/mount --util_misc_umount_command=/bin/umount --util_misc_findmnt_command=/bin/findmnt --util_misc_sudo_command=/usr/bin/sudo --yoda_util_vmware_mount_command=/home/cohesityagent/cohesityagent/software/crux/bin/vm_mounter.sh --yoda_mount_command=/bin/mount --yoda_umount_command=/bin/umount --yoda_findmnt_command=/bin/findmnt --yoda_sudo_command=/usr/bin/sudo --timeout_command=/usr/bin/timeout --yoda_blkid_command=/sbin/blkid --yoda_lsof_command=/usr/bin/lsof --yoda_ls_command=/bin/ls --linux_sudo_command=/usr/bin/sudo --linux_chmod_command=/bin/chmod --linux_timeout_command=/usr/bin/timeout --linux_lvs_command=/sbin/lvs --linux_vgs_command=/sbin/vgs --linux_lvcreate_command=/sbin/lvcreate --linux_lvremove_command=/sbin/lvremove --linux_agent_rsync_cmd=/usr/bin/rsync --linux_agent_wget_command=/usr/bin/wget --yoda_losetup_command=/sbin/losetup --yoda_dmsetup_command=/sbin/dmsetup --linux_dump_memory_usage=false --yoda_bindfs_mount=false --libssl_non_fips_path= --libssl_path= -v=0
Jan 29 23:21:59 ubuntu16-server cohesity-agent[30796]: Starting linux_agent_exec...
Jan 29 23:21:59 ubuntu16-server cohesity-agent[30796]: GNU coreutils version = 8.25
Jan 29 23:21:59 ubuntu16-server cohesity-agent[30796]: Setting coredump limit to unlimited for qa build
Jan 29 23:21:59 ubuntu16-server cohesity-agent[30796]: Init system is systemd, will run linux_agent_exec in background
Jan 29 23:21:59 ubuntu16-server su[30918]: Successful su for cohesityagent by root
Jan 29 23:21:59 ubuntu16-server su[30918]: + ??? root:cohesityagent
Jan 29 23:22:01 ubuntu16-server cohesity-agent[30796]: Parent process pid=30927
Jan 29 23:22:01 ubuntu16-server cohesity-agent[30796]: 30927
Jan 29 23:22:01 ubuntu16-server systemd[1]: Started Backup agent.
Jan 29 23:22:01 ubuntu16-server systemd[1]: Started Backup agent.
------------------------------------------------------------------------------
==> Backup agent is installed successfully.
------------------------------------------------------------------------------
------------------------------------------------------------------------------
Agent Help (init system: systemd)
------------------------------------------------------------------------------
Agent start:
# sudo systemctl start cohesity-agent
Agent stop:
# sudo systemctl stop cohesity-agent
Agent status:
# sudo systemctl status cohesity-agent
------------------------------------------------------------------------------
cohesity@ubuntu16-server:~/agent$ cohesity@ubuntu16-server:~/agent$ sudo ./cohesity_linux_agent_installer_qa -- -i -y
==> Umask = 0022
------------------------------------------------------------------------------
==> SUDO_COMMAND_PREFIX=
/sbin/init: unrecognized option '--version'
==> INIT system detected: systemd
==> Checking if user has provided overrides from command line...
==> Service user : cohesityagent
==> Finding service user group based user input ...
==> Service user group : cohesityagent
==> Finding installation directory ...
==> Installation directory for agent: /home/cohesityagent/cohesityagent
==> Generating set_env.sh ...
==> Sourcing /tmp/selfgz30348/set_env.sh
==> Backup agent Software Version: 5.0.1
==> Installed Backup agent will be run with user=cohesityagent.
------------------------------------------------------------------------------
==> Installing Backup agent version 5.0.1
------------------------------------------------------------------------------
COHESITY_USER=cohesityagent
COHESITY_GROUP=cohesityagent
COHESITY_USER_CREATED=1
COHESITY_HOME_DIR=/home/cohesityagent
COHESITY_INSTALL_DIR=/home/cohesityagent/cohesityagent
------------------------------------------------------------------------------
==> User has given '--yes-all' option. Using that for next question...
Do you want to continue installing? (y/n) yes
==> Continuing installation...
------------------------------------------------------------------------------
==> This is x86_64 system
==> LVM: Using lvs from path: /sbin/lvs
==> LVM: 2.02.133(2)(2015-10-30)
==> Rsync: Using rsync from path: /usr/bin/rsync
==> Rsync: rsync version 3.1.1 protocol version 31
==> Installing on Linux Distribution: "Ubuntu 16.04.2 LTS"
==> No previous Backup agent is detected on this system.
==> Agent process linux_agent_exec is not running.
==> Checking mountpoint for install directory: /home/cohesityagent/cohesityagent
==> Parent of installation directory (existing): /home
==> Mountpoint of parent installation directory: /
==> Checking if mountpoint / has required option "rw" set.
(rw,relatime,errors=remount-ro,data=ordered)
==> Checking if mountpoint / has unsupported option "nosuid" set.
==> Checking if mountpoint / has unsupported option "noexec" set.
==> User=cohesityagent does not exist in /etc/passwd
==> Checking if User=cohesityagent exists using getent command.
==> User=cohesityagent not found with getend command.
==> Group=cohesityagent does not exist in /etc/group
==> Group=cohesityagent not found with getent command.
id: ‘cohesityagent’: no such user
==> Group=cohesityagent is not found with id command
==> Adding cohesityagent to sudoers list
==> Directory structure created under /home/cohesityagent/cohesityagent
==> Copied software contents to /home/cohesityagent/co-bash: cohesity@ubuntu16-server:~/agent$: No such file or directory
hesityagent
==> Old installation directory is empty. Skipping copying data from older installation.
/home/cohesityagent/cohesityagent/software/crux/bin/linux_agent_exec = cap_dac_override,cap_sys_resource+ep
Synchronizing state of cohesity-agent.service with SysV init with /lib/systemd/systemd-sysv-install...
Executing /lib/systemd/systemd-sysv-install enable cohesity-agent
insserv: warning: current start runlevel(s) (empty) of script `cohesity-agent' overrides LSB defaults (2 3 4 5).
insserv: warning: current stop runlevel(s) (empty) of script `cohesity-agent' overrides LSB defaults (2 3 4 5).
Created symlink from /etc/systemd/system/multi-user.target.wants/cohesity-agent.service to /usr/lib/systemd/system/cohesity-agent.service.
==> Service cohesity-agent added to systemd
==> Starting cohesity-agent...
● cohesity-agent.service - Backup agent
Loaded: loaded (/usr/lib/systemd/system/cohesity-agent.service; enabled; vendor preset: enabled)
Active: active (running) since Mon 2018-01-29 23:22:01 PST; 5ms ago
Troubleshoot
For troubleshooting information, see Troubleshooting Backup agent issues on Linux physical servers.
Log in to the IBM Cloud Support site to see more knowledge base articles.