About the Server Invocation Process

This section discusses the invocation processes of the SAS Visual Process Orchestration Design Server and Runtime Server.
The Design Server is invoked by its local SAS Object Spawner, as configured during deployment. The SAS Object Spawner starts, connects to the SAS Metadata Server, and retrieves its own configuration information. The SAS Object Spawner then begins listening on the port that is assigned to the Design Server. When a request arrives for the Design Server from a SAS client, the SAS Object Spawner starts an instance of the Design Server.
When the Runtime Server starts, it retrieves its server properties from the SAS Metadata Server. To contact the SAS Metadata Server, the Runtime Server refers to the configuration option BASE/AUTH_SERVER_LOC (in app.cfg). The value of this option is specified during deployment. The value specifies the network name and port of the SAS Metadata Server, as shown in this typical example:
base/auth_server_loc=iom://Orion.us.southeast.omr.com:8561
To retrieve its server properties, the Runtime Server queries its own metadata definition. To access this definition, the Runtime Server use the value of the configuration option DMSERVER/NAME (in dmserver.cfg). If this option is not defined, then all of the configuration options that would normally be defined in metadata need to be defined in Runtime Server configuration files.
The following table identifies the configuration values that are returned from the SAS Metadata Server. The options that begin with BASE are all optional.
Note: The retrieved options that begin with DMSERVER are required. If they cannot be retrieved, or if they are not defined locally, then the Runtime Server does not start.
Configuration Option
Description
BASE/APP_CONTAINER_DOMAIN
Specifies the authentication domain that is expected by the application container services.
BASE/AUTH_DEFAULT_DOMAIN
Specifies a default domain in cases where a user ID applies to multiple logins. To learn how this value is used, refer to the material that follows this table.
DMSERVER/SOAP/LISTEN_HOST
Specifies the port number used by the Runtime Server.
DMSERVER/SOAP/LISTEN_PORT
Specifies the port number of the SOAP server that is managed by the Runtime Server. The default port number is 21056
DMSERVER/SECURE
Specifies that security is enabled or disabled on the Runtime Server.
DMSERVER/SSL
Specifies that SSL security is enabled or disabled on the Runtime Server.
The configuration option BASE/DEFAULT_AUTH_DOMAIN contributes to the authentication process as follows:
  1. The value of the BASE/AUTH_DEFAULT_DOMAIN option is presented for authentication if the value matches the domain of one of the logins that is registered in metadata for the user. If a value is not specified, or no match is found, continue to 2.
  2. Use as the domain the value DefaultAuth. If the DefaultAuth domain matches the domain in one of the user’s logins, then it is used as the presented credential authentication domain. If no match is found, continue to 3.
  3. Use the first matching login.