RPC Server Defaults

#### Search Results

Search

# RPC Server Defaults

The Entire Operations GUI Client uses an RPC server. Some definitions for the RPC server can be made here.

This document covers the following topics:

- Defining RPC Server Defaults for SSL Communication

- Usage of SSL TRUST_STORE

- Further RPC Server Considerations

## Defining RPC Server Defaults for SSL Communication

To define the SSL trust store file

1. From the System Services Menu, select the RPC Server Defaults option and press ENTER.

   An RPC Server Defaults screen like the example below appears:

        18-07-11                ***** Entire Operations *****                09:57:35
                                     RPC Server Defaults
        ------------------------------------------------------------------------------

        SSL TRUST_STORE
        /test/ogc-test/keyfile.pemSAGxxx______________________________________________
        (required if RPC communication shall use SSL)

        Command =>

       Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
             Help        End         Save

2. Enter the name of the file that contains the valid SSL key. See also Usage of SSL TRUST_STORE.

3. Choose PF5 (Save) to save the entry.

## Usage of SSL TRUST_STORE

The SSL TRUST_STORE field definition is required if the RPC communication uses SSL.

If the RPC server and EntireX Broker should communicate via SSL, an SSL parameter string must be committed during the startup of EntireX Broker. This string is located within the SSL TRUST_STORE and contains a valid SSL key. For this purpose, the Natural program NOPSSL1P in the library SYSEOR is executed during the startup of the RPC server.

The following description assumes that EntireX Broker and the RPC server are installed in a UNIX environment.

- For a general description of the Natural RPC server with SSL, refer to the section Using Secure Socket Layer in the Natural RPC (Remote Procedure Call) documentation.

- You must define SSL certificates, e.g., with openssl. Refer to the section SSL or TLS and Certificates with EntireX in the webMethods EntireX documentation.

- Invoke the RPC Server Defaults and define the SSL TRUST_STORE file.

- The Natural profile parameter `SRVNODE` (on mainframes, the keyword subparameter `SRVNODE` of the profile parameter `RPC`) must contain the string `:SSL`, or it must start with `//SSL:`

- During the startup of the Entire Operations GUI Client RPC server, the Natural program NOPSSL1P must be executed. This module creates and sets the SSL parameter string.

  Example for an Entire Operations GUI Client server startup in a shell script:

      natural parm=nopparm mainpr=10 \
      server=on trace=0 \
      srvname=NOP51S11 "srvnode=pcsn2:1958:SSL" \
      "stack=(logon syseor;nopsls-p;nopssl1p" \
      >/dev/null /null &

- In Entire Operations GUI Client, make sure that the EntireX Broker service is invoked correctly. Nothing else special is to be done to use SSL communication.

## Further RPC Server Considerations

To make sure that the correct Natural steplibs are being set in the RPC server, it is recommended to execute the Natural program NOPSLS-P during RPC server startup.

Note
For further information, refer to Natural Steplibs in the Installation and Setup documentation.

If Natural Security is installed on the server and the server library SYSSAT is protected, the Entire Operations GUI Client user must be linked to the library SYSSAT or the user must be a member of a group which possesses a link to SYSSAT.

### On this page

- Defining RPC Server Defaults for SSL Communication
- Usage of SSL TRUST_STORE
- Further RPC Server Considerations