3 Testing the Connector

After you deploy the connector, you must test it to ensure that it functions as expected. Tests that you can run on the connector can be divided into the following high-level categories:

This chapter contains the following sections:

• Running Connector Tests

• Troubleshooting

Running Connector Tests

This section discusses test cases that you can perform by using the troubleshooting utility.

You can use the troubleshooting utility to directly use the connector to identify the cause of problems associated with connecting to the Oracle Identity Manager server and performing basic operations on the server.

Before you can use the troubleshooting utility, you must set the required values in the config.properties file. This file is in the xellerate_home/xellerate/XLIntegrations/Telnet/tests/config/config.properties directory.

Use the information in the following table to modify the default attributes of the config.properties file.

Name	Description	Default Attribute (Sample Values)
hostname	IP address of the UNIX server on which Telnet provisioning is to be performed	10.1.1.114
loginPrompt	Login prompt of the UNIX server Default login	login
passwordPrompt	Password prompt of the UNIX server Default password	Password
shellPrompt	Default shell prompt of the UNIX server: # for Solaris, Linux, and HP-UX $ for AIX	#
Port	Port at which the Telnet server is listening	23
Os Type	Operating system type of the UNIX server Accepted values are SOLARIS, LINUX, HP-UX, and AIX.	SOLARIS
adminpassword	Admin user password	dead_line
Admin	UNIX server administrator credentials for the Telnet server	root
Action	Action to be tested The values can be any of the following: CREATE MODIFY DELETE	CREATE
UserName	User attribute	jdoe
UID	New user UID for the above user	12548

After you specify values in the config.properties file, run the following script:

xellerate_home/xellerate/XLIntegrations/Telnet/tests/scripts/telnet.bat

Troubleshooting

The following table lists solutions to some commonly encountered issues associated with the connector.

