Search <book_title>...

Veritas NetBackup™ WebSocket Service (NBWSS) Reference Guide

Last Published: 2020-07-29

Product(s): NetBackup (8.3.0.1, 8.3)

Problems validating the endpoint server in the WebSocket Server dialog

This topic pertains to the NetBackup WebSocket Service (NBWSS).

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

Problems with endpoint details in a JSON-formatted file

Table: Problems adding the endpoint details from a JSON-formatted file

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` Or `Malformed URL:`	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.
`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.

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

Malformed URL:

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.

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.

Problems with endpoint details in a URL

Table: Problems adding the endpoint details from a URL

Error	Explanation and recommended action
`Invalid command parameter` Or `Malformed URL:`	The WebSocket URL 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.
`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.
`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.
`InvalidPacketException Unable to parse JSON contents`	The data that is hosted on the endpoint URL does not match the format in the table in the following topic: See WebSocket endpoint details and their formatting.

See Problems saving the NetBackup endpoint credentials in the WebSocket Server dialog.