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 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 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 <cloudpoint_host_FQDN_or_IP> --token <authtoken>
The agent installation directory is the path you specified while installing the Windows agent using the installation wizard earlier. The default path is
C:\Program Files\Veritas\CloudPoint\.Here, <cloudpoint_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
C:\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.
- 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 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