Install Network Connector
  • 4 minutes to read
  • Dark
    Light
  • PDF

Install Network Connector

  • Dark
    Light
  • PDF

Article Summary

There are two steps to install the Network Connector:

  • Setting up the Network Connector Server.
  • Installing and configuring Network Connector Agents.

Requirements

  • 250 concurrent connections per active SNC - 1 GB Memory, 1 VCPU, 1GB NIC.
  • 750 concurrent connections per active SNC - 2 GB Memory, 2 VCPU, 1GB NIC.
  • 1500 concurrent connections per active SNC - 4 GB Memory, 4 VCPU, 1GB NIC.

The Network Connector Server needs to be set up only once, whereas Connector Agents should be installed and configured in every network not currently connected to senhasegura.

     

Configure Network Connector Server

To set up your Network Connector Server, run the command orbit network-connector on an instance of senhasegura.

Enter orbit network-connector --help to see all the optional arguments for this command.

Important
In clustered environments, set up the Network Connector Server in each node individually by repeating the setup steps in every node.
Requirements
sudo access to senhasegura's server.

An open TCP/51445 Port to communicate with senhasegura's server.

Follow the steps below to set up your Network Connector Server:

  1. Use the terminal to access each senhasegura instance.
  2. Run the following command:
sudo orbit network-connector setup
  1. Press Y when asked to confirm and wait for the process to complete.

This process will return either a success or an error message. All possible return messages are listed below.

TypeMessage
Successsenhasegura Network Connector Server is ready!

Use this fingerprint in senhasegura Network Connector Agents setup: FINGERPRINT.

In case you need it, instructions for starting senhasegura Network Connector Agents are available in our help center.

See at https://d.senhasegura.io/skme2rugfyizbw9

NOTE: If this environment is in cluster mode, run "sudo orbit network-connector setup" on secondary nodes.
ErrorCan't continue setup.

This node is a Secondary in cluster and senhasegura Network Connector Server needs to be initialized in the Primary node.

Please run "sudo orbit network-connector setup" in Primary node first.
ErrorWhoops! An error was found in application setup.

Check if application database is running and file replication between nodes is working without errors.
ErrorWhoops! An error was found.

Unable to determine which fingerprint senhasegura Network Connector Agents needs to connect to this Server, try again later.
ErrorWhoops! Could not replicate settings to cluster nodes.

Check if all cluster nodes are available and file replication is working and try again.

Add a Network Connector Agent

Now that your Network Connector Server has been set up use senhasegura's web interface to follow the steps below:

  1. Go to Devices ➔ Settings ➔ Network Connector ➔ Connectors to find your Connector listed.
  2. In the Action column, click the Edit button.
  3. Go to the Agents tab.
  4. Type the Name and Port of all the Agents you want to add to this Connector. Only use ports between 30000 and 30999.
  5. Finally, click the Save button.

Where to Find the Network Connector Fingerprint

Adding new Agents requires the fingerprint that was generated during setup. To find the fingerprint, follow the steps below:

  1. Log into senhasegura's web interface.
  2. Go to Devices ➔ Settings ➔ Network Connector ➔ Connectors
  3. In the Action column, click on Details.
  4. This will open a new window. Click the fingerprint icon.
  5. Copy the fingerprint displayed.

How to Install a Network Connector Agent

Requirements


Recommendation

We highly recommend using the Linux Standalone binary when installing Docker Compose on a Linux distro.

Important

Do not install Network Connector Agents on senhasegura instances.


To install the Network Connector Agent, follow these steps:

  1. Use a Linux machine with Docker installed. Make sure senhasegura has no access to this network.
  2. Create a file (vim docker-compose.yml) with the Agent settings.

Standalone Installation

  • SENHASEGURA_FINGERPRINT: Refer to the section Where to Find the Network Connector Fingerprint 
  • SENHASEGURA_AGENT_PORT: Use a port between 30000 e 30999  that is not currently used.
  • SENHASEGURA_AGENT_SECONDARY(optional): Choose true or false to enable or disable a secondary agent. Secondary agents are used when the primary agent is unavailable.
  • SENHASEGURA_ADDRESS: the IP address for your senhasegura instance, e.g. “192.168.10.20”
services:
  senhasegura-network-connector-agent:
    image: "registry.senhasegura.io/network-connector/agent-v2:latest"
    restart: unless-stopped
    networks:
      - senhasegura-network-connector
    environment:
      SENHASEGURA_FINGERPRINT: "CHANGE_ME"
      SENHASEGURA_AGENT_PORT: "CHANGE_ME"
      SENHASEGURA_ADDRESSES: "CHANGE_ME"
      SENHASEGURA_AGENT_SECONDARY: "false"

networks:
  senhasegura-network-connector:
    driver: bridge

Cluster Installation

Cluster agents port
When creating high-availability agents, ensure all agents are configured with the same SENHASEGURA_AGENT_PORT.
  • SENHASEGURA_AGENT_SECONDARY(optional): Choose true or false to enable or disable a secondary agent. Secondary agents are used when the primary agent is unavailable.
  • SENHASEGURA_ADDRESS: the IP address for your senhasegura instance, e.g. “192.168.10.20”

    Important
    Change the instance number in the SENHASEGURA_ADDRESSES line according to the number of instances in your cluster, separating each IP with a comma.

services:
  senhasegura-network-connector-agent:
    image: "registry.senhasegura.io/network-connector/agent-v2:latest"
    restart: unless-stopped
    networks:
      - senhasegura-network-connector
    environment:
      SENHASEGURA_FINGERPRINT: "CHANGE_ME"
      SENHASEGURA_AGENT_PORT: "CHANGE_ME"
      SENHASEGURA_ADDRESSES: "CHANGE_ME"
      SENHASEGURA_AGENT_SECONDARY: "false"

networks:
  senhasegura-network-connector:
    driver: bridge
  1. To complete, run the command sudo docker-compose up -d to start the Agent container.
Note

To see the Agent's execution logs, run the command sudo docker-compose logs -f.

Choosing the version of the Agent

You can easily choose which version of the Agent should be used by changing the version of the container image. To change versions, edit the docker-compose.yml file.

Following the examples above, you will have the latest version of the Agent (image: "registry.senhasegura.io/network-connector/agent-v2:latest").

To use the Agent from version 3.26, type image: "registry.senhasegura.io/network- connector/agent-v2:3.26".

To use the Agent from version 3.27, type image: "registry.senhasegura.io/network- connector/agent-v2:3.27".

Use the same "3.XX" format to install Agents from different versions.

Important

We recommend that users install Agents from the same version as the senhasegura application they currently use.


Next steps


Was this article helpful?