Normally there is a one-to-one connection from each Host running as an OPC UA Server to a specific SECS/GEM process tool. This allows your OPC UA Client to interact with that process tool through the TransSECS OPCUA Server's SECS/GEM host. Nevertheless there are applications for which you would want a single OPC UA Client to have access to the data in multiple process tools. This essentially acts as a single fab host connected to multiple tools, but each host connected tool has its own name-space within the TransSECS OPC UA Server.

To prepare to run the combined OPC UA Server, you will need the OPCUAServerRunner.zip add-on package, which contains:

This zip will be used later on in these instructions.

Each process tool will need its own TransSECS host project. Start by copying the default GEMHost project from the installation Projects directory to a work directory. This project work directory should be outside of the installer structure and in a simple directory, such as your User home directory. Make a directory there called TransSECSProjects, or something similar. It is recommended for the best results that the directory path has no spaces in it. Give this copied GEMHost project a unique name, such as Tool1Host, or GEMHostA, or some other simple name. Do the same for the number of tools you will be connecting to in this OPC UA server.

An example directory structure for three tool connection might be:

Load the first host project into the TransSECS Builder. Rename the tool name “GEMHost” so that it matches the project name. For example, rename the tool for first project loaded as GEMHostA to “GEMHostA”. Remove the default VIDs,CEIDs,and RPTIDs (if any) by right clicking on each node and using Delete. Next right click on the Project Name (GEMHost) and add VIDs, and also add CEIDs. These two nodes will be empty.

Change the connection parameters (hostname/IP Address, HSMS Port and Device ID) so each Host will connect to its tool. For the purpose of this example and for testing, the hostname will be left as “localhost” but the ports used are all different, such as 5010,5020, and 5030.

Be sure that OPCUA Server is selected as the deployment type, and press the build button (Hammer/Star button) to build the code and put TransSECS into “run” mode. After building the code, the old “GEMHost.tsx” project file will remain in the directory. This can be deleted now, but this is not necessary.

After the host is built, press the LIVE button (toggle from SIM). The host should connect to tool, you will see S1F13 message sent from the host and an S1F14 reply from the tool, also the same for S1F17 and its S1F18 reply. If the host does not connect, solve this problem before proceeding. Make sure the tool is running and using the communication parameters set before the build.

Close this first project and load the next host project. Repeat building and connection testing for your other tools.

The next step is to get the VIDs and CEIDs from the process tool so they can be used in the host project. Start with one of the GEMHost projects from the previous step. Build the project (hammer/star button) and go to LIVE mode. Right click on the empty VID node and select “Online VIDs From Tool”.

The VIDs from the tool will populate the VIDs node.

Do the same for the empty CEIDs node. Build the project one last time now that the VIDs and CEIDs are loaded. Repeat the VID and CEID characterization for each tool with its own GEMHost project.

When the code was built for each GEMHost in the previous stage, each GEMHost was built into its own OPC UA Server. In this stage of the setup all of the GEMHosts codes will be combined so that they are running in a single OPC UA Server.

Extract the files from the OPCUAServerRunner zip into the root of the directory where the multiple GEMHost projects reside.

Open the file “OPCServersList.properties” in a text editor such as WordPad or Notepad++.

The left hand column will be the node name in the combined OPC UA Sever for the project listed on the right side. For example, the first line says “HostA=GEMHostA” which means the node name in the server will be HostA for the TransSECS project GEMHostA. The directory “GEMHostA” must exist and have a built OPC UA Server project in it.

Use the runall.bat file to run the OPC UA Server. This can also be run on Linux systems (convert the contents of the runall.bat file to a shell script or contact ErgoTech for assistance).

When you first run the server, if built with non-trial software, you will see a popup with a pre-license code unique to your system. This pre-license code will also be printed in the SECSMessages.log file. Please copy this code into an email and send this to ErgoTech so that we can send you an IOT runtime license for your system.

Place the IOT license into this directory and restart the OPC UA Server with the runall.bat file.

When you start the OPC UA Server you will see the two new directories created: security and certificates. These will be used later when your OPC UA client attaches.

For testing we use the UAExpert client. Connect your client to the OPC UA Server using the endpont URL

"opc.tcp://localhost:12686/MIXOPCServer"

any security policy that you prefer. When you first connect you will need to trust the server certificate so that the client can send its certificate to the server.

The next step is to “trust” the client's certificate for the OPC UA Server. You will find the client's certificate in the directory “security/security/pki/rejected” under the directory where you are running the server:

Movethis certificate to the “security/security/pki/trusted/certs” directory:

Once this certificate is moved to the trusted store for the server, you will be able to connect to the server with your client and see the server tree with the nodes hosta, hostb, and hostc (the names set up in the OPCServersList.properties file).