Problem Description	Solution
Process definition: TELNET User Process task: Create User Returned Error Message: Not able to connect successfully to the UNIX server Returned Error Code: TELNET_USERCREATION_NOTCONNECTED_FAIL	Check if the UNIX server is running and accessible. In addition, check the admin credentials entered in the IT Resource.
Process definition: TELNET User Process task: Create User Returned Error Message: User does not have creation rights on the UNIX server Returned Error Code: TELNET_USERCREATION_NORIGHTS_FAIL	Check the admin credentials entered in the IT Resource.
Process definition: TELNET User Process task: Create User Returned Error Message: Oracle Identity Manager is not able to create a user successfully due to a missing password file Returned Error Code: TELNET_USERCREATION_MISSINGPASSWDFILE_FAIL	Check the availability of the /etc/passwd file on the UNIX server.
Process definition: TELNET User Process task: Create User Returned Error Message: User name already exists on the UNIX server Returned Error Code: TELNET_USERCREATION_USEREXISTS_FAIL	Check the user name that you have entered. A user with the same name already exists on the UNIX server.
Process definition: TELNET User Process task: Create User Returned Error Message: User ID already exists and is unique or specified user ID is out of range Returned Error Code: TELNET_USERCREATION_USERID_FAIL	Check the user ID that you have entered. Another user may have the same user ID on the UNIX server or the value of the user ID may be out of range.
Process definition: TELNET User Process task: Create User Returned Error Message: User name too long Returned Error Code: TELNET_USERCREATION_NAMEFORMAT_FAIL	Check the user name that you have entered.
Process definition: TELNET User Process task: Create User Returned Error Message: User ID already exists and is unique or specified user ID is out of range Returned Error Code: TELNET_USERCREATION_USERID_FAIL	Check the user ID that you have entered. Another user may have the same ID on the UNIX server or the value of the user ID may be out of range.
Process definition: TELNET User Process task: Create User Returned Error Message: Group name or ID mismatch Returned Error Code: TELNET_USERCREATION_NOGROUP_FAIL	Check the primary group name that you have entered. The group name entered should exist on the UNIX server. In addition, spaces are not allowed in the group name.
Process definition: TELNET User Process task: Create User Returned Error Message: Missing default shell Returned Error Code: TELNET_USERCREATION_NOSHELL_FAIL	Check the default shell that you have specified. The default shell specified should be installed on the UNIX server.
Process definition: TELNET User Process task: Create User Returned Error Message: Wrong expiry date Returned Error Code: TELNET_USERCREATION_DATERANGE_FAIL	Check the date selected.
Process definition: TELNET User Process task: Create User Returned Error Message: Wrong password change time Returned Error Code: TELNET_USERCREATION_WRONGCHANGETIME_FAIL	Check the password change time that you have entered.
Process definition: TELNET User Process task: Create User Returned Error Message: Wrong GECOS data Returned Error Code: TELNET_USERCREATION_GECOSFORMAT_FAIL	Check the GECOS data that you have entered. Spaces are not allowed.
Process definition: TELNET User Process task: Create User Returned Error Message: Wrong Home Directory Returned Error Code: TELNET_USERCREATION_HOMEDIR_FAIL	Check the home directory that you have specified.
Process definition: TELNET User Process task: Create User Returned Error Message: Wrong Home Directory Returned Error Code: TELNET_USERCREATION_SETPASSWORD_FAIL	Check the password, and reenter the password data.
Process definition: TELNET User Process task: Delete User Returned Error Message: Not able to connect to the UNIX server Returned Error Code: TELNET_USERDELETION_NOTCONNECTED_FAIL	Check if the UNIX server is running and accessible. In addition, check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: Delete User Returned Error Message: Oracle Identity Manager administrator does not have deletion rights on the UNIX server Returned Error Code: TELNET_USERDELETION_NORIGHTS_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: Delete User Returned Error Message: User does not exist on the UNIX server Returned Error Code: TELNET_USERDELETION_NOUSER_FAIL	Check if the particular user exists on the UNIX server.
Process definition: TELNET User Process task: GECOS Updated Returned Error Message: Not able to connect to the UNIX server Returned Error Code: TELNET_UPDATEGECOS_NOTCONNECTED_FAIL	Check if the UNIX server is running and accessible. In addition, check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: GECOS Updated Returned Error Message: Oracle Identity Manager administrator does not have deletion rights on the UNIX server Returned Error Code: TELNET_UPDATEGECOS_NORIGHTS_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: GECOS Updated Returned Error Message: User does not exist on the UNIX server Returned Error Code: TELNET_UPDATEGECOS_NOUSER_FAIL	Check if the particular user exists on the UNIX server.
Process definition: TELNET User Process task: GECOS Updated Returned Error Message: Update user GECOS failed due to data format or size Returned Error Code: TELNET_UPDATEGECOS_FORMAT_FAIL	Check the GECOS data that you have entered. Spaces are not allowed.
Process definition: TELNET User Process task: Password Change Time Updated Returned Error Message: Not able to connect to the target system Returned Error Code: TELNET_UPDATECHANGETIME_NOTCONNECTED_FAIL	Check if the UNIX server is running and accessible. In addition, check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: Password Change Time Updated Returned Error Message: Oracle Identity Manager administrator does not have deletion rights on the UNIX server Returned Error Code: TELNET_UPDATECHANGETIME_NORIGHTS_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: Password Change Time Updated Returned Error Message: User does not exist on the UNIX server Returned Error Code: TELNET_UPDATECHANGETIME_NOUSER_FAIL	Check if the user exists on the UNIX server.
Process definition: TELNET User Process task: Password Change Time Updated Returned Error Message: Update password change time failed due to wrong change time format Returned Error Code: TELNET_UPDATECHANGETIME_WRONGCHANGETIME _FAIL	Check the Password change time data that you have specified.
Process definition: TELNET User Process task: Home Directory Updated Returned Error Message: Not able to connect to the UNIX server Returned Error Code: TELNET_UPDATEHOMEDIR_NOTCONNECTED_FAIL	Check if the UNIX server is running and accessible. In addition, check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: Home Directory Updated Returned Error Message: Oracle Identity Manager administrator does not have deletion rights on the UNIX server Returned Error Code: TELNET_UPDATEHOMEDIR_NORIGHTS_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: Home Directory Updated Returned Error Message: User does not exist on the UNIX server Returned Error Code: TELNET_UPDATEHOMEDIR_NOUSER_FAIL	Check if the user exists on the UNIX server.
Process definition: TELNET User Process task: Home Directory Updated Returned Error Message: Update user home directory failed due to wrong directory Returned Error Code: TELNET_UPDATEHOMEDIR_INVALIDDIR_FAIL	Check the Home Directory that you have specified.
Process definition: TELNET User Process task: Default Shell Updated Returned Error Message: Not able to connect to the UNIX server Returned Error Code: TELNET_UPDATESHELL_NOTCONNECTED_FAIL	Check if the UNIX server is running and accessible. In addition, check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: Default Shell Updated Returned Error Message: Oracle Identity Manager administrator does not have deletion rights on the UNIX server Returned Error Code: TELNET_UPDATESHELL_NORIGHTS_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: Default Shell Updated Returned Error Message: User does not exist on the UNIX server Returned Error Code: TELNET_UPDATESHELL_NOUSER_FAIL	Check if the user exists on the UNIX server.
Process definition: TELNET User Process task: Default Shell Updated Returned Error Message: Update user shell failed as the specified shell does not exist Returned Error Code: TELNET_UPDATESHELL_NOTEXIST_FAIL	Check the default shell that you have entered. The default shell specified should be installed on the UNIX server.
Process definition: TELNET User Process task: User UID Updated Returned Error Message: Not able to connect to the UNIX server Returned Error Code: TELNET_UPDATEUID_NOTCONNECTED_FAIL	Check if the UNIX server is running and accessible. In addition, check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: User UID Updated Returned Error Message: Oracle Identity Manager administrator does not have deletion rights on the UNIX server Returned Error Code: TELNET_UPDATEUID_NORIGHTS_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: User UID Updated Returned Error Message: User does not exist on the UNIX server Returned Error Code: TELNET_UPDATEUID_NOUSER_FAIL	Check if the user exists on the UNIX server.
Process definition: TELNET User Process task: User UID Updated Returned Error Message: User UID already exists and unique Returned Error Code: TELNET_UPDATEUID_UNIQUE_FAIL	Check the user UID that you have specified. Another user may have the same UID on the UNIX server.
Process definition: TELNET User Process task: User UID Updated Returned Error Message: Specified user UID is too long Returned Error Code: TELNET_UPDATEUID_SIZE_FAIL	Check the user UID that you have entered. The value specified is out of the acceptable range.
Process definition: TELNET User Process task: Account Expiry Date Updated Returned Error Message: Not able to connect to the UNIX server Returned Error Code: TELNET_UPDATEEXPDATE_NOTCONNECTED_FAIL	Check whether the UNIX server is running and accessible. In addition, check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: Account Expiry Date Updated Returned Error Message: Oracle Identity Manager administrator does not have deletion rights on the UNIX server Returned Error Code: TELNET_UPDATEEXPDATE_NORIGHTS_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: Account Expiry Date Updated Returned Error Message: User does not exist on the UNIX server Returned Error Code: TELNET_UPDATEEXPDATE_NOUSER_FAIL	Check if the user exists on the UNIX server.
Process definition: TELNET User Process task: Account Expiry Date Updated Returned Error Message: User expiry date not updated due to wrong date Returned Error Code: TELNET_UPDATEEXPDATE_DATERANGE_FAIL	Check the account expiry date that you have specified.
Process definition: TELNET User Process task: Primary Group Name Updated Returned Error Message: Not able to connect to the UNIX server Returned Error Code: TELNET_UPDATEGROUP_NOTCONNECTED_FAIL	Check if the UNIX server is running and accessible. In addition, check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: Primary Group Name Updated Returned Error Message: Oracle Identity Manager administrator does not have deletion rights on the UNIX server Returned Error Code: TELNET_UPDATEGROUP_NORIGHTS_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: Primary Group Name Updated Returned Error Message: User does not exist on the UNIX server Returned Error Code: TELNET_UPDATEGROUP_NOUSER_FAIL	Check if the user exists on the UNIX server.
Process definition: TELNET User Process task: Primary Group Name Updated Returned Error Message: Group name or group ID does not exist on the UNIX server Returned Error Code: TELNET_UPDATEGROUP_NOGROUP_FAIL	Check the primary group name that you have specified.
Process definition: TELNET User Process task: Password Updated Returned Error Message: Not able to connect to the UNIX server Returned Error Code: TELNET_SETPASSWORD_NOTCONNECTED_FAIL	Check if the UNIX server is running and accessible. In addition, check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: Password Updated Returned Error Message: Oracle Identity Manager administrator does not have deletion rights on the UNIX server Returned Error Code: TELNET_SETPASSWORD_NORIGHTS_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: Password Updated Returned Error Message: User does not exist on the UNIX server Returned Error Code: TELNET_SETPASSWORD_NOUSER_FAIL	Check if the user exists on the UNIX server.
Process definition: TELNET User Process task: Password Updated Returned Error Message: Group name or group ID does not exist on the UNIX server Returned Error Code: TELNET_SETPASSWORD_MISMATCH_FAIL	The password specified and the one entered again for confirmation must match.
Process definition: TELNET User Process task: Password Updated Returned Error Message: Group name or group id does not exist on the UNIX server Returned Error Code: TELNET_SETPASSWORD_SIZE_FAIL	Enter the password according to the policy defined on the UNIX server.
Process definition: TELNET User Process task: Secondary Group Name Updated Returned Error Message: User does not exist on the UNIX server Returned Error Code: TELNET_ UPDATESECONDARYGROUP_NOUSER_FAIL	Check if the user exists on the UNIX server.
Process definition: TELNET User Process task: Secondary Group Name Updated Returned Error Message: Oracle Identity Manager administrator does not have deletion rights on the UNIX server Returned Error Code: TELNET_ UPDATESECONDARYGROUP_NORIGHTS_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: Secondary Group Name Updated Returned Error Message: Group name or group ID does not exist on the UNIX server Returned Error Code: TELNET_UPDATESECONDARYGROUP_NOGROUP_FAIL	Check the secondary group names that you have specified.
Process definition: TELNET User Process task: Secondary Group Name Updated Returned Error Message: Oracle Identity Manager is not able to connect successfully to the UNIX server Returned Error Code: TELNET_UPDATESECONDARYGROUP_NOTCONNECTED_FAIL	Check if the UNIX server is running and accessible. In addition, check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: Inactive Days Updated Returned Error Message: Oracle Identity Manager administrator does not have update rights in Target System Returned Error Code: TELNET_UPDATEINACTIVEDAYS_NORIGHTS_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: Inactive Days Updated Returned Error Message: Oracle Identity Manager is not able to connect successfully to the target system Returned Error Code: TELNET_UPDATEINACTIVEDAYS_NOTCONNECTED_FAIL	Check if the UNIX server is running and accessible. In addition, check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: Inactive Days Updated Returned Error Message: User does not exist on the target system Returned Error Code: TELNET_UPDATEINACTIVEDAYS_NOUSER_FAIL	Check if the user exists on the UNIX server.
Process definition: TELNET User Process task: Inactive Days Updated Returned Error Message: Invalid numeric number Returned Error Code: TELNET_UPDATEINACTIVEDAYS_INVALID_NUMERIC_ARGUMENT_FAIL	Check if the value specified in the Inactive Days field is numeric.
Process definition: TELNET User Process task: User Login Updated Returned Error Message: Oracle Identity Manager is not able to connect successfully to the Target System Returned Error Code: TELNET_UPDATELOGINCLASS_NOTCONNECTED_FAIL	Check if the UNIX server is running and accessible. In addition, check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: User Login Updated Returned Error Message: Oracle Identity Manager administrator does not have update rights in Target System Returned Error Code: TELNET_UPDATELOGINCLASS_NORIGHTS_FAIL	Check the secondary group names that you have specified.
Process definition: TELNET User Process task: User Login Updated Returned Error Message: User does not exist on the target system Returned Error Code: TELNET_UPDATELOGINCLASS_NOUSER_FAIL	Check if the user exists on the UNIX server.
Process definition: TELNET User Process task: Disable User Returned Error Message: Oracle Identity Manager is not able to connect successfully to the target system Returned Error Code: TELNET_DISABLEUSER_NOTCONNECTED_FAIL	Check if the UNIX server is running and accessible. In addition, check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: Disable User Returned Error Message: Oracle Identity Manager administrator does not have update rights in target system Returned Error Code: TELNET_DISABLEUSER_NORIGHTS_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: Disable User Returned Error Message: User does not exist on the target system Returned Error Code: TELNET_DISABLEUSER_NOUSER_FAIL	Check if the user exists on the UNIX server.
Process definition: TELNET User Process task: Enable User Returned Error Message: Oracle Identity Manager is not able to connect successfully to the target system Returned Error Code: TELNET_ENABLEUSER_NOTCONNECTED_FAIL	Check if the UNIX server is running and accessible. In addition, check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task Enable User Returned Error Message: Oracle Identity Manager is not able to connect successfully to the target system Returned Error Code: TELNET_ ENABLEUSER_NOTCONNECTED_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: TELNET User Process task: Enable User Returned Error Message: User does not exist on the target system Returned Error Code: TELNET_ENABLEUSER_NOUSER_FAIL	Check if the user exists on the UNIX server.

Note:

The following run-time exception message is displayed when:

• The credentials in the IT Resource are incorrect.

• The number of concurrent connections to the target system exceeds the permitted value. For example, if a target system accepts only two concurrent connections, then the third connection is not allowed and the error message is displayed.

Run-time exception message:

Java.lang.RuntimeException:Exceeded
timeout of 120000ms while waiting..
at com.jscape.inet.telnet.TelnetTask$TelnetTaskMonitor.run (Unknown Source)