Installing the backup client in Linux

Installing the IBM Cloud® Backup for Classic client on a Linux®-based operating system can be done through a series of commands in the shell or the terminal within the OS.

This procedure outlines the steps that are required to install the client on any of the following operating systems:

Red Hat Enterprise Linux®
CentOS
CloudLinux®

After you completed the procedure, the automated process registers the Agent service with Cloud Backup Portal, then downloads and installs the files that are needed to run the service.

If you purchased IBM Cloud Backup for Classic when you ordered a server through the IBM Cloud catalog or the IBM Cloud console, then the software is automatically installed for you. You don't need to use the procedures that are described in this document.

If you purchased IBM Cloud Backup for Classic as an upgrade in the IBM Cloud console, follow these steps to install the software.

Logging in to the target device server

Log in to the IBM Cloud console. From the menu , select Infrastructure > Classic Infrastructure.
Select Devices > Device List from the main menu to see the list of available server devices.
Find the device for which you purchased the IBM Cloud Backup for Classic service, and make a note of its public IP address.
- This IP address is to be used when you log in to the device from the command line. In the command that is shown in Step 5, replace <publicIpAddress> with the actual public IP address.
Click Passwords to display the Password manager, and see the usernames and the passwords that are associated with the account.
Log in to the target device by entering the following command from the command line.
```
ssh <user name>@<publicIpAddress>
```
If you didn't log in to this server with this username before, you are presented a message about the authenticity of the host. You are also asked whether you want to continue. Reply with yes to continue.
You are prompted to enter the password unless you set up ssh keys for accessing this server before.

Updating the OS to prepare for the installation (RHEL only)

This step is required for RHEL, but optional for other distributions.

Run the following command at the server prompt.
```
yum update
```
If you're prompted, confirm that the download size is okay. The update proceeds and displays a "Complete" message when it finishes.

Getting the installation script

Run the following command at the server prompt.

wget -N http://downloads.service.softlayer.com/evault/evault_manual.sh

Running the installation Script

Run the following command at the server prompt.
```
sh ./evault_manual.sh
```
Enter your Cloud Backup Portal username and password.

For more information about viewing the username or changing the backup password, see Managing the username and password for the Cloud Backup service.
After the username and password, no further input is required. The prompts that are written to the screen as the installation proceeds can be safely ignored.

They are being produced by a subscript, which is started by the evault_manual.sh script. The evault_manual.sh script provides the input for these prompts.
The installation is complete when the following messages appear.
```
Starting VVAgent: [ OK ]
Starting buagent: [ OK ]
```

Verifying that the installation succeeded

Verify that the message Registered to The Portal appears in the installation output. The verification can be done by looking for the message on screen or by inspecting the output of the following command.
```
grep 'Registered' /opt/BUAgent/Install.log
```
Run the following command and observe the output.
- For backup agent 9.21:
```
etc/rc.d/vvagent status
```
- For previous versions:
```
service vvagent status
```
The following messages are displayed.
```
VVAgent is running (PID xxxxx).
buagent is running (PID xxxxx).
```
The process IDs that are represented by xxxxx vary with each installation.

Next steps

Log in to Cloud Backup Portal to configure and manage your backup agents. For more information, see the Getting Started Tutorial and Configuring a simple file-level backup.