Installing the prebuild .zip file
Installing the ConnectAgent with the prebuild .zip file
- This installation has to be performed by the local Administrator.
- Check that a correct Java JDK is installed and available.
- Check that Powershell is installed and available.
Register a new connectAgent (end user license) at the ConnectPlaza website. Go to Deploy and generate a new ConnectAgent. Remember to use different portnumbers for internal port number (HTTP) and external port number (HTTPS). I.E. if you have used the numbers 8088 and 8443 in a previous install, do not use those numbers again. (see Agent generator in Deploy)
Check your firewall setting at your local machine, and if you are not using the ConnectPlaza Reverse Gateway check your main firewall as well.
You can perform a test with telnet to check if your machine is accessible from the outside. Start telnet on a separate machine, outside your network and try to connect to the machine and port number. See example below.
C:\> <your domain name> 80
If you get a blank screen, you can connect to your server at the selected port. No errors should appear
- Download the agent.zip file from ConnectPlaza and put is somewere on your machine. If you have a ConnectPlaza Analyze license, set the correct parameters in this generator box.
- Copy the agent.zip to the installation directory. We use c:\wrk for example to install our agent. If you have more than one agent running on the machine, select or create a directory.
- Unzip the agent.zip file. You will end up with a connectplaza-agent directory
Installing the connectAgent as a Windows service
If you have unpacked the ConnectAgent, you are able to install the ConnectAgent as a Windows service. To install the connectAgentUpdater service run the script below with the option Run as administrator. You can find the script in the directory <ConnectPlaza Install Directory>\bat
Or open a command window as an administrator, and run the command via this window. The following result should be on your screen:
The service has been created. You can see this in your system services overview.
Starting / Stopping the connectAgent
You can start the ConnectAgent via a command box or via the Windows Services application
Starting / Stopping with the runAgent.bat script
Starting the ConnectAgent via a script is ideal for testing purposes. Start the ConnectAgent with the following command via a command box. Be sure you have started the command box to Run as administrator.
C:\> cd <ConnectPlaza Install Directory>\bat C:\> runAgent.bat
When the connectAgent is started you will see
at the last lines on your screen.
Stopping the agent will be done by pressing <ctrl/c>
Press Y to termintate the batch job. If you started the agent by double clicking the runAgent.bat program, the command window will close automatically
Starting / stopping the connectAgentUpdater service
Open the services window. You can do this by selecting the Windows button once! The windows menu appears.
Start typing the word Services.While typing Windows tries to solve the name of the application you want to run.
Select the services app, the application will now start.
You can start / stop and restart the ConnectPlaza Agent Updater from here.
It can take a while for the agent to start up. Check in the log files at <ConnectPlaza Install Directory>\logs\connectplaza-agent.log, if the agent is fully started.
Uninstalling the connectAgent service
Uninstalling the agent is very simple. Follow the next steps to uninstall the ConnectAgent Service. Run the commands as Administrator
- Go to the directory <ConnectPlaza Install Directory>\bat
- Stop the ConnectAgent. This can be done via the Windows Services application.
Or you can run the script file stopAgentService.bat
- Uninstall the ConnectPlaza service with the command: uninstallAgentService.bat
Installing multiple connectAgent on a single server
Installing multiple ConnectAgents on a single server is possible, but requires some post configuration by the installer before starting the ConnectAgent. Mainly because port number will overlap. After all port numbers have been modified, we have to add a new service for Windows.
Installing the second ConnectAgent
Register a new end-user and download the agent.zip file. Place the agent.zip file in a predefined directory where you can unzip the agent.zip file.
For instance, we place the file in the predefined directory C:\wrk\agent2\connectplaza-agent.
Modifying the configuration files
There are a few configuration files we have to edit. Mainly because the port numbers will overlap and the ConnectAgent will not start because there will be binding errors because of it. To solve this issue we will modify the following configuration files.
Uncomment this line and change the port number
wrapper.console.title=ConnectPlaza Agent updater
Change the console title
Change the service name
wrapper.ntservice.description=ConnectPlaza Agent Updater
Change the description
wrapper.ntservice.displayname=ConnectPlaza Agent updater
Change the display name (optional)
Starting the second ConnectAgent as a service
- Check if you have made the changes in the wrapper.conf file, as described in above chapter.
- Run the installAgentAsService.bat script as an administrator
- Check in the services app if your service has been added to the services list
Starting the second agent
Start the second ConnectAgent by starting the service as described above.
Problem starting the service
When you installed the windows service you can get an Error 1053 at startup. This is because the Java executable cannot be found on your system. Check this by running the following command in a command box.
c:\>java -version java version "1.8.0_251" Java(TM) SE Runtime Environment (build 1.8.0_251-b08) Java HotSpot(TM) 64-Bit Server VM (build 25.251-b08, mixed mode)
If you do not get a response like this, add the path to the java executable to your wrapper.conf file.
- Open the <ConnectPlaza Install Directory>\myesb-connect-wrapper\yajsw\conf\wrapper.conf and search for the entry wrapper.java.command = java. Instead of java, use the full path to your java.exe executable. I.E. "C:\\Program Files\\Java\\jdk1.8.0_251\\bin\\java.exe"
If you have spaces in your path name, use quotes around the path!
- Uninstall the service, wait until the service is removed from the list and reinstall the service.
- Start the service again.
Getting the status of the ConnectAgent service
You can check the status of the ConnectAgent running the following command via a command box.
- Open an command screen as an administrator
- Go to the <ConnectPlaza install directory>\bat directory
- Execute the command:
Microsoft Windows [Version 10.0.14393] (c) 2016 Microsoft Corporation. All rights reserved. C:\wrk\agent\connectplaza-agent\bat>queryService.bat ********************************************************************************** * This script will perform a query on the connectAgentUpdater service and return * * information if the service has been installed, if it is running and the * * way the service has been configured to run. * ********************************************************************************** java full version "1.8.0_251-b08" "java" -Xmx30m -Dwrapper_home="C:\wrk\agent\connectplaza-agent\myesb-connect-wrapper\yajsw\bat\/.." -Djna_tmpdir="C:\wrk\agent\connectplaza-agent\myesb-connect-wrapper\yajsw\bat\/../tmp" -Djava.net.preferIPv4Stack=true -jar "C:\wrk\agent\connectplaza-agent\myesb-connect-wrapper\yajsw\bat\/../wrapper.jar" -q "C:\wrk\agent\connectplaza-agent\myesb-connect-wrapper\yajsw\bat\/../conf/wrapper.conf" YAJSW: yajsw-stable-12.14 OS : Windows Server 2016/10.0/amd64 JVM : Oracle Corporation/1.8.0_251/C:\Program Files\Java\jre1.8.0_251/64 Name : connectAgentUpdater Installed : true Running : false Interactive : false Automatic : true Manual : false Disabled : false Paused : false Unknown : false
Running the ConnectAgent as a Service
When you are running the ConnectAgent via the Windows Services the installation will install the service with a specific user, the Local System Account.
You can change this user for this service, but keep in mind that if ConnectPlaza needs to update this service, your settings will be reset to the default settings.
When this happens, you can may lead to problems with your used Windows Shares or other parts of your OS where you need the specific user rights to connect to these parts of your system. So keep this in mind when you change these settings that the user settings are correct for all installed interfaces on this Agent.