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

Using SAS Management Console to Define or Modify a Spawner (IOM Bridge)

The Server Manager plug-in to SAS Management Console provides a graphical user interface that allows you to create or modify a definition for a server that uses an IOM Bridge connection. For details about using SAS Management Console, from the SAS Management Console menu bar, select Help arrow Help on SAS Management Console. For more information about the fields in the New Server Wizard, click Help from within the wizard.

Before you begin defining spawners, you must have the following:

For further information about launching the object spawner, see Invoking (Starting) the Spawner.

To use SAS Management Console to define a spawner that starts a server with an IOM Bridge connection:

  1. Start SAS Management Console and connect to a metadata repository.

  2. From the SAS Management Console navigation tree, select the Server Manager, and then select Actions arrow New Server from the menu bar. The New Server Wizard displays. A list of SAS Application Server resource templates is displayed.

  3. Select the Object Spawner (located under Spawners). Click Next.

  4. Enter the Name and Description. Click Next.
  5. Verify that the Minor Version Number, Major Version Number, and the Software Version are correct.

    Specify the key length (Encryption Key Length).

    In the Associated Machine drop-down list, select the name of the machine on which this spawner will run and listen for connection requests for the server.

    When you are finished entering server properties, click Next. The Spawner Initialization window displays.

  6. Select an operator login (Login). If you do not specify a login, the operator password defaults to sasobjspawn.

    Select the check box to indicate whether you want to use verbose logging (Verbose), then specify the log file name and path (LogFile). If these options are specified on the object spawner command line, the object spawner command line values override these field values. Click Next.

    Note: If you performed an Advanced or Personal installation, then the default log file is objspawn.log and is located in the /ObjectSpawner/logs subdirectory of your installation.

  7. Select the appropriate servers from the list of Servers that the spawner is permitted to start. To select the servers, highlight all of the servers that you want to associate with that spawner.

    IMPORTANT NOTE: For SAS Stored Process Servers, the spawner must have credentials to use when launching the server as a multi-user process. Therefore, on the SAS Stored Process Server definition, you must specify a multi-user login to use when launching a multi-user stored process server. If you do not specify a multi-user login for the stored process server, the server runs as a single-user server; each connection request for the server spawns a new stored process server which might not be properly shut down.

    Click Next.

  8. Select the Operator Connection. Click Next.

  9. Fill in the following fields:

    1. For the Authentication Domain, enter a domain (Domain). The spawner must use the same domain as the server with which it connects. Click New to add a new Authentication Domain:

      • Enter a Domain.
      • Enter a description.

    2. The host name (Host Name) field contains the machine name on which the spawner is to run.

    3. Specify a unique port number (Port). The port number is required if the server will have Java clients.

    When you are finished entering information in the fields, click Next.

  10. Click Back to go back and change properties. Click Finish to define the spawner.

    Note: If you are setting up load balancing, you must define a load-balancing connection for the spawner.

Adding a Load Balancing or UUID Connection

To add a connection to the spawner using SAS Management Console:

  1. Start SAS Management Console and connect to a metadata repository.

  2. In the SAS Management Console navigation tree, expand the Server Manager and locate the spawner object that you want to modify.

  3. Select the spawner object that you want to modify, and then select Actions arrow Add Connection from the menu bar. The New Connection Wizard displays.

  4. Select the type of connection to add: UUID or Load Balancing. Click Next.

  5. Enter a name and description for the connection. Click Next.

  6. Fill in the following fields:

    1. For the Authentication Domain, enter a domain (Domain). The spawner must use the same domain as the server with which it connects. Click New to add a new Authentication Domain:

      • Enter a Domain:
      • Enter a description.

    2. The host name (Host Name) field contains the machine name on which the spawner is to run.

    3. Specify a unique port number (Port). The port number is required if the server will have Java clients.

    4. For UUID connections only, if you want to enter a service, click Advanced Options. Enter the service (Service).

    When you are finished entering information in the fields, click Next. The parameters for the new spawner will be displayed.

  7. Click Finish to define the connection and return to the SAS Management Console main window.

Modifying an Existing Spawner

To modify a spawner definition using SAS Management Console:

  1. Start SAS Management Console and connect to a metadata repository.

  2. In the SAS Management Console navigation tree, expand the Server Manager and locate the spawner object that you wish to modify.

  3. Select the spawner object, and then select File arrow Properties from the menu bar.

  4. Select the appropriate tabs, and enter the necessary changes as follows:

    • Modify values on the Options tab to reconfigure version information, encryption key length, MAC encryption, handshake timeout or the machine that on which the spawner runs.
    • Modify values on the Initialization tab to reconfigure operator credentials and logging information.
    • Modify values on the Servers tab to reconfigure which servers are associated with the spawner.

    For a description of the fields, refer to the Fields for Spawner Attributes Definitions.