Registering the Windows-based agent
Verify the following before you register the Windows-based agent:
Ensure that you have downloaded and installed the agent on the Windows application host.
Ensure that you have administrative privileges on the Windows host.
To register the Windows-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 do the following:
On the left, click Workloads > Cloud.
Click on 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 Windows instance and register the agent.
From the command prompt, navigate to the agent installation directory and type the following command:
flexsnap-agent.exe --ip <snapshotmanager_host_FQDN_or_IP> --token <authtoken>
The default path is
<System Drive>\Program Files\Veritas\CloudPoint\.Here, <snapshotmanager_host_FQDN_or_IP> is the NetBackup host's Fully Qualified Domain Name (FQDN) or IP address that was used during the NetBackup initial configuration.
<authtoken> is the authentication token that you copied in the earlier step.
Note:
You can use flexsnap-agent.exe --help to see the command help.
NetBackup performs the following actions when you run this command:
registers the Windows-based agent
creates a
<System Drive>\ProgramData\Veritas\CloudPoint\etc\flexsnap.confconfiguration file on the Windows instance and updates the file with NetBackup host informationenables and then starts the agent service on the Windows host
Note:
If you intend to automate the agent registration process using a script or a 3rd-party deployment tool, then consider the following:
Even if the agent has been registered successfully, the Windows agent registration command may sometimes return error code 1 (which generally indicates a failure) instead of error code 0.
An incorrect return code might lead your automation tool to incorrectly indicate that the registration has failed. In such cases, you must verify the agent registration status either by looking in to the flexsnap-agent-onhost logs or from the NetBackup Web UI.
User might see the following warning which can be ignored:
InsecureRequestWarning: Unverified HTTPS request is being made to host '10.244.176.175'. Adding certificate verification is strongly advised. See: https://urllib3.readthedocs.io/en/1.26.x/advanced-usage.html#ssl-warnings
Agent will be registered after some time.
- 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 Windows host where you installed the agent should appear in the discovered assets list.
Click to select the Windows 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