SAS 9.1.3 Integration Technologies » Administrator's Guide (LDAP Version)


Setting up an IOM Bridge Server and Spawner
Quick Start: Simple Server and Spawner
Summary of Setup Steps
Spawner Overview
Spawner Requirements
Metadata Overview
Creating the Metadata for an IOM Bridge Server
Using the IT Administrator Wizard
Using IT Administrator
SAS Login Object
Server Object
Spawner Object
Using a Configuration File
Configuring a UUID Generator
Configuring and Starting the Object Spawner on z/OS
Invoking (Starting) the Spawner
On Windows
On UNIX
On Alpha/VMS
Spawner Invocation Options
Administering the Server and Spawner:
Using Telnet
Using the IT Configuration Application
Spawner Error Messages
Metadata Examples
Minimal Configuration
Server and Spawner
Using Logical Names
UUID Generator
Message Queue Polling
Reference Materials
Attributes for Logical Names
Attributes for Logins
Attributes for Servers
Object Server Parameters
Server Startup Command
Attributes for Spawners
Initializing UNIX Environment Variables for Workspace Servers
IOM Bridge Servers

Using a Configuration File to Define the Metadata (IOM Bridge)

For LDAP, if you do not use a metadata server as the metadata repository, you can create a flat configuration file that contains the object definitions for an IOM Bridge server configuration. The configuration file must then be installed on the server and on each client machine.

Note: If your configuration requires more than one or two servers, or if multiple clients will be using the servers, we strongly recommend the use of LDAP as a central metadata repository. The use of LDAP also gives you the ability to use access control lists to control access to the servers in your enterprise.

To define an IOM Bridge server configuration using a configuration file:

  1. Use a text editor to code the configuration file. At a minimum, the file must define a server object and a spawner object. You can also define one more SAS login objects, and/or logical name objects. To create the file:

    • Refer to the attribute descriptions for each object type:
    • Refer to the following examples:
    • Use the LDAP Data Interchange Format (LDIF), format, which has the following syntax rules:

      • Start each entry in column one.

      • To indicate a comment line, place '#' in column one.

      • Use the following general format for each entry: "attribute: value".

      • If an entry spans multiple lines, insert a blank in the first column of each continuation line. The blank in column one is a continuation character and is consumed by the LDIF file parser. Therefore, it should not be considered part of the entry.

      • A blank line must precede a distinguished name (exclude comment lines and the first distinguished name in the file). In LDIF, the DN is required to identify the beginning of the next object class definition. The spawner's LDIF parser relies on this requirement in order to separate object class definitions. The DN name can be any value.

      • Two consecutive blank lines indicate the end of the configuration file definitions.

  2. Save the file with a name of your choice (for example, objspawn.cfg).

  3. Install the file on the server machine and on each client machine.

You can now start the spawner. For instructions, refer to Starting the Spawner.