Sun OpenSSO Enterprise 8.0 Administration Reference

ssoadm Command Line Interface Error Codes

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