Starting the Spawner on UNIX

If the spawner is to service more than one client userid, the spawner must be launched with root privileges. Root access is required in order for the spawner to fork a process with the connecting client as the owner.

If spawner is to service one client, the spawner may be launched under that client's userid. If your host supports shadow passwords, you may need to specify that authentication be performed by an external authentication program. See the authprog invocation option for more details.

The SAS object server is launched in the client's home directory (as specified in the client's password entry). If the client has a directory in its home directory that is named the same as its userid, SAS will use that directory as the SAS session's SASUSER path.

Note: If you are printing or using SAS/GRAPH procedures, you must set the DISPLAY environment variable to a running X server. For example:

   export DISPLAY=<machine name>:0.0

If the spawner is being launched solely as a UUID generator, root privileges are not required.

Start the spawner program (called objspawn.exe) using a command that specifies the appropriate options. Refer to the Spawner Invocation Options for a complete list of valid options for the command. The following examples use "/sasv8/" as the directory in which SAS was installed.

• The following command launches the spawner with a configuration file:

     prompt> /sasv8/utilities/bin/objspawn -configfile objspawn.cfg

• The following command launches the spawner with the configuration information on an LDAP directory server:

     prompt> /sasv8/utilities/bin/objspawn -ldapHost ldaphost    \
     -ldapBase "sasComponent=sasServer,cn=SAS,o=ABC Inc,c=US"
  

• The following command launches the spawner, specifying the sasSpawner definition to use, with the configuration information on an LDAP server:

     prompt> /sasv8/utilities/bin/objspawn -ldapHost ldaphost         \
     -ldapBase "sasComponent=sasServer,cn=SAS,o=ABC Inc,c=US" \
     -sasSpawnercn mySpawner
  

• The following command launches a dependent spawner with the configuration information on an LDAP server:

     prompt> /sasv8/utilities/bin/objspawn -ldapHost ldaphost         \
     -ldapBase "sasComponent=sasServer,cn=SAS,o=ABC Inc,c=US" \
     -dependent
  

• The following command launches a dependent spawner, specifying the sasDependentSpawner definition to use, with the configuration information on an LDAP server:

     prompt> /sasv8/utilities/bin/itech/objspawn -ldapHost ldaphost   \
     -ldapBase "sasComponent=sasServer,cn=SAS,o=ABC Inc,c=US" \
     -sasDependentSpawnercn myBackup