Troubleshooting

Key information for SPD Server troubleshooting can be found in the name server (spdsnsrv*) and host process (spdsserv*) log files. Those two log files enable you to reconstruct SAS interactions with 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
SPD Server Host Start-Up Failed
SAS LIBNAME Assignment Failed

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 following:
  • The -LICENSEFILE file specification is not valid
  • -LICENSEFILE specifies a file with invalid contents.
  • The name server port is in use by another process.

SPD Server Host Start-Up Failed

Check the SPD Server host log file for information. Some common things to look for include the following:
  • 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 SAS 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 the following:
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.3 while engine version is <version>.
This error indicates that you are trying to connect to SPD Server with an old client. Verify that you are running the latest version of 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.
ERROR: Password has expired and a new password not given.
This error indicates your password has expired and you need to use the NEWPASSWORD LIBNAME option to update your password.
Copyright © SAS Institute Inc. All Rights Reserved.
Last updated: February 3, 2017