3 Testing the Connector

Note:

In earlier releases of this guide, the connector was referred to as the integration.

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 for identifying 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/SSH/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 target server where SSH provisioning is to be performed	10.1.1.114
loginPrompt	Default login prompt of the target server	login
passwordPrompt	Default password prompt of the target server	Password
shellPrompt	Default shell prompt of the target server: # for Solaris, Linux, and HP-UX $ for AIX	#
port	Port at which the SSH server is listening	23
osType	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 SSH server	root
action	Action to be tested The value can be one of the following: CREATE MODIFY DELETE	CREATE
userName	User attribute	jdoe
uID	New uID for the user identified by userName	12548
privateKey	Key for Public Key authentication	The value can be blank, or it can be the name and path of the private key file.
sudoFlag	Sudo Admin Mode flag	The value is YES for the SUDO Admin mode. It must be NO if the SUDO Admin mode is not used.

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

xellerate_home/xellerate/XLIntegrations/SSH/tests/scripts/SSH.bat

Troubleshooting

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

Problem Description	Solution
Process definition: SSH User Process task: Create User Returned Error Message: Not able to connect successfully to the UNIX server Returned Error Code: SSH_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: SSH User Process task: Create User Returned Error Message: User does not have creation rights on the UNIX server Returned Error Code: SSH_USERCREATION_NORIGHTS_FAIL	Check the admin credentials entered in the IT Resource.
Process definition: SSH 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: SSH_USERCREATION_MISSINGPASSWDFILE_FAIL	Check the availability of the /etc/passwd file on the UNIX server.
Process definition: SSH User Process task: Create User Returned Error Message: User name already exists on the UNIX server Returned Error Code: SSH_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: SSH 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: SSH_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: SSH User Process task: Create User Returned Error Message: User name too long Returned Error Code: SSH_USERCREATION_NAMEFORMAT_FAIL	Check the user name that you have entered.
Process definition: SSH 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: SSH_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: SSH User Process task: Create User Returned Error Message: Group name or ID mismatch Returned Error Code: SSH_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: SSH User Process task: Create User Returned Error Message: Missing default shell Returned Error Code: SSH_USERCREATION_NOSHELL_FAIL	Check the default shell that you have specified. The default shell specified should be installed on the UNIX server.
Process definition: SSH User Process task: Create User Returned Error Message: Wrong expiry date Returned Error Code: SSH_USERCREATION_DATERANGE_FAIL	Check the date selected.
Process definition: SSH User Process task: Create User Returned Error Message: Wrong password change time Returned Error Code: SSH_USERCREATION_WRONGCHANGETIME_FAIL	Check the password change time that you have entered.
Process definition: SSH User Process task: Create User Returned Error Message: Wrong GECOS data Returned Error Code: SSH_USERCREATION_GECOSFORMAT_FAIL	Check the GECOS data that you have entered. Spaces are not allowed.
Process definition: SSH User Process task: Create User Returned Error Message: Wrong Home Directory Returned Error Code: SSH_USERCREATION_HOMEDIR_FAIL	Check the home directory that you have specified.
Process definition: SSH User Process task: Create User Returned Error Message: Wrong Home Directory Returned Error Code: SSH_USERCREATION_SETPASSWORD_FAIL	Check the password, and reenter the password data.
Process definition: SSH User Process task: Delete User Returned Error Message: Not able to connect to the UNIX server Returned Error Code: SSH_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: SSH User Process task: Delete User Returned Error Message: Oracle Identity Manager administrator does not have deletion rights on the UNIX server Returned Error Code: SSH_USERDELETION_NORIGHTS_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: SSH User Process task: Delete User Returned Error Message: User does not exist on the UNIX server Returned Error Code: SSH_USERDELETION_NOUSER_FAIL	Check if the particular user exists on the UNIX server.
Process definition: SSH User Process task: GECOS Updated Returned Error Message: Not able to connect to the UNIX server Returned Error Code: SSH_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: SSH User Process task: GECOS Updated Returned Error Message: Oracle Identity Manager administrator does not have deletion rights on the UNIX server Returned Error Code: SSH_UPDATEGECOS_NORIGHTS_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: SSH User Process task: GECOS Updated Returned Error Message: User does not exist on the UNIX server Returned Error Code: SSH_UPDATEGECOS_NOUSER_FAIL	Check if the particular user exists on the UNIX server.
Process definition: SSH User Process task: GECOS Updated Returned Error Message: Update user GECOS failed due to data format or size Returned Error Code: SSH_UPDATEGECOS_FORMAT_FAIL	Check the GECOS data that you have entered. Spaces are not allowed.
Process definition: SSH User Process task: Password Change Time Updated Returned Error Message: Not able to connect to the target system Returned Error Code: SSH_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: SSH 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: SSH_UPDATECHANGETIME_NORIGHTS_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: SSH User Process task: Password Change Time Updated Returned Error Message: User does not exist on the UNIX server Returned Error Code: SSH_UPDATECHANGETIME_NOUSER_FAIL	Check if the user exists on the UNIX server.
Process definition: SSH User Process task: Password Change Time Updated Returned Error Message: Update password change time failed due to wrong change time format Returned Error Code: SSH_UPDATECHANGETIME_WRONGCHANGETIME _FAIL	Check the Password change time data that you have specified.
Process definition: SSH User Process task: Home Directory Updated Returned Error Message: Not able to connect to the UNIX server Returned Error Code: SSH_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: SSH 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: SSH_UPDATEHOMEDIR_NORIGHTS_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: SSH User Process task: Home Directory Updated Returned Error Message: User does not exist on the UNIX server Returned Error Code: SSH_UPDATEHOMEDIR_NOUSER_FAIL	Check if the user exists on the UNIX server.
Process definition: SSH User Process task: Home Directory Updated Returned Error Message: Update user home directory failed due to wrong directory Returned Error Code: SSH_UPDATEHOMEDIR_INVALIDDIR_FAIL	Check the Home Directory that you have specified.
Process definition: SSH User Process task: Default Shell Updated Returned Error Message: Not able to connect to the UNIX server Returned Error Code: SSH_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: SSH 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: SSH_UPDATESHELL_NORIGHTS_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: SSH User Process task: Default Shell Updated Returned Error Message: User does not exist on the UNIX server Returned Error Code: SSH_UPDATESHELL_NOUSER_FAIL	Check if the user exists on the UNIX server.
Process definition: SSH User Process task: Default Shell Updated Returned Error Message: Update user shell failed because the specified shell does not exist Returned Error Code: SSH_UPDATESHELL_NOTEXIST_FAIL	Check the default shell that you have entered. The default shell specified should be installed on the UNIX server.
Process definition: SSH User Process task: User UID Updated Returned Error Message: Not able to connect to the UNIX server Returned Error Code: SSH_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: SSH 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: SSH_UPDATEUID_NORIGHTS_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: SSH User Process task: User UID Updated Returned Error Message: User does not exist on the UNIX server Returned Error Code: SSH_UPDATEUID_NOUSER_FAIL	Check if the user exists on the UNIX server.
Process definition: SSH User Process task: User UID Updated Returned Error Message: User UID already exists and unique Returned Error Code: SSH_UPDATEUID_UNIQUE_FAIL	Check the user UID that you have specified. Another user may have the same UID on the UNIX server.
Process definition: SSH User Process task: User UID Updated Returned Error Message: Specified user UID is too long Returned Error Code: SSH_UPDATEUID_SIZE_FAIL	Check the user UID that you have entered. The value specified is out of the acceptable range.
Process definition: SSH User Process task: Account Expiry Date Updated Returned Error Message: Not able to connect to the UNIX server Returned Error Code: SSH_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: SSH 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: SSH_UPDATEEXPDATE_NORIGHTS_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: SSH User Process task: Account Expiry Date Updated Returned Error Message: User does not exist on the UNIX server Returned Error Code: SSH_UPDATEEXPDATE_NOUSER_FAIL	Check if the user exists on the UNIX server.
Process definition: SSH User Process task: Account Expiry Date Updated Returned Error Message: User expiry date not updated due to wrong date Returned Error Code: SSH_UPDATEEXPDATE_DATERANGE_FAIL	Check the account expiry date that you have specified.
Process definition: SSH User Process task: Primary Group Name Updated Returned Error Message: Not able to connect to the UNIX server Returned Error Code: SSH_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: SSH 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: SSH_UPDATEGROUP_NORIGHTS_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: SSH User Process task: Primary Group Name Updated Returned Error Message: User does not exist on the UNIX server Returned Error Code: SSH_UPDATEGROUP_NOUSER_FAIL	Check if the user exists on the UNIX server.
Process definition: SSH 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: SSH_UPDATEGROUP_NOGROUP_FAIL	Check the primary group name that you have specified.
Process definition: SSH User Process task: Password Updated Returned Error Message: Not able to connect to the UNIX server Returned Error Code: SSH_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: SSH User Process task: Password Updated Returned Error Message: Oracle Identity Manager administrator does not have deletion rights on the UNIX server Returned Error Code: SSH_SETPASSWORD_NORIGHTS_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: SSH User Process task: Password Updated Returned Error Message: User does not exist on the UNIX server Returned Error Code: SSH_SETPASSWORD_NOUSER_FAIL	Check if the user exists on the UNIX server.
Process definition: SSH User Process task: Password Updated Returned Error Message: Group name or group ID does not exist on the UNIX server Returned Error Code: SSH_SETPASSWORD_MISMATCH_FAIL	The password specified and the one entered again for confirmation must match.
Process definition: SSH User Process task: Password Updated Returned Error Message: Group name or group id does not exist on the UNIX server Returned Error Code: SSH_SETPASSWORD_SIZE_FAIL	Enter the password according to the policy defined on the UNIX server.
Process definition: SSH User Process task: Secondary Group Name Updated Returned Error Message: User does not exist on the UNIX server Returned Error Code: SSH_ UPDATESECONDARYGROUP_NOUSER_FAIL	Check if the user exists on the UNIX server.
Process definition: SSH 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: SSH_ UPDATESECONDARYGROUP_NORIGHTS_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: SSH 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: SSH_UPDATESECONDARYGROUP_NOGROUP_FAIL	Check the secondary group names that you have specified.
Process definition: SSH 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: SSH_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: SSH User Process task: Inactive Days Updated Returned Error Message: Oracle Identity Manager administrator does not have update rights in Target System Returned Error Code: SSH_UPDATEINACTIVEDAYS_NORIGHTS_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: SSH 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: SSH_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: SSH User Process task: Inactive Days Updated Returned Error Message: User does not exist on the target system Returned Error Code: SSH_UPDATEINACTIVEDAYS_NOUSER_FAIL	Check if the user exists on the UNIX server.
Process definition: SSH User Process task: Inactive Days Updated Returned Error Message: Invalid numeric number Returned Error Code: SSH_UPDATEINACTIVEDAYS_INVALID_NUMERIC_ARGUMENT_FAIL	Check if the value specified in the Inactive Days field is numeric.
Process definition: SSH 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: SSH_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: SSH User Process task: User Login Updated Returned Error Message: Oracle Identity Manager administrator does not have update rights in Target System Returned Error Code: SSH_UPDATELOGINCLASS_NORIGHTS_FAIL	Check the secondary group names that you have specified.
Process definition: SSH User Process task: User Login Updated Returned Error Message: User does not exist on the target system Returned Error Code: SSH_UPDATELOGINCLASS_NOUSER_FAIL	Check if the user exists on the UNIX server.
Process definition: SSH User Process task: Disable User Returned Error Message: Oracle Identity Manager is not able to connect successfully to the target system Returned Error Code: SSH_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: SSH User Process task: Disable User Returned Error Message: Oracle Identity Manager administrator does not have update rights in target system Returned Error Code: SSH_DISABLEUSER_NORIGHTS_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: SSH User Process task: Disable User Returned Error Message: User does not exist on the target system Returned Error Code: SSH_DISABLEUSER_NOUSER_FAIL	Check if the user exists on the UNIX server.
Process definition: SSH User Process task: Enable User Returned Error Message: Oracle Identity Manager is not able to connect successfully to the target system Returned Error Code: SSH_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: SSH User Process task Enable User Returned Error Message: Oracle Identity Manager is not able to connect successfully to the target system Returned Error Code: SSH_ ENABLEUSER_NOTCONNECTED_FAIL	Check the admin credentials specified in the IT Resource.
Process definition: SSH User Process task: Enable User Returned Error Message: User does not exist on the target system Returned Error Code: SSH_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)