Troubleshooting Setpin program in RSA ACE/Server
Originally Published: 2000-08-23
Article Number
Applies To
RSA ACE/Server
Issue
Setpin utility aborts an error message or messages
Error: "Sd_ListUserInfo Token Not Found"
Error: "Sd_Setpin Error Pin is too short"
Error: "Sd_Setpin Error Pin is too long"
Error: "Sd_Setpin Error New Numeric PIN has Alpha Characters"
Error: "Connected User: xyz on Host: abc./Setpin too long"
Error: "Sd_ApiInit Failed to read Config file"
Error: "Sd_ApiInit Failed to Connect to serv DB /var/ace/data/sdserv"
Error: "Sd_ApiInit Failed to Login to DB"
Error: "Sd_ApiInit User xyz is not ACE/Server Administrator"
Error: "missing token serial number"
Error: "Interprocess Communication Failed!"
Error: "Sd_ListUserInfo Token Not Found" when ACE/Server administrator runs Setpin utility on nonexistent token
Error: "Connected User: xyz on Host: abc./Setpin too long" when ACE/Server administrator runs Setpin utility with token serial number longer than 12 digits
When ACE/Server administrator runs Setpin utility and the environment variables are not set correctly, the following error message(s) will return:
Error: "Sd_ApiInit Failed to read Config file"
Error: "Sd_ApiInit Failed to Connect to serv DB /var/ace/data/sdserv"
OR
Error: "Interprocess Communication Failed!"
When a user other than the ACE/Server administrator runs the Setpin utility, the following error message(s) will return:
Error: "Sd_ApiInit Failed to Login to DB"
Error: "Sd_ApiInit User xyz is not ACE/Server Administrator"
NOTE: The second error may be caused by not setting the PROPATH environment variable
Error: "Missing token serial number" when ACE/Server administrator erroneously runs Setpin utility without a token serial number
Resolution
Error: "Sd_Setpin Error Pin is too short"
Error: "Sd_Setpin Error Pin is too long"
If alphanumeric characters are being used and are currently not allowed in the ACE/Server system parameters, the following error message returns:
Error: "Sd_Setpin Error New Numeric PIN has Alpha Characters"
- To change the min/max PIN length or to allow alphanumeric PINs on your ACE/Server, follow these instructions:
cd /var/ace/prog
./sdadmin
System
Edit System Parameters
- To set the environment variables properly, review section 1 of the solution regarding How to manually set a token PIN number using RSA ACE/Server Setpin utility
- The proper usage of the Setpin utility can be found in the solution regarding How to manually set a token PIN number using RSA ACE/Server Setpin utility (once the solution is shown, search for ./Setpin in the text of the solution)
Related Articles
Windows Error 10061 30Number of Views RSA Governance & Lifecycle SAP Connector Datasheet 31Number of Views RSA Identity Governance & Lifecycle startup fails with "Unable to start service WorkflowService. java.lang.IndexOutOfBound… 119Number of Views Detailed report of memory utilization on Linux for RSA Authentication Manager 8.x 400Number of Views Unable to see orgs after in place upgrade from 5.7.3 to 6.0.2.1 SP2 15Number of Views
Trending Articles
Downloading RSA Authentication Manager license files or RSA Software token seed records RSA MFA Agent 2.3.6 for Microsoft Windows Installation and Administration Guide Quick Setup Guide - Passwordless Authentication in Windows MFA Agent for Active Directory Mandatory Certificate Upgrade Required by 6th October 2025 for RSA MFA Agent for PAM, RSA MFA Agent for Apache, and Third … RSA Authentication Manager 8.9 Release Notes (January 2026)
Don't see what you're looking for?