Oracle® Identity Manager Connector Guide for UNIX Telnet Release 9.0.3 Part Number B32375-01 |
|
|
View PDF |
After you deploy the connector, you must test it to ensure that it functions as expected. This chapter discusses the following topics related to connector testing:
You can use the troubleshooting utility to identify the cause of problems associated with connecting to the target system and performing basic operations on the target system.
Before you use the troubleshooting utility, you must set the required values in the config.properties
file. This file is in the OIM_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.
Attribute | Description | Default Attribute (Sample Value) |
---|---|---|
hostname |
IP address of the target server on which Telnet provisioning is to be performed | 10.1.1.114 |
loginPrompt |
Login prompt of the target 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 |
adminpassword |
Admin user password | dead_line |
Admin |
UNIX server administrator credentials for the Telnet server | root |
Action |
Action to be tested
The value can be any of the following:
|
CREATE |
UserName |
User attribute | jdoe |
UID |
New user UID for the user identified by UserName |
12548 |
After you specify values in the config.properties
file, run the following script:
For UNIX:
OIM_home/xellerate/XLIntegrations/Telnet/tests/scripts/telnet.sh
For Microsoft Windows:
OIM_home/xellerate/XLIntegrations/Telnet/tests/scripts/telnet.bat
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
Check the date selected. |
Process definition: TELNET User
Process task: Create User Returned Error Message: Wrong password change time Returned Error Code:
|
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:
|
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:
|
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:
|
Check the password that you specify. |
Process definition: TELNET User
Process task: Delete User Returned Error Message: Not able to connect to the UNIX server Returned Error Code:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
Check the Password Change Time value 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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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 because the specified shell does not exist Returned Error Code:
|
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:
|
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:
|
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:
|
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:
|
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:
|
Check the user UID that you have specified. 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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
Check the secondary group names that you specify. |
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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:
|
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 on the target system Returned Error Code:
|
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:
|
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:
|
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:
|
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:
|
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)