Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Corrected links that should have been relative instead of absolute.

SecureBridge Agent can only be installed on both Microsoft Windows and Linux operating systemsystems. This page discusses all these the prerequisites and system requirements in detail and help you setup the required environment and seamlessly install SecureBridge Agent within your production and the non-production environment. 

See the 1771030 to The details herein help you learn how to install the SecureBridge Agent. You may want to verify if you meet the the system requirements before began  before you begin to install the product using this installation guide.

This section contains the following information:

Table of Contents

Anchor
Prerequisites
Prerequisites
Prerequisites

  1. Ensure that you must the have administrator rights for the system where SecureBridge on which the SecureBridge Agent will be installed.
  2. Ensure that the following default ports are available for communication.
    • Kernel Port: 21000
    • HTTP Port: 8080
    • HTTPS Port: 8443
    • RMI Port: 1098

    Tip
    In case you want to change the default ports, you can change them in pre-configruration.properties file available in the zip file. Click here for more details.


  3. Ensure that the Installation directory is C:\Program Files\SecureBridge.

Anchor
System requirements
System requirements
System requirements

You need to fulfill prerequisites, including supported operating system and hardware requirements, to install and use SecureBridge Agent effectively. 

Operating system

Secure Bridge SecureBridge can be installed on the following operating systems:

Operating System

Version

Windows

2008 or later*

Linux

Red Hat 6.0 or later


CentOS 6 or later

* Windows Server 2019 is not supported.

Hardware requirements

Hardware

Minimum Requirementrequirement

Recommended Configurationconfiguration*

Processor

2.4 GHz 2 Core Processor

2.4 GHz 4 Core Processor

RAM

8 GB

16 GB

Hard Disk

150 GB

500 GB

...

  • Number of services running on a node,.
  • The complexity of the services deployed on the node, and.
  • CPU requirement for running these services.

The expected data flow and system performance also determine the RAM and hard disk requirement. Therefore, these requirements may vary for the production environment and the user is advised to refer to the recommended configuration.

Anchor
deployment architecture
deployment architecture
Deployment architecture

Following The following image describes depicts the high-level architecture of SecureBridge and its communication with the Agent.


Installation process

The SecureBridge Agent can be installed on both Windows and Linux. You can also install the Agent on Windows using the Command Line Interface (CLI). This section contains the following information:

Anchor
Installing on Windows
Installing on Windows
Installing on Windows

This section assists you on how to install SecureBridge Agent on a Windows -based operating system. Before you start installing, refer to Installation Architecture and System Requirementsto the deployment architecture and system requirements.

  1. Unzip the zip file. The format of the zip file is: SecureBridge_Agent_<version>_<Date>_<OS>_<Architecture>.zip.

    For example, SecureBridge_Agent_6_9_9_24Sep2020_Win_x64.zip.



  2. Double-click install.exe. The InstallAnywhere pop-up appears preparing to install.

    Image Modified

  3. On the Agent Details screen, enter the Agent details as explained below.

    Note
    • This screen appears only when the value for the agent properties are not defined in pre-configruration.properties file available in the installer zip file.

    • When you are defining the agent properties in pre-configruration.properties file, ensure that you have defined either all or none of them.




    Enter the details in the fields as per the description given in the table below:

    FieldsDescription
    Agent IdUnique Id of the agent.
    Agent LocationThe location where the agent is installed.
    Hub URLURL of the Hub.
    User NameHub user name.
    PasswordHub password.


  4. Click Next



  5. On the Pre-Installation Summary screen, click Install.



  6. On the Installation Complete screen, click Done to exit from the installation wizard.



    The installation of SecureBridge Agent is now complete. 

    Info

    The default credentials to log in to SecureBridge Agent are:

    User Id: admin
    Password: indigo1


Anchor

...

Before you begin to install the SecureBridge Agent, you can configure the following properties in pre-configuration.properties file. This file lies in the installer zip folder. 

...

Installing from Windows CLI

...

Installing from Windows CLI
Installing from Windows CLI
Installing on Windows using Command Line Interface (CLI)

This section guides you on how to install the SecureBridge Agent from the Windows CLI of these two operating systems.

Before you begin to install, ensure :

  • Ensure that you have disabled the User Account Control in Windows.

...

