Quick Start: Standard Workspace Server and Spawner

The following steps help you set up an IOM Bridge connection for a simple SAS Workspace Server that uses a spawner to start the server on a Windows or UNIX platform. For details about setting up more complex configurations, see Summary of Setup Steps (IOM Bridge Connection).

Note: In this setup, if the client (that accesses the SAS Workspace Server) does not already have a user definition on the SAS Metadata Server, then the client is associated with the Public group on the SAS Metadata Server. The client then has access to objects on the SAS Metadata Server based on the Public group's permissions for that object.

To set up and test a standard server and spawner that use an IOM Bridge connection, complete the following steps:

1. Install SAS 9.1 (including SAS Integration Technologies and SAS Management Console) on the server machine. Refer to the SAS documentation for details about this procedure.

2. Determine the machine name and port for your SAS Metadata Server. Determine the fully-qualified user ID and password that you will use to connect to your SAS Metadata Server.

3. Set up and start your SAS Metadata Server. Then, connect to the server and register a repository.

4. Use SAS Management Console to create definitions for your SAS Workspace Server and spawner. To create a spawner definition, select the Server Manager in SAS Management Console and select Actions New Server. From the New Server wizard, select Object Spawner and click Next. Fill in the appropriate fields as follows:
   
   

   Name

   A unique name for the spawner (for example, WSSpawner).
   
   

   Associated Machine

   The machine on which the spawner runs.

   Note: For this basic setup, accept the default operator Login of None.

   Servers

   Click New to open the New Server Wizard.

   To create a new server, fill in the appropriate fields as follows:

   • Name: Unique name for the server.
   • Select the type of server: The type of server. Select Workspace Server.

     Note: When the New Server wizard prompts you to select the Basic or Custom configuration method, you must choose Custom.

   • Command: The command to launch SAS. For example,
     

     Windows

     "c:\Program Files\SAS\SAS 9.1\sas"
        -config "c:\Program Files\SAS\SAS 9.1\sasv9.cfg"

     UNIX

     /usr/local/bin/sas

   • Authentication Domain: The authentication domain for your server and spawner, (for example, DefaultAuth).
   • Host: The machine name on which your server will run. This should be the same machine name as the spawner's Associated Machine.
   • Port: The unique port number of 8591.

   For more information about defining servers, see Using SAS Management Console to Define Servers.

   When you have finished setting up the new server, its name appears in the Selected servers field.

   Authentication Domain

   The authentication domain for your server and spawner (for example, DefaultAuth).
   
   

   Host

   Machine name of the server that you created for the Servers field.
   
   

   Port

   Unique port number of 8581.
   
   

   For more information about defining object spawners, see Using SAS Management Console to Define or Modify a Spawner.

5. (Windows only) Define Windows User Rights for each client.

   1. For each client that connects to the spawner, grant the Log on as a batch job user right. For detailed instructions about defining Windows user rights, see Starting the Spawner on Windows.

   2. Restart Windows to apply the new user rights.

6. (UNIX only) Set the setuid root bit for sasrun, sasauth, and elssrv. See Changing the setuid Permissions to Root for details.
   
   

7. Use SAS to create a metadata configuration file named objspawn.xml that contains information for accessing the SAS Metadata Server. Start SAS and enter the METACON command on the SAS command bar. The Metadata Server Connections window appears. Enter the following information:

   • Name: A name for the server connection.
   • Server: The machine name of your SAS Metadata Server.
   • Port: The port number for your metadata server. Specify 8561.
   • Protocol: The protocol to use. Select Bridge.
   • User Name: The user ID that is used to log on to the metadata server.
   • Password: The password that is used to log on to the metadata server.
   • Repository: The name of the repository that you created in step 3.

   Click Export to save the metadata configuration file to a directory. For example:

   Windows

   c:\program files\sas\servers\objectspawner\objspawn.xml

   UNIX

   /users/myid/objspawn.xml

8. Start the object spawner with the metadata configuration file that you created in the previous step.
   
   

   Windows

   To install the object spawner as a service, enter the following command at a command prompt:

   "c:\Program Files\SAS\SAS 9.1\objspawn" -sasSpawnercn "WSSpawner"
      -install -saslogfile c:\objspawnlog.txt -xmlconfigfile
      "c:\program files\sas\servers\objectspawner\objspawn.xml"
   

   Note: You must specify the fully qualified path to the configuration file.

   Use the Windows net start command to start the object spawner as a Windows service (case does not matter):

   net start "sas object spawner daemon II"

   Note: In the Windows Services utility, the object spawner service appears as the SAS Object Spawner Daemon II.

   UNIX

   To start the object spawner, enter the following command at a system prompt:

   /sasv91/utilities/bin/objspawn -sasSpawnercn "WSSpawner"
      -xmlconfigfile /users/myid/objspawn.xml
   

   For the complete list of spawner invocation options, see Spawner Invocation Options.

9. Test your server using SAS Management Console. For details, see Using SAS Management Console to Test Server Connections.