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 NetBackup Snapshot Manager Linux-based agent was already configured on the host earlier, and you wish to re-register the agent with the same NetBackup Snapshot Manager instance, then perform the following on the Linux host:
Remove the
/opt/keysdirectory from the Linux host.Enter the following command on the host where the agent is running:
# sudo rm -rf /opt/keys
If the NetBackup Snapshot Manager Linux-based agent was already registered on the host earlier, and you wish to register the agent with a different NetBackup Snapshot Manager instance, then perform the following on the Linux host:
Uninstall the agent from the Linux host.
Remove the
/opt/keysdirectory from the Linux host.Enter the following command:
# sudo rm -rf /opt/keys
Remove the
/etc/flexsnap.confconfiguration file from the Linux host.Enter the following command:
sudo rm -rf /etc/flexsnap.conf
Re-install the agent on the Linux host.
See Downloading and installing the NetBackup Snapshot Manager 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 Snapshot Manager instance <instance>.
The on-host agent registration may fail if the host is FIPS enabled and NetBackup Snapshot Manager is not, or vice versa.
To register the Linux-based agent
- Return to the NetBackup Web UI, and on the Add agent dialog box, click Create Token.
If you have closed the dialog box, sign in to the NetBackup Web UI again and perform the following:
On the left, click Workloads > Cloud.
Click the Snapshot Managers tab.
From the desired NetBackup Snapshot Manager server row, click the actions button on the right and then select Add agent.
On the Add agent dialog box, click Create Token.
- Click Copy Token to copy the displayed NetBackup Snapshot Manager 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 NetBackup Snapshot Manager.
Note:
The token is valid for 180 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 <snapshotmanager_host_FQDN_or_IP> --token <authtoken>
Here, <snapshotmanager_host_FQDN_or_IP> is the NetBackup Snapshot Manager server's Fully Qualified Domain Name (FQDN) or IP address that was specified during the NetBackup Snapshot Manager 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.
NetBackup Snapshot Manager performs the following actions when you run this command:
Note:
If you encounter an error, check the
flexsnap-agentlogs to troubleshoot the issue. - Return to the NetBackup Web UI, close the Add agent dialog box, and then from the NetBackup Snapshot Manager 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 NetBackup Snapshot Manager 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.
More Information
Downloading and installing the NetBackup Snapshot Manager agent