The main purpose of a Process Agent is to allow support for execution across multi-platforms. With the Process Agent, business and IT processes can now be automated across various operating systems. Because it is Java-based, the most common desktop operating systems are compatible, including Linux, Mac OS X, Microsoft Windows and Solaris. Similar to normal BPA Agents, the BPA Server component connects to a Process Agent via TCP/IP. Once connected, the Process Agent is used in conjunction with the Workflow Designer's Process Object in order to send commands to other operating systems within the course of a workflow.
The Process Agent is Java-based, therefore it can run on any operating system where Java 1.6 (or above) is installed. Supported operating systems are as follows:
Solaris (32-bit)/Solaris (64-bit)
MAC OS X
In order to properly create and connect to a Process Agent, the following criteria must be met:
Java 1.6 or higher must be installed on the system in which the Process Agent will run on. To install the latest version of Java, visit www.java.com.
A TCP/IP connection must be established from the system running BPA Server to the system in which the Process Agent will run on and the systems must be accessible on the network at the time of installation. BPA Server uses port 7100 as default.
A file named ProcessAgentInstaller.jar, which is an application packaged as a JAR file, must be run on the operating system that the Server will connect to. This JAR file is the actual Process Agent, thus needs to stay running in order for BPA Server to establish proper connection.
The username and password of a BPA Server Administrator is required and will be used to authenticate new Process Agent installations.
During AutoMate BPA Server component installation, a JAR file will be extracted to the Program Files directory in the AutoMate BPA Server folder. (The default location is C:\Program Files\AutoMate BPA Server, unless another location was specified during BPA Server installation). This file is named ProcessAgentInstaller.jar and packaged with the Process Agent application. This JAR file needs to run on the system in which the BPA Server will communicate with.
Copy the ProcessAgentInstaller.jar file onto the desired system. The default location in which this file can be copied from is C:\Program Files\AutoMate BPA Server.
From the Command Prompt/Command Shell of the system in which the Process Agent will be installed, specify the location of the installer followed by the following command:
java -jar ProcessAgentInstaller.jar
A Welcome to BPA Process Installation message will appear (as illustrated below). You must agree to the End-User Licence Agreement to proceed.
Upon agreeing to the End-User License Agreement, you will be prompted to enter specific information (as shown in the image below):
Enter Installation Directory - Indicates the location of the installation file. To leave it at the default location that appears, simply press ENTER.
Enter Machine Name or IP Address of BPA Server - Denotes the computer name or the IP Address of the machine where the BPA Server component is installed.
Enter BPA Server Port (Default is 7100) - Specifies the BPA Server communication port. To use the default port, simply press ENTER.
Enter Process Agent Name - Enter the desired name for the new Process Agent. The name will appear in the SMC's Process Agent section (below its corresponding Agent icon) once a connection is established.
NOTE: The name must not contain any spaces.
Enter BPA Server Username - Specifies the username of a BPA Server Administrator.
Enter BPA Server Password - Specifies the password of a BPA Server Administrator.
After entering the required information, press ENTER. The following messages should appear in sequence during the installation process - the last message confirming proper completion (as shown below):
"BPA Process Agent Initialized"
"Generating Authentication Request"
"Sending authentication to [computer name/IP Address]"
"Process Agent is connected to [computer name/IP Address]"
Also, a new icon will appear in the SMC's Process Agent section indicating a successful connection from the server to the newly installed Process Agent.
NOTE: The console window must stay open in order for the Process Agent to stay running.
During installation of a Process Agent, an executable JAR file named ProcessAgent.jar is extracted to the installation directory selected. Once installed, the ProcessAgent.jar file is used to run the Process Agent.
Open the Command Prompt/Command Shell of the Process Agent machine.
Specify the installation directory followed by the command below:
java -jar ProcessAgent.jar
For example, if the installation directory is selected is C:\ProcessAgents the command to enter (as shown in the image below) would be:
C:\ProcessAgents>java -jar ProcessAgent.jar