SAS/CONNECT Server Tasks

Overview

The tasks outlined in this chapter describe the manual setup of the SAS/CONNECT spawner. In most cases, the SAS/CONNECT spawner is deployed using the SAS Deployment Wizard and manual setup is not required. The SAS Deployment Wizard stores information about the spawner in the metadata server. For more information about the SAS 9.4 Deployment Wizard, see SAS Deployment Wizard and SAS Deployment Manager: User's Guide.
Note: If the UNIX spawner is not being used, there are no server tasks.

Task List

Steps for manually deploying the SAS Connect spawner:
  1. Configure the UNIX spawner service.
    Note: This step is required only if you plan to start the SAS/CONNECT spawner using the -SERVICE <service-name> option.
  2. Start the UNIX spawner at the server.
Note: SAS/CONNECT enables TCP/IP connections from clients outside a firewall to spawners that run on servers inside a firewall. For details, see Configuring SAS/CONNECT for Use with a Firewall.

Configuring the UNIX Spawner Service

If you plan to start the SAS/CONNECT spawner by specifying the service-name on the spawner start-up command, then you need to configure the spawner service in the TCP/IP services file. However, if you plan to start the SAS/CONNECT spawner by specifying the explicit port-number or if you use the information defined in the SAS/CONNECT server’s metadata, then you do not need to perform this step.
The services file is a configuration file that maps port numbers to named services. This mapping allows programs to access ports by name as well as by port number.
In UNIX, the location of the services file is usually /etc/services.
To configure the spawner service, use a text editor to add the connection service name, the port number, and the communications protocol to the services file. The file uses the following format:
<official-service-name> <port-number/protocol-name> <alias-name>
as shown in the following example:
spawnport   4016/TCP   spnprt
The <alias-name> specification is optional.
For a more detailed explanation of these parameters and a sample TCP/IP services file, see Configuring the Services File.

Starting the SAS/CONNECT Spawner on UNIX

You must start the UNIX spawner on a UNIX server to enable clients to connect to it. The spawner program resides on a server and listens for SAS/CONNECT client requests for connections to the server. After the spawner program receives a request, it starts a SAS server session.
If network security is desired, set the appropriate encryption options when starting the spawner. For more details about encryption, see Encryption in SAS, located in the Base SAS Help and Documentation.

SAS/CONNECT Server Example

The following command starts the SAS/CONNECT spawner on UNIX:
cntspawn -service spawner -mgmtport 7555 -sascmd "/u/username/mystartup"
The -SERVICE option specifies that the service named spawner listens for incoming connections. The -MGMTPORT option specifies the port number for operator (administrative) connections. The -SASCMD option specifies the path to the mystartup command file, which starts SAS on the server.