SAS 9.1.3 Integration Technologies » Server Administrator's Guide


Setting up a Server and Spawner
Best Practices
Quick Start: Standard Workspace Server and Spawner
Quick Start: Load-Balancing Stored Process Server and Spawner
Summary of Setup Steps
Spawner Overview
Spawner Requirements
Planning the Configuration Metadata
Security
Standard Workspace or Stored Process Server
Standard OLAP Server
Creating the Metadata Using SAS Management Console
Defining Servers
Modifying Servers
Workspace or Stored Process Server
OLAP Server
Configuring a UUID Generator
Configuring and Starting the Object Spawner on z/OS
Administering the Server and Spawner
Creating a Metadata Configuration File in SAS
Using ITConfig
Testing Server Connections
Using Telnet
Spawner Error Messages
Reference Materials
Fields for the Server Definition
Object Server Parameters
Fields for the Spawner Definition
IOM Bridge

Fields for the Spawner Definition

The spawner definition contains information for an instance of a SAS spawner (see Spawner Overview). The spawner is defined using the fields listed in the following table. For each option, the table shows the following information:

  • the name that identifies the field name in SAS Management Console. Under each field's name, the table shows the corresponding properties tab and field name in the SAS Management Console application.

  • "Required" or "Optional" to indicate whether the field is required.

  • the type of server connection for which the field is used.

    Note: Spawners are used only with servers that use an IOM Bridge connection. Therefore, IOM Bridge is listed as the connection type for each option.

  • a definition of the field.

Fields for the Spawner Definition
Field Name Required/
Optional
Connection Type Definition
Associated Machines

In SAS Management Console:
Options  arrow  Associated Machines
Optional IOM Bridge The name of the machine on which this spawner will run and listen for connection requests for the server. (The list of machine names is created from the machine names for the servers that have are already defined in a metadata repository. If the desired machine name is not listed, then you must create a server definition for this machine. For details, see Using SAS Management Console to Define Servers.)
Authentication Domain

In SAS Management Console:
<Connection>  arrow  Options arrow  Authentication Domain
Optional IOM Bridge The domain that is associated with a set of computing resources that use the same authentication process. The spawner definition must have the same authentication domain name as the server with which it connects. The spawner uses the authentication domain name, along with the machine name to determine which servers it services.
Description

In SAS Management Console:
General    Description
Optional IOM Bridge Text to summarize why this definition exists.
Encryption Key Length

In SAS Management Console:
Options  arrow  Encryption Key Length
Optional IOM Bridge A numeric value (0, 40, or 128) that specifies the encryption key length. See SAS/SECURE documentation for more information regarding this field.
Host Name

In SAS Management Console:
<Connection> arrow  Options arrow   Host Name
Required IOM Bridge The DNS name and IP address for the machine on which this spawner definition can execute. The machine name must be the official network name (for example, machine.corp.com). The string localhost can be used to signify the host on which the spawner is executing.
Log File

In SAS Management Console:
Initialization  arrow  Log File
Optional IOM Bridge A fully qualified path to the file in which spawner activity is to be logged. Paths with blank spaces must be enclosed in quotation marks. On Windows, paths with embedded blank spaces must be enclosed in double quotation marks. On z/OS, specify filenames similar to UNIX file paths due to the requirement for z/OS UNIX System Services.
Major Version Number

In SAS Management Console:
Options  arrow  Major Version Number 
Required IOM Bridge Specifies the major version number of the component.
Minor Version Number

In SAS Management Console:
Options  arrow  Minor Version Number 
Required IOM Bridge Specifies the minor version number of the component.
Name

In SAS Management Console:
General  arrow  Name
Required IOM Bridge The unique name for this spawner. When specified at spawner invocation, its value identifies which spawner definition to use.
Operator Login

In SAS Management Console:
Initialization: Operator Login arrow  Operator Login 
Required IOM Bridge The login that contains the password the spawner uses when starting a server as an operator connection. Click New to define a new login. If you do not specify a login, the operator password defaults to sasobjspawn.
Port

In SAS Management Console:
<Connection>  ->  Options ->  Port
Required IOM Bridge The port on which to connect to the spawner. If neither port nor service is specified, the service name sasobjspawn is used as the service. The type of port depends on the following values of Protocol:
Protocol=Load Balancing
Port for a load balancing connection. The default is 8571.
Protocol=UUID
Port for a UUID connection. The default is 8551.
Protocol=Operator
Port for the operator connection. The default is 8581.
Protocol

In SAS Management Console:
<Connection>  arrow  Protocol
Optional IOM Bridge The type of connection. Possible values are
Load Balancing
Connection to a load balancing port or service.
UUID
Connection to a UUID port or service.
Operator
Connection to the operator port or service.
Servers

In SAS Management Console:
Servers
Required IOM Bridge The list of servers that this spawner is permitted to start. (The servers that are listed have been defined to run on the same host as the spawner.) Select the servers you want this spawner to start. Click New to define a new server that runs on the same host as the spawner.
Service

In SAS Management Console:
<Connection>  arrow  Advanced Options  arrow  Service
Optional IOM Bridge The service in which to connect to the spawner. If neither port nor service is specified, the service name sasobjspawn is used as the service. The type of service depends on the following values of Protocol.
Protocol=Load Balancing
Service is the load balancing service.
Protocol=UUID
Service is the UUID service.
Protocol=Operator
Service is the operator service.
Software Version

In SAS Management Console:
Options  arrow  Software Version 
Required IOM Bridge Specifies the version of the spawner software.
Verbose

In SAS Management Console:
Initialization  arrow  Verbose
Optional IOM Bridge When selected, this value causes the spawner to record more details in the log file (LogFile or slf).