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 Servers

The SAS Management Console Server Manager provides a graphical user interface that allows you to create or modify a definition for the following servers that use an IOM Bridge connection:

  • SAS Workspace Server
  • SAS Stored Process Server
  • SAS OLAP Server
  • SAS Metadata Server (only for replication and promotion to other metadata servers. See the SAS Management Console: User's Guide for detailed instructions about how to promote and replicate repositories.)

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 servers, you must have the following:

  • a metadata profile for connecting to a metadata repository. For details about setting up this profile, see the SAS Management Console: User's Guide.
  • an understanding of the server metadata structure. For an overview of SAS Application Servers and logical server groupings, see Planning the Metadata.
  • the appropriate login, user, and group definitions for your server configuration. For details, see Security Metadata and the Security section.

Note: If you want a spawner to start the servers, after you define your servers you must define a spawner and designate which servers the spawner will start. If you subsequently define additional servers, you must modify the spawner and designate those additional servers that you want the spawner to start.

To define an IOM Bridge connection using SAS Management Console:

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

  2. Choose the appropriate scenario for defining your server:

Defining a New Server and New Logical Server in a New SAS Application Server

To define a new server, logical server, and SAS Application Server:

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

  2. Select the SAS Application Server. Click Next.

  3. Enter the Name and Description. The name you provide will be the name of the SAS Application Server. Click Next.

  4. Verify that the Minor Version Number, Major Version Number, Software Version. and the Vendor are correct. Click Next. A list of defined server resource templates is displayed. If your server type is not displayed, click Cancel.

  5. Select the type of server you want to define. The type you choose will be the type of the first logical server and server in the SAS Application Server definition. For example, if you select workspace server as the server type, the SAS Application Server will contain a logical workspace server which in turn contains a workspace server. Click Next.

  6. Select Custom and click Next.

  7. Verify that the Minor Version Number, Major Version Number, Software Version, and the Vendor are correct.

    For SAS Workspace Servers or SAS Stored Process Servers:

    • Enter the command (Command) used to start the server. (For details, see Server Startup Command. Include the path relative to the directory in which the spawner will be started.)

      Note: You must specify a command in order to launch the server with a spawner.

    • Specify any additional object server parameters (Object Server Parameters) to use to launch SAS.

  8. To continue configuring the server and add advanced options, see the appropriate topic for your type of server:

Defining a New Server and New Logical Server in an Existing SAS Application Server

To define a new server and new logical server in an existing SAS Application Server:

  1. From the SAS Management Console navigation tree, select and expand the Server Manager and locate the SAS application server under which you want to add the new server. The SAS Application Servers are located one folder level below the Server Manager. Select the appropriate SAS Application Server, and then select Actions arrow Add Application Server Component from the menu bar. The New Server Wizard displays. A list of server resource templates is displayed.

    Note: A SAS Application Server can only contain one logical server of each of the following types: SAS Workspace Server, SAS Metadata Server, SAS Stored Process Server, and SAS OLAP Server.

  2. Select the type of server you want to define. The type that you select will be the type of logical server and server defined. Click Next.

  3. Select Custom and click Next.

  4. Enter the Name and Description. The name you provide will be the name of the server. Click Next.

  5. Verify that the Minor Version Number, Major Version Number, Software Version, and the Vendor are correct.

    For SAS Workspace Servers or SAS Stored Process Servers:

    • Enter the command (Command) used to start the server. (For details, see Server Startup Command. Include the path relative to the directory in which the spawner will be started.)

      Note: You must specify a command in order to launch the server with a spawner.

    • Specify any additional object server parameters (Object Server Parameters) to use to launch SAS.

  6. To continue configuring the server and add advanced options, see the appropriate topic for your type of server:

Defining a New Server in an Existing Logical Server

To define a new server in an existing logical server and SAS Application Server:

  1. From the SAS Management Console navigation tree, select and expand the Server Manager, then select and expand the SAS Application Server that contains the logical server under which you want to add the new server. Then, select the appropriate logical server, and select Actions arrow Add Server from the menu bar. The New Server Wizard displays.

  2. Enter the Name and Description. The name you provide will be the name of your server. Click Next.

  3. Verify that the Minor Version Number, Major Version Number, Software Version, and the Vendor are correct. Click Next.

    For SAS Workspace Servers or SAS Stored Process Servers:

    • Enter the command (Command) used to start the server. (For details, see Server Startup Command. Include the path relative to the directory in which the spawner will be started.)

      Note: You must specify a command in order to launch the server with a spawner.

    • Specify any additional object server parameters (Object Server Parameters) to use to launch SAS.

  4. To continue configuring the server and add advanced options, see the appropriate topic for your type of server: