The following table describes the error codes generated by the ssoadm command line utility.
Table 9–2 Authentication Error Codes
Error Message |
Description/Probable Cause |
Action |
---|---|---|
Missing Resource Bundle |
Make sure the ssoadmTools.zip is setup correctly. For information, see Installing the OpenSSO Enterprise Utilities and Scripts in the ssoAdminTools.zip File in Sun OpenSSO Enterprise 8.0 Installation and Configuration Guide |
|
Missing CLI Definition Files |
Make sure the ssoadmTools.zip is setup correctly. For information, see Installing the OpenSSO Enterprise Utilities and Scripts in the ssoAdminTools.zip File in Sun OpenSSO Enterprise 8.0 Installation and Configuration Guide |
|
Missing Command Name |
Make sure the ssoadmTools.zip is setup correctly. For information, see Installing the OpenSSO Enterprise Utilities and Scripts in the ssoAdminTools.zip File in Sun OpenSSO Enterprise 8.0 Installation and Configuration Guide |
|
Missing Definition Classes |
Make sure the ssoadmTools.zip is setup correctly. For information, see Installing the OpenSSO Enterprise Utilities and Scripts in the ssoAdminTools.zip File in Sun OpenSSO Enterprise 8.0 Installation and Configuration Guide |
|
Incorrect Definition Classes |
Make sure the ssoadmTools.zip is setup correctly. For information, see Installing the OpenSSO Enterprise Utilities and Scripts in the ssoAdminTools.zip File in Sun OpenSSO Enterprise 8.0 Installation and Configuration Guide |
|
Unable to instantiate Definition Classes |
Make sure the ssoadmTools.zip is setup correctly. For information, see Installing the OpenSSO Enterprise Utilities and Scripts in the ssoAdminTools.zip File in Sun OpenSSO Enterprise 8.0 Installation and Configuration Guide |
|
Unable to access Definition Classes |
Make sure the ssoadmTools.zip is setup correctly. For information, see Installing the OpenSSO Enterprise Utilities and Scripts in the ssoAdminTools.zip File in Sun OpenSSO Enterprise 8.0 Installation and Configuration Guide |
|
Reserved option is used |
If you are extending the ssoadm CLI, check that the new sub command does not use reserved option names. |
|
Incorrect Usage format |
If you are extending the ssoadm CLI, check that the new sub command does not use reserved option names. |
|
Incorrect Option |
You have entered invalid options. |
|
Incorrect Sub Command |
You have entered invalid sub command. |
|
Sub Command implementation is not found |
If you are extending the ssoadm CLI, check that the implementation class is in the class path. |
|
Sub Command implementation cannot be instantiated |
If you are extending the ssoadm CLI, check that the implementation class is in the class path. |
|
Sub Command implementation is not accessed |
If you are extending the ssoadm CLI, check that the implementation class is accessible. |
|
Output Writer Class cannot be instantiated |
If you are extending the ssoadm CLI, check that the output writer class is in the class path |
|
Debug Class cannot be instantiated |
If you are extending the ssoadm CLI, check that the debug class is in the class path |
|
Cannot read the input file |
Check the file name that is provided to ssoadm |
|
Cannot authenticate (LDAP based). |
Check user name and password are valid |
|
Cannot authenticate (session |
Check user name and password are valid |
|
Duplicated options are defined |
If you are extending the ssoadm CLI, check that the new sub command does not have duplicate option names. |
|
Cannot logout |
The server may be down. |
Restart the server and logout again. |
Incorrect Option values |
You have entered invalid option values. | |
Input/Output Exception |
This usually happens if the input file is not readable |
Check the structure of the input file to ensure its validity. |
Cannot write to log file |
Log directory permissions may be set incorrectly. |
Check if the log directory is writable. |
Incorrect data format |
The data in input file needs to have a key and value. e.g. example.key=value1 | |
Session expired |
The session has expired. Usually happens if ssoadm runs for a long period of time. | |
Request cannot be serviced |
Read the output printed by ssoadm. It will provide information on why ssoadm fails. For a list of messages, see Chapter 10, OpenSSO Enterprise Log File Reference |