SecureBridge Agent can only be installed on Microsoft Windows operating system. This page discusses all these 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 learn how to install SecureBridge Agent. You may want to verify if you meet the 1771030 before began to install the product using this installation guide.
This section contains the following information:
Prerequisites
- Ensure that you must have administrator rights for the system where SecureBridge Agent will be installed.
- Ensure that the following default ports are available for communication.
- Kernel Port: 21000
- HTTP Port: 8080
- HTTPS Port: 8443
- RMI Port: 1098
In case you want to change the default ports, you can change them in pre-configruration.properties file available in the zip file. Click 1771030 for more details. - Ensure that the Installation directory is C:\Program Files\SecureBridge.
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 can be installed on the following operating systems:
Operating System | Version |
Windows | 2008 or later* |
* Windows Server 2019 is not supported.
Hardware requirements
Hardware | Minimum Requirement | Recommended Configuration* |
Processor | 2.4 GHz 2 Core Processor | 2.4 GHz 4 Core Processor |
RAM | 8 GB | 16 GB |
Hard Disk | 150 GB | 500 GB |
*Actual RAM and hard disk space required for running SecureBridge Agent depend on many factors:
- 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.
Deployment architecture
Following image describes the high-level architecture of SecureBridge and its communication with the Agent.
Installation process
Installing on Windows
This section assists you how to install SecureBridge Agent on a Windows-based operating system. Before you start installing, refer to Installation Architecture and System Requirements.
- 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.
- Double-click install.exe. The InstallAnywhere pop-up appears preparing to install.
On the Agent Details screen, enter the Agent details as explained below.
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.
Enter the details in the fields as per the description given in the table below:Fields Description Agent Id Unique Id of the agent. Agent Location The location where the agent is installed. Hub URL URL of the Hub. User Name Hub user name. Password Hub password. - Click Next.
- On the Pre-Installation Summary screen, click Install.
On the Installation Complete screen, click Done to exit from the installation wizard.
The installation of SecureBridge Agent is now complete.The default credentials to log in to SecureBridge Agent are:
User Id: admin
Password: indigo1
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:
- Configure Mail
- Configure Kernel and Web Server
- Configure Auto Startup
- Configure Agent
- Configure Launch Now
Installing from Windows CLI
The SecureBridge Agent can also be installed from the command line interface (CLI) of Windows and Linux. This section guides you on how to install the SecureBridge Agent from the CLI of these two operating systems.
Before you begin to install, ensure that you have disabled the User Account Control in Windows. Rest of the system prerequisites and system requirements remain the same as discussed earlier in this document.
Follow the steps below to complete the installation:
- 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. - Open command prompt and Go to the directory where you have extracted the zip file.
- Type the command install.exe.
- Pass the following arguments to the install.exe command
-DAgentID
-DAgentLocation
-DHubURL
-DAgentManagerUser
-DAgentManagerPassword
For example, install.exe -i console -DAgentID="Agent01" -DAgentLocation="California" -DHubURL="https://acm.adeptia.com" -DAgentManagerUser="admin" -DAgentManagerPassword="indigo1".
- Press Enter.
- Once the installation is complete, press Enter to exit from the Installer wizard.
Installing on Linux
The SecureBridge Agent can also be installed from the command line interface (CLI) of Windows and Linux. This section guides you on how to install the SecureBridge Agent from the CLI of these two operating systems.
Before you begin to install, ensure that you have disabled the User Account Control in Windows. Rest of the system prerequisites and system requirements remain the same as discussed earlier in this document.
Follow the steps below to complete the installation:
- 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.
- Open command prompt and Go to the directory where you have extracted the zip file.
- Type the command install.exe.
- Pass the following arguments to the install.exe command
-DAgentID
-DAgentLocation
-DHubURL
-DAgentManagerUser
-DAgentManagerPassword
For example, install.exe -i console -DAgentID="Agent01" -DAgentLocation="California" -DHubURL="https://acm.adeptia.com" -DAgentManagerUser="admin" -DAgentManagerPassword="indigo1". - Press Enter.
- Once the installation is complete, press Enter to exit from the Installer wizard.