Search <book_title>...

Veritas NetBackup™ WebSocket Service (NBWSS) Reference Guide

Last Published: 2018-09-17

Product(s): NetBackup (8.2, 8.1.2, 8.1.1)

Problems saving the NetBackup endpoint credentials in the WebSocket Server dialog

This topic describes the problems that may occur when you click Add Host on the NetBackup WebSocket Server dialog to save NetBackup credentials for an endpoint.

Table: Problems saving the endpoint details as NetBackup credentials

Error	Explanation and recommended action
`JSON contents not valid`	The endpoint information in the JSON file is invalid. For example: one or more of the fields in the JSON file are empty or contain unsupported characters. Note that NetBackup does not support an apostrophe (') anywhere in the file. See WebSocket endpoint details and their formatting. Correct the JSON file accordingly.
`Invalid websocket protocol. Only wss protocol supported`	The WebSocket URL in the JSON file is not in the supported format. Specify the URL as described in the table in the following topic: See WebSocket endpoint details and their formatting.
`Communication with EMM failed` Or `Unable to establish connection with host: <Websocket servername>`	The server details are incorrect or there is a networking problem. Make sure the WebSocket server's host name (or IP address) and port are correct. Make sure you can ping the WebSocket server. Verify that DNS lookup works.
`Webservices unable to connect to EMM. Hint: check your security settings; Config WebServices are not compatible with NBAC`	NetBackup Access Control (NBAC) mode is enabled. The Config Webservices do not support your current NBAC settings. Review the NBAC settings. Consider disabling NBAC.
`the entity already exists`	Make sure that an endpoint server with the same name has not already been added in NetBackup. To display the saved endpoints, click the refresh option in the Administration Console toolbar: Contact Veritas Technical Support for further assistance.
`The certificate did not match with the one accepted by the user, please verify the certificate`	The SSL certificate that you accepted with the Validate option on the WebSocket Server dialog does not match the certificate that the URL obtained when you clicked Add Host. Make sure that the SSL certificate on the endpoint server was not changed after you clicked Validate to accept the certificate.
`Failed to setup SSL security` Or `Failed to open connection to the remote object referred to by the URL`	NetBackup was unable to get the SSL certificate from the endpoint URL. Make sure the WebSocket server has a valid SSL certificate.
`Problem occurred while storing the SSL certificate in the truststore` Or `Error loading keystore`	NetBackup was unable to save the SSL certificate of the endpoint server to the NetBackup trust store. Contact Veritas Technical Support for further assistance.

Error

Explanation and recommended action

JSON contents not valid

The endpoint information in the JSON file is invalid. For example: one or more of the fields in the JSON file are empty or contain unsupported characters. Note that NetBackup does not support an apostrophe (') anywhere in the file.

See WebSocket endpoint details and their formatting.

Correct the JSON file accordingly.

Invalid websocket protocol. Only wss protocol supported

The WebSocket URL in the JSON file is not in the supported format.

Specify the URL as described in the table in the following topic:

See WebSocket endpoint details and their formatting.

Communication with EMM failed

Unable to establish connection with host: <Websocket servername>

The server details are incorrect or there is a networking problem.

Make sure the WebSocket server's host name (or IP address) and port are correct.
Make sure you can ping the WebSocket server.
Verify that DNS lookup works.

Webservices unable to connect to EMM. Hint: check your security settings; Config WebServices are not compatible with NBAC

NetBackup Access Control (NBAC) mode is enabled. The Config Webservices do not support your current NBAC settings.

Review the NBAC settings. Consider disabling NBAC.

the entity already exists

Make sure that an endpoint server with the same name has not already been added in NetBackup. To display the saved endpoints, click the refresh option in the Administration Console toolbar:

Contact Veritas Technical Support for further assistance.

The certificate did not match with the one accepted by the user, please verify the certificate

The SSL certificate that you accepted with the Validate option on the WebSocket Server dialog does not match the certificate that the URL obtained when you clicked Add Host.

Make sure that the SSL certificate on the endpoint server was not changed after you clicked Validate to accept the certificate.

Failed to setup SSL security

Failed to open connection to the remote object referred to by the URL

NetBackup was unable to get the SSL certificate from the endpoint URL.

Make sure the WebSocket server has a valid SSL certificate.

Problem occurred while storing the SSL certificate in the truststore

Error loading keystore

NetBackup was unable to save the SSL certificate of the endpoint server to the NetBackup trust store.

Contact Veritas Technical Support for further assistance.