Search <book_title>...

Veritas NetBackup™ CloudPoint Install and Upgrade Guide

Last Published: 2021-01-01

Product(s): NetBackup (9.0)

Platform: Linux

Registering the Linux-based agent

Verify the following before you register the Linux-based agent:

Ensure that you have downloaded and installed the agent on the application host.
Ensure that you have root privileges on the Linux instance.
If the CloudPoint Linux-based agent was already configured on the host earlier, and you wish to re-register the agent with the same CloudPoint instance, then do the following on the Linux host:
- Remove the /opt/VRTScloudpoint/keys directory from the Linux host.
  Type the following command on the host where the agent is running:
  # sudo rm -rf /opt/VRTScloudpoint/keys
If the CloudPoint Linux-based agent was already registered on the host earlier, and you wish to register the agent with a different CloudPoint instance, then do the following on the Linux host:
- Uninstall the agent from the Linux host.
  See Removing the CloudPoint agents.
- Remove the /opt/VRTScloudpoint/keys directory from the Linux host.
  Type the following command:
  # sudo rm -rf /opt/VRTScloudpoint/keys
- Remove the /etc/flexsnap.conf configuration file from the Linux host.
  Type the following command:
  sudo rm -rf /etc/flexsnap.conf
- Re-install the agent on the Linux host.
  See Downloading and installing the CloudPoint agent.
If you do not perform these steps, then the on-host agent registration may fail with the following error:
```
On-host registration has failed. The agent is already registered 
with CloudPoint instance <instance>.
```

To register the Linux-based agent

Return to the NetBackup Web UI, and on the Download agent dialog box, click Create Token.
If you have closed the dialog box, sign in to the NetBackup Web UI again and do the following:
- Click Cloud from the left navigation menu, and select the CloudPoint servers tab.
- From the desired CloudPoint server row, click the actions button on the right and then select Download agent.
- On the Download agent dialog box, click Create Token.
Click Copy Token to copy the displayed CloudPoint validation token.
The token is a unique sequence of alpha-numeric characters and is used as an authentication token to authorize the host connection with CloudPoint.
Note:
The token is valid for 60 seconds only. If you do not copy the token within that time frame, generate a new token again.
Connect to the Linux host and register the agent using the following command:
# sudo flexsnap-agent --ip <cloudpoint_host_FQDN_or_IP> --token <authtoken>
Here, <cloudpoint_host_FQDN_or_IP> is the CloudPoint server's Fully Qualified Domain Name (FQDN) or IP address that was specified during the CloudPoint configuration.
<authtoken> is the authentication token that you copied in the earlier step.
Note:
You can use flexsnap-agent --help to see the command help.
CloudPoint performs the following actions when you run this command:
- registers the Linux-based agent
- creates a /etc/flexsnap.conf configuration file on the Linux instance and updates the file with CloudPoint host information
- enables and then starts the agent service on the Linux host
Note:
If you encounter an error, check the flexsnap-agent logs to troubleshoot the issue.
Return to the NetBackup Web UI, close the Download agent dialog box, and then from the CloudPoint server row, click the actions button on the right and then click Discover.
This triggers a manual discovery of all the assets that are registered with the CloudPoint server.
Click on the Virtual machines tab.
The Linux host where you installed the agent should appear in the discovered assets list.
Click to select the Linux host. If the host status is displayed as VM Connected and a Configure Application button appears, it confirms that the agent registration is successful.
This completes the agent registration. You can now proceed to configure the application plug-in.
See Configuring the CloudPoint application plug-in.

More Information

Downloading and installing the CloudPoint agent