Automatic connection

General information about configuring Automatic connection

This setting is used to automatically connect:

• the client to the server without re-entering the server name, username and password when starting the app;
• the client to servers belonging to different domains (see Cross-System client);
• the client to the nodes of the failover system (see Configuring Failover VMS).

If you connect automatically, the servers specified in the Automatic connection parameters group will be used first. If these servers are unavailable, the system will try to connect to the servers from the Preferred servers parameters group following the set order (see Selecting Preferred Servers).

Configuring the automatic connection

To configure the automatic connection, do the following:

1. Select the Options tab (1) → Automatic connection (2).
   
2. From the drop-down list (3), select the connection protocol to the server.
   Description of the protocol and recommendations for selection are given in the table.
   

   Protocol	Description
   TCP	This protocol is more reliable but has a busy connection. We recommend selecting it for servers with a small number of cameras
   UDP unicast	UDP protocol has a higher data transmission speed, but it is less reliable. The unicast scheme is used to transmit data to one recipient. You must select this protocol for a server with a large number of cameras that has several clients working with it
   UDP multicast	The multicast scheme is used to transmit data to a group of recipients. This protocol is best suited for a server with a large number of cameras that has many clients working with it. Attention! To operate with this protocol, all network elements, including switches must support it

   The choice of either favoring connection reliability or data transmission speed depends on the clients' connection protocol to the server. You can select the connection protocol for each server of the domain. All clients connected to the server will receive video streams via this protocol.

3. For automatic authorization when connecting to servers, enter the username and password (4). If you leave these fields blank, authorization will be performed manually when you start the client.
   

   Attention!

   Cross-System client connects to all servers using a single username-password pair that must be created in each domain (see Cross-System client).

4. In the Connection timeout field (5), specify the waiting period for a successful connection before considering the attempt unsuccessful. The default value is 60 seconds, the maximum value is 300 seconds (5 minutes). If you use this setting, an automatic connection attempt will occur immediately. If the connection fails, the server will wait for the time period (timeout) specified by the user and repeat the connection attempt.
5. Specify the maximum number of automatic connection attempts after the specified timeout (6).
6. Specify the servers to which you want to connect. For each server, do the following:
   
   
   1. Select a server from the list or enter the server IP address (7).
   2. Specify the port for connecting to the server (8).
      

      Note

      If you leave the Port field blank, the standard port 20109 will be used for connection.

   3. Click the Add button (9).
      

      Note

      • If you use the Cross-System client, you can connect to only one server of each domain (see Cross-System client). Therefore, when you add a server to the list, all other servers of this domain become unavailable for selection.
      • To remove a server from the list, click the button.

Configuring the automatic connection of the client to servers is complete. The next time you start Axxon One, the system will connect to the selected servers.

Configuring the automatic connection of the client to servers belonging to different domains

When you use the Cross-System client, select the main domain after adding all servers to the list. To select the main domain, set the Main checkbox in the corresponding column of the server that belongs to this domain.

When you connect, the client will use the parameters (maps, layouts, user permissions) of the main domain.

Configuring the automatic connection of the client to the nodes of the failover system

If you want to configure the automatic connection to a node of the failover system, do the following:

1. Set the Discover cluster checkbox (1).
   
2. Enter the IP address of any server of the cluster (2) and click the button.
3. From the drop-down list (3), select a node that you want to add to autoloading. 
4. Click the Add button.
5. Click the Apply  button.

Configuring the automatic connection of the client to the node of the failover system is complete.

Configuring the automatic connection with the backup server

To automatically connect to the backup server if the main one is unavailable in the N+1 cluster configuration, do the following:

1. In the Automatic connection parameters group, enter the IP address and port of the main server, as well as the name of the node.
2. Click the Add button.
3. Set the checkboxes in the Main and Discover cluster columns.
4. In the Preferred servers parameters group, select a backup server from the list or enter its IP address and node name.
5. If necessary, change the default port for the backup server in the Port field.
6. Click the Add button.
7. Click the Apply  button.

Configuring the automatic connection with the backup server is complete.

Changing the server port

To change the port of the already added server, do the following:

1. Select the server from the list again (1).
   
2. In the Port field (2), specify a new number.
3. Click the Edit button (3).

Changing the port of the added server is complete.

Exporting and importing the automatic connection configuration

To save the configuration of the automatic connection to servers and preferred servers (see Selecting Preferred Servers) to a JSON file, click the Export button.

To load the configuration on the clients, do the following:

1. Click the Import button.
2. Click the Apply button.