System Requirements
OS / Memory / Cores
Type |
Minimum requirement |
Preferred for initial production fase |
OS |
|
|
Memory |
4 GB |
8 GB |
Number of Cores |
1 |
2 |
Internet |
Required for license checks |
Required for license checks |
Software
Software |
Version |
Java JDK |
Adopt OpenJDK 11.0.10 |
ConnectAgent |
4.0.6 |
With with Adopt OpenJDK version 1.8, we have encountered problems with, at least, Windows 2016 server. The Java version mentioned above, will work. Later versions of the JDK may return JNA (Java Native Access) errors.
Firewall settings
ConnectAgent and ConnectPlaza are connected via the internet to each other. Therefore you will pass, in most cases, one or more firewalls.
ConnectPlaza and the ConnectAgent use the following URLs:
URL |
Description |
https://www.connectplaza.com |
Main site for ConnectPlaza |
update.connectplaza.com |
Here the ConnectAgent can find its updates. It is primary an FTP Server. |
backend.connectplaza.com |
This address is used by de ConnectAgent to check its license. This applies only to ConnectAgents which do not use the reverse gateway. |
https://rhttp.connectplaza.com |
Connectplaza Reverse Gateway (DEPRICATED) |
https://rsocket.connectplaza.com IP: 193.202.23.248 |
ConnectPlaza RSOCKET Gateway |
ConnectAgent will use the following default ports:
Port number |
Description |
80 |
Default HTTP port |
443 |
Default HTTPS port |
External IP address of agent |
NON RHTTP ConnectAgents only (see below) |
If you do not use the RSOCKET or RHTTP connection to ConnectPlaza, please be certain that you have authorized the external IP and port in your firewall for inbound and outbound traffic. The Deploy application cannot connect to your agent and you cannot deploy your interfaces as traffic is blocked by your firewall. Also the ConnectAgents license check cannot be performed and therefore your ConnectAgent will not start.
Port 80 and 443 need to be open for inbound / outbound traffic always.
Using NAT
If you are using NAT, you will probably have no problem contacting the ConnectPlaza environment. If you are not using the RHTTP or RSOCKET connection, the only connection you have to verify is the connection from deploy to your ConnectAgents machine. Check if the inbound and outbound traffic from the ConnectPlaza site via your external IP Address / Port is allowed.
Downloading the software
Before you can begin installation, you have to download the required software.
Java JDK
Download the OpenJDK version 11 from Adopt. You can download the the solfware at the vendors specific site.
If you are installing via the Windows installer, a working Java version is packaged with the installer. Use this version to be sure you have not problems with other installed java versions.
ConnectAgent
Your ConnectAgent can be downloaded from the Deploy website. Here you can preconfigure you ConnectAgent and download it with a preconfigured configuration to ease your installation. To download the agent follow the next steps.
-
Login at the ConnectPlaza website with a Developer or End User account
-
If you login with a Developer account, choose the Deploy application. You will enter a selection screen where you can select the agent you want to install.
- Double click on the agent you want to install. Wait until the application is finished trying to connect to the agent. This is default behaviour. It will probably not find any agent. You will end up with the next screen.
-
Download the ConnectAgent of your choice
- If you choose a Generate prebuild zip, you must enter the configuration for your ConnectAgent. For the Windows Installer this will be done during the install procedure itself.
-
Fill in your preferred settings (RHTTP)
Field name |
Description |
Use socket connection |
This is the preferred setting as of version 4.0. |
Use reverse connect |
Check this if you want to connect to the RHTTP connector. This setting will be deprecated in the future. |
Internal IP Address |
Your internal IP address or Hostname. This is the name or IP address how the machine is recognized in your internal network. |
Agent HTTP port |
Port for internal HTTP traffic. Default 8088 |
Agent HTTPS port |
Port for internal HTTPS traffic. Default 8443 |
Agent license key |
Your ConnectAgent license key. The key is generated by the system and you cannot modify it. |
Analyze Database Parameters |
If you have an Analyze license, you can select a preset analyze database here. The following options are available:
Remember that the needed JDBC Drivers are not always included in the system. Add the needed .jar files to the connectplaza-agent\jars\endorsed directory. Restart after implementing the correct interface. |
-
Push the
button to generate the ConnectAgent and save it to your machine. De default filename is agent.zip.