Troubleshooting

Troubleshooting networked applications can be difficult. Key information for SPD Server troubleshooting can be found in the Name Server and SPD Server host process log files. With those two log files, you can reconstruct SAS interaction with SPD Server components. Entries in these 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

Problems Renewing Your SPD Server License

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 non-standard 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 will be able to diagnose the reason for the failure from these messages. Some common problems include:

The LIBNAME engine selector that is specified in the LIBNAME statement is invalid. The SPD Server engine name is sasspds and is misspelled in the following LIBNAME statement:
```
LIBNAME foo sasspds 'test' 
  server=sunspot.spdsname
  passwd='xxx';
ERROR: Module FOO not found in search paths.
ERROR: Error in the LIBNAME or FILENAME statement.
```
The logical LIBNAME domain name that is specified in the LIBNAME statement is invalid. The domain name test is not defined in the SPD Server name server sunspot.spdsname:
```
LIBNAME foo sasspds 'test' 
  server=sunspot.spdsname
  passwd='xxx';
ERROR: ERROR: Libname path info not found in SPDS name server.
ERROR: Error in the LIBNAME or FILENAME statement.
```
No name server is running on the specified node name, or no name server is available at the specified port address. In the following example, no name server is running on the specified node stelling. This same message is generated if the port address is incorrect:
```
LIBNAME foo sasspds 'test' 
  server=stelling.spdsname
  passwd='xxx';
ERROR: Unable to connect to SPDS name server.
ERROR: Connection refused.
ERROR: Error in the LIBNAME or FILENAME statement.
```

An invalid or unknown node name is specified in the LIBNAME statement. In the following example, node xxx is not accessible in the network.

LIBNAME foo sasspds 'test' 
  server=xxx.spdsname
  passwd='xxx';
ERROR: Unable to connect to SPDS name server.
ERROR: xxx.
ERROR: Error in the LIBNAME or FILENAME statement.

An invalid SPD Server user password is specified in the LIBNAME statement. In the following example, the SPD Server user ID is derived from the UNIX user ID that is running the SAS session. The SPD Server password file has an entry for this SPD Server user ID, but the password is not xxx:
```
LIBNAME foo sasspds 'test' 
  server=sunspot.spdsname
  passwd='xxx';
ERROR: Error on server LIBNAME socket.
ERROR: SPD server has rejected login from user
sasetb.. ERROR: Error in the LIBNAME or FILENAME
statement.
```
An invalid SPD Server user ID is specified in the LIBNAME statement. In the following example, the SPD Server user ID xxx does not exist in the SPD Server host's password file. The resulting message is the same if the password is invalid.
```
LIBNAME foo sasspds 'test' 
  server=sunspot.spdsname
  user='xxx' 
  passwd='xxx';
ERROR: Error on server LIBNAME socket.
ERROR: SPD server has rejected login from user xxx..
ERROR: Error in the LIBNAME or FILENAME statement.
```

Problems Renewing Your SPD Server License

When you receive SPD Server, licensing information is pre-initialized. When you renew the license, you receive a new license to replace your existing license. You must restart SPD Server to use the new license.

Note: Do not change the licensing information unless you are logged in with the user ID of the owner of the SPD Server. You designate the owner of SPD Server when you license the software.