Troubleshooting

Key information for SPD Server troubleshooting can be found in the SPD Server name server log and in the SPD Server host process log files. Those two log files enable you to reconstruct SAS interactions with SPD Server components. Entries in the log files are time-stamped for reference. You should be able to correlate activities between the two logs by using the time-stamp information. The logs are formatted as plain text files.

Name Server Start-Up Failed

Check the name server log file. The log should contain information about the problem. Some common things to look for include:

The -LICENSEFILE file specification is not valid
-LICENSEFILE specifies a file with invalid contents.
The name server port is in use by another process.

Determine whether another name server process is already running on the same node by issuing the following command:

ps -ef |
                     grep -i spdsnsrv

SPD Server Host Start-Up Failed

Check the SPD Server host log file for information. Some common things to look for include:

The -NAMESERVER node name is incorrect.
-NAMESERVERPORT specifies the wrong port number if the SPD Server name server is running with a nonstandard port assignment.
The -PARMFILE file specification is invalid, or the specified file does not exist.
The -LIBNAMEFILE file specification is invalid, or the specified file does not exist.
The contents of the specified -LIBNAMEFILE does not conform to expected syntax. Check the SPD Server host log file for messages about invalid entries.
The -ACLDIR option was omitted from the command line.
The -ACLDIR option specifies an invalid directory path for the SPD Server password file, or the specified directory path does not contain a valid SPD Server password file.

SAS LIBNAME Assignment Failed

If the SAS LIBNAME assignment fails, first check the error messages from the SPD Server LIBNAME engine through the SAS log output. In most circumstances, you can diagnose the reason for the failure from these messages. Some common problems include:

ERROR: The SASSPDS engine cannot be found.

This error indicates your SAS installation did not include the SAS Scalable Performance Data Server client. Review your SAS installation.

ERROR: Unable to connect to SPD Name Server.

This error indicates that SAS SPD Server is not running, or your LIBNAME HOST= or SERV= values are not correct. Verify your LIBNAME statement and that SPD Server is running on the correct host with the correct port.

ERROR: Protocol version mismatch. Proxy version is 5.1 while engine version is <version>.

This error indicates you are trying to connect to SPD Server with an old client. Verify that you are running SAS 9.4 with the SAS Scalable Performance Data Server client.

ERROR: SPD Server has rejected login from user <username>

This error indicates you are trying to connect to SPD Server with an invalid user ID or password. Verify your LIBNAME statement.