Starting and Stopping Non-Distributed Servers

Starting Servers

Non-distributed servers are started and stopped with the SAS LASR Analytic Server engine. Starting a server requires the STARTSERVER= LIBNAME option.

To start a server:

Starting a Non-Distributed Server

libname server1 sasiola 
    startserver=( 2
        path="c:\temp" 
        keeplog=yes maxlogsize=20 2
    ) 
    host=localhost 3
    port=10010 4
    tag='hps';

1	The STARTSERVER= option indicates to start a server. For information about the options, see STARTSERVER= YES \| NO STARTSERVER =(non-distributed-server-options).
2	The KEEPLOG= option implies the LOGGING option and prevents the server from removing the log file when the server exits. The MAXLOGSIZE= option specifies to use up to 20 MB for the log file before the file is rolled over.
3	The HOST= specification is optional.
4	If you do not specify a PORT= value, then the server starts on a random port and sets the LASRPORT macro variable to the network port number.

Submitting the previous LIBNAME statement from a SAS session starts a server and the server remains running as long as the SAS session remains running. In a batch environment where you want to start a server for client/server use by other users, follow the LIBNAME statement with the following VASMP procedure statements:

SERVERWAIT Statement for the VASMP Procedure

proc vasmp;
    serverwait port=10010; 1
quit;

1	The SERVERWAIT statement causes the server to continue running and wait for a termination request.

When a non-distributed SAS LASR Analytic Server is used in a metadata environment like SAS Visual Analytics, the SIGNER= option enables the server to enforce the permissions that are set in metadata. The values for the HOST= and PORT= options must match the host name and network port number that are specified for the server in metadata.

libname server1 sasiola startserver=(path="/tmp") 
    host="server.example.com" port=10010 tag='hps'
    signer="http://server.example.com/SASLASRAuthorization";

For information about using SAS LASR Analytic Server in a metadata environment, see SAS Visual Analytics: Administration Guide.

If you want to use a script for starting a server, then include the STARTSERVER= LIBNAME option and the SERVERWAIT statement for the VASMP procedure in the program. Start one server only and do not include additional SAS statements after the QUIT statement for the VASMP procedure. If additional statements are included, they can prevent the SAS session from terminating (after receiving a SERVERTERM request). This can prevent the SAS session from freeing memory resources that were used by the server. It is best to restrict the program to starting the server only.

Stopping Servers

Stopping a server is performed by clearing the libref that was used to start the server (if you start the server from a SAS session and keep the session running) or with the SERVERTERM statement.

To stop a server from the same SAS session that started it:

Stopping a Non-Distributed Server with the LIBNAME CLEAR Option

libname server1 clear;

To stop a server from a different SAS session, use the SERVERTERM statement:

SERVERTERM Statement for the VASMP Procedure

proc vasmp;
    serverterm host="server.example.com" port=10010;
quit;

Note: Exiting the SAS session that started the server also terminates the server because all librefs are automatically cleared at the end of a SAS session.