Install and set up the Secure SOA Server

If you need access to web services on computers outside of the area control network (ACN), both the DeltaV system and the external system must be in domains, not workgroups. The SOA web services do not support workgroup-to-workgroup communication. You must install the web services software on a computer in the external domain to create a Secure SOA Server. 

The prerequisites for installing the Secure SOA Server are:

  • Set up the SOA Gateway in the DeltaV ACN as explained above.

  • If you are using a firewall between the domains, make sure it has been configured correctly. 

  • Configure a two-way domain trust between the DeltaV domain system and the external domain. 

  • Configure the domain name system (DNS) for both domains.

To install the Secure SOA Server software in the external domain:

  1. Run the setup.exe program on the DeltaV installation disk #4 in the DV_Extras\Secure SOA Server folder.

    A progress dialog appears, then after a few moments the DeltaV External Gateway - InstallShield Wizard dialog appears.

  2. In the Receiver field enter the fully-qualified domain name of the SOA Gateway configured within the DeltaV network. 

    This is the domain that contains the DeltaV application station configured as the SOA Gateway in DeltaV Explorer. For example:

    AppStation1.MyDeltaVDomain

  3. Enter the port number the SOA Gateway (the application station) uses for the service EmersonProcess.Web.Services.MonitorHost.exe. 
  4. Click Next.

    A dialog appears in which you select and verify an installation path for the web service software.

  5. Click Next.

    A dialog appears that summarizes the installation settings you have made.

  6. Click Next.

    Installing the Secure SOA Server creates the Windows user account DeltaVAdmin. A dialog appears in which you can change the password of this account. This is the account used by the Gateway web services. You can change this password or accept the default password.

  7. Click Next.

    The setup continues until the InstallShield Wizard Complete dialog appears. 

  8. Click Finish.

The following services are installed on the Secure SOA Server:

  • Campaign Manager Web Service

  • Recipe Exchange Web Service

  • Monitor Service

You can verify their existence from the Windows Task Manager or the Windows Services application. You can view service logs from the DeltaV SOA Gateway Administration application. 

After the Monitor Service is activated, the other web services attempt to start using their default port numbers. If the default ports are already in use, the services do not start. The Windows Event Viewer contains information on whether the services started or not. For information on resolving port conflicts refer to the topic Troubleshooting SOA Web Services.

Note

SOA web service client programs in the external domain must point to the Secure SOA Server, not the SOA Gateway within the DeltaV system domain.