Quick Start: Load-Balancing Stored Process Server and Spawner

The following steps help you set up an IOM Bridge connection for a load-balancing SAS Stored Process 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).

To set up and test a load-balancing stored process 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.

4. Create metadata definitions for a user, login, group, and group login to use for the load-balancing server configuration. For more information about load-balancing security with a stored process server, see Spawner Security Scenario.

   To define a user and login:

   1. In SAS Management Console, select User Manager and then select Actions New User to open the General tab of the New User Properties window.
   2. Enter a Name for the user (for example, User A).
   3. Select the Logins tab and click New to open the New Login Properties window. Enter the fully-qualified User Id (for example, PC101\usera), Password, and Authentication Domain (for example, DefaultAuth) for the user login.

   To define a group and group login:

   1. In SAS Management Console, select User Manager and then select Actions New Group to open the General tab of the New Group Properties window.
   2. Enter a Name for the group, for example, Group ABC.
   3. Select the Members tab. Select the user that you defined in the previous step and click the arrow button to add it to the Current Members panel.
   4. Select the Logins tab and click New to open the New Login Properties window. Enter the fully-qualified User Id (for example, PC101\groupabc), Password, and Authentication Domain (for example, DefaultAuth) for the group login.
   
   
   
5. Create metadata definitions for your SAS Stored Process 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, SPSpawner).
   
   

   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 Stored Process 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

     Note: When the SAS Management Console New Server Wizard prompts you to select the Basic or Custom configuration method, you must choose Custom.

   • 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 8601.
   
   

6. Set up load balancing for the server:
   
   
   1. Convert the logical server to a load-balancing logical server. In SAS Management Console, select the logical stored process server definition that you created in step 5. Select Actions Convert to Load Balancing to open the Load Balancing Options window. From the Load Balancing Credentials drop-down list, select the group login that you created in step 4.
      
      
   2. On the load-balancing logical server definition, grant the Administer permission to the user or group that owns the logical server credentials, (for example, GroupABC).
      
      
   3. Create MultiBridge connections. In SAS Management Console, select the stored process server definition that you created in step 5. Select Actions Add Connection to open the New Connection wizard. Fill in the appropriate fields as follows:
      • Authentication Domain: The authentication domain for your server and spawner (for example, DefaultAuth).
      • Host Name: The machine name on which your server will run.
      • Port Number: The unique port number of 8611.

      Create two additional MultiBridge connections on ports 8621 and 8631.

   4. Optionally, set additional load-balancing parameters for the server. For more information, see Planning and Configuring a Load-Balancing Cluster.

   For more information about setting load balancing options, see Planning and Configuring a Load-Balancing Cluster.

7. (Windows only) Define the Windows user rights for each client.
   
   
   1. For each client that connects to the spawner, specify Log on as a batch job. For detailed instructions about defining Windows user rights, see Starting the Spawner on Windows.
      
      
   2. Restart Windows to apply the new user rights.
   
   
   
8. (UNIX only) Set the setuid root bit for sasrun, sasauth, and elssrv. To set the setuid root bit, see Changing the setuid Permissions to Root.
   
   

9. Use SAS to create a metadata configuration file named objspawn.xml that contains information for accessing the SAS Metadata Server. Start SAS, and then 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: Select Bridge.
   • User Name: The user ID that you specified in step 4 (for example, PC101\usera).
   • Password: The password that you specified in step 4.
   • 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

10. 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 "SPSpawner"
       -install -saslogfile c:\objspawnlog.txt 
       -xmlconfigfile
       "c:\program files\sas\servers\objectspawner\objspawn.xml"
    

    Note: When you install the spawner as a Windows service, you must specify the fully qualified path to the configuration file. When the spawner is started as a Windows NT service, it will self configure using the options that are placed in the registry at install time.

    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 SAS Object Spawner Daemon II.

    UNIX

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

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

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

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