Follow the steps below to complete the installation:

  1. Unzip the zip file. The format of the zip file is: SecureBridge_Agent_<version>_<Date>_<OS>_<Architecture>.zip.

    For example, SecureBridge_Agent_6_9_9_24Sep2020_Win_x64.zip.
    Image Removed

  2. Open command prompt and Go and then go to the directory where you have extracted the zip file.
  3. Type the command install.exe -i console.
  4. Pass the following arguments to the install.exe command
    -DAgentID
    -DAgentLocation
    -DHubURL
    -DAgentManagerUser
    -DAgentManagerPassword

    Anchor
    Argument table
    Argument table
    Where,

    ArgumentsDescription
    -DAgentIDUnique Id of the agent.
    -DAgentLocationThe location where the agent is installed.
    -DHubURLURL of the Hub.
    -DAgentManagerUserHub user name.
    -DAgentManagerPasswordHub password.


    For example, install.exe -i console -DAgentID=

    "Agent01"

    <Unique Id of the agent> -DAgentLocation=

    "California"

    <agent location> -DHubURL=

    "https://acm.adeptia.com"

    <Hub URL> -DAgentManagerUser=

    "admin" -DAgentManagerPassword="indigo1".
    image2020-10-28_16-41-41.pngImage Removed

    <Hub user name> -DAgentManagerPassword=<Hub Password>

    image2020-10-28_16-41-41.pngImage Added

    Note
    • If you have already defined any of the agent properties in pre-configuration.properties file, you do not need to provide that argument again in the installation command.
    • The value for the agent properties defined in the pre-configuration.properties file are overridden by the value given for those properties as a command line argument.


  5. Press Enter.
    This starts the installation process to install SecureBridge Agent on your system.

    Image Added
  6. Once the installation is complete, press Enter to exit from the Installer Installation wizard closes automatically.

Anchor
Installing on Linux
Installing on Linux
Installing on Linux

This section guides you on how to install the SecureBridge Agent in Linux environment. Before you start installing, refer to Installation Architecture and System Requirementsdeployment architecture and system requirements.

Follow the steps below to complete the installation:

  1. Unzip the zip file. The format of the zip file is: SecureBridge_Agent_<version>_<Date>_<OS>_<Architecture>.zip.

    For example, SecureBridge_Agent_6_9_9_24Sep2020_Win_x64.zip.
    Image Removed
     
  2. Open command prompt and Go to the Terminal and then go to the directory where you have extracted the zip file.
  3. Type the command chmod +x install.bin to get the execution permission on installer file.
  4. Type the command ./install.exebin.
  5. Pass the following arguments to the ./install.

    exe command

    bin command:
    -DAgentID
    -DAgentLocation
    -DHubURL
    -DAgentManagerUser
    -DAgentManagerPassword

    For example, ./install.

    exe -i console

    bin -DAgentID=

    "Agent01"

    <Unique Id of the agent> -DAgentLocation=

    "California"

    <agent location> -DHubURL=

    "https://acm.adeptia.com"

    <Hub URL> -DAgentManagerUser=

    "admin" -DAgentManagerPassword="indigo1".
    image2020-10-28_16-41-41.pngImage Removed

    <Hub user name> -DAgentManagerPassword=<Hub Password>.

    Note
    Click here to know more about the arguments' possible values.


    Note
    • If you have already defined any of the agent properties in pre-configuration.properties file, you do not need to provide that argument again in the installation command.
    • The value for the agent properties defined in the pre-configuration.properties file are overridden by the value given for those properties as a command line argument.


  6. Press Enter.
    This starts the installation process to install SecureBridge Agent on your system.

    Image Added
  7. Once the installation is complete, the Installation wizard closes automatically.

After the installation is complete

...

, you need to perform the following steps to start the SecureBridge Agent.

  1. Open the Terminal.
  2. Go to the directory ...<SecureBridgeInstallFolder>/AdeptiaServer/ServerKernel.
  3. Type ./startup.sh to start.
Tip
If you want to stop the SecureBridge Agent, type ./stop.sh


Anchor
Configuring pre-configruration.properties file
Configuring pre-configruration.properties file
Configuring pre-configruration.properties file

Before you begin to install the SecureBridge Agent, you can configure the following properties in pre-configuration.properties file. This file lies in the installer zip folder. 

  • Install Folder: 

    Image Added

  • Configure Mail
  • Configure Kernel and Web Server
  • Configure Auto Startup
  • Configure Agent
  • Configure Launch Now