Unable to read a known contact list error while trying to test RSA Authentication Manager Integration Service (AMIS) using amServiceHarness tool

[#1]

Article Number

000036370

Applies To

RSA Product Set: SecurID
RSA Product/Service Type: RSA Authentication Manager Prime, Authentication Manager Integration Service (AMIS)

Issue

• When trying to test AMIS using amServiceHarness tool, the following error displays:

           Unable to read a known contact list

• The following error displays in the am8.log file, located in ../rsa/logs/amis:

java.lang.Exception: ==DC== Unable to read a known contact list!
STACK_TRACE[$java.lang.Exception: ==DC== Unable to read a known contact list!
com.rsa.ucm.AuthManager.DriverCache.getServerList(DriverCache.java:122)
com.rsa.ucm.AuthManager.DriverCache.createSessionOnPrimary(DriverCache.java:182)
com.rsa.ucm.AuthManager.DriverCache.createSession(DriverCache.java:255)
com.rsa.ucm.AuthManager.DriverCache.get(DriverCache.java:301)
com.rsa.ucm.AuthManager.AMService.getDriver(AMService.java:123)
com.rsa.ucm.AuthManager.AMService.getDriver(AMService.java:108)
com.rsa.ucm.AuthManager.AMService.userCreate(AMService.java:349)
com.rsa.ucm.shared.extensions.AMExtensionService.userCreate(AMExtensionService.java:141)
com.rsa.ucm.shared.resources.UserManager.createUser(UserManager.java:474)
sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
java.lang.Exception: ==DC== Unable to read a known contact list!
STACK_TRACE[$java.lang.Exception: ==DC== Unable to read a known contact list!
com.rsa.ucm.AuthManager.DriverCache.getServerList(DriverCache.java:122)
com.rsa.ucm.AuthManager.DriverCache.createSessionOnPrimary(DriverCache.java:182)
com.rsa.ucm.AuthManager.DriverCache.createSession(DriverCache.java:255)
com.rsa.ucm.AuthManager.DriverCache.get(DriverCache.java:301)
com.rsa.ucm.AuthManager.AMService.getDriver(AMService.java:123)
com.rsa.ucm.AuthManager.AMService.getDriver(AMService.java:108)
com.rsa.ucm.AuthManager.AMService.userCreate(AMService.java:349)
com.rsa.ucm.shared.extensions.AMExtensionService.userCreate(AMExtensionService.java:141)
com.rsa.ucm.shared.resources.UserManager.createUser(UserManager.java:474)
sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
java.lang.reflect.Method.invoke(Method.java:498)
org.glassfish.jersey.server.model.internal.ResourceMethodInvocationHandlerFactory$1.invoke(ResourceMethodInvocationHandlerFactory.java:81)
org.glassfish.jersey.server.model.internal.AbstractJavaResourceMethodDispatcher$1.run(AbstractJavaResourceMethodDispatcher.java:144)
org.glassfish.jersey.server.model.internal.AbstractJavaResourceMethodDispatcher.invoke(AbstractJavaResourceMethodDispatcher.java:161)
org.glassfish.jersey.server.model.internal.JavaResourceMethodDispatcherProvider$TypeOutInvoker.doDispatch(JavaResourceMethodDispatcherProvider.java:205)
org.glassfish.jersey.server.model.internal.AbstractJavaResourceMethodDispatcher.dispatch(AbstractJavaResourceMethodDispatcher.java:99)
org.glassfish.jersey.server.model.ResourceMethodInvoker.invoke(ResourceMethodInvoker.java:389)
org.glassfish.jersey.server.model.ResourceMethodInvoker.apply(ResourceMethodInvoker.java:347)
org.glassfish.jersey.server.model.ResourceMethodInvoker.apply(ResourceMethodInvoker.java:102)java.lang.Exception: ==DC== Unable to read a known contact list! STACK_TRACE[$
java.lang.reflect.Method.invoke(Method.java:498)
org.glassfish.jersey.server.model.internal.ResourceMethodInvocationHandlerFactory$1.invoke(ResourceMethodInvocationHandlerFactory.java:81)
org.glassfish.jersey.server.model.internal.AbstractJavaResourceMethodDispatcher$1.run(AbstractJavaResourceMethodDispatcher.java:144)
org.glassfish.jersey.server.model.internal.AbstractJavaResourceMethodDispatcher.invoke(AbstractJavaResourceMethodDispatcher.java:161)
org.glassfish.jersey.server.model.internal.JavaResourceMethodDispatcherProvider$TypeOutInvoker.doDispatch(JavaResourceMethodDispatcherProvider.java:205)
org.glassfish.jersey.server.model.internal.AbstractJavaResourceMethodDispatcher.dispatch(AbstractJavaResourceMethodDispatcher.java:99)
org.glassfish.jersey.server.model.ResourceMethodInvoker.invoke(ResourceMethodInvoker.java:389)
org.glassfish.jersey.server.model.ResourceMethodInvoker.apply(ResourceMethodInvoker.java:347)
org.glassfish.jersey.server.model.ResourceMethodInvoker.apply(ResourceMethodInvoker.java:102)java.lang.Exception: ==DC== Unable to read a known contact list! STACK_TRACE[$

Cause

AMIS is unable to establish an SDK connection to the Authentication Manager

Resolution

Ensure that the environment variables are correct in setenv.sh file:

1. SSH to the AMIS machine using the root account.
2. Navigate to the directory where setenv.sh is located:

cd /opt/rsa/amis/tomcat/tomcat-amis/bin

3. Open setenv.sh and edit it:

vi setenv.sh

4. Make sure that the variables denoted in bold below meet the values of your environment (for more information on these values, please review the Notes section of this article): 

export CATALINA_OPTS="$CATALINA_OPTS '-Damis.bind.account=amis-bind'"
export CATALINA_OPTS="$CATALINA_OPTS '-Damis.bind.account.password=Support1!'"
export CATALINA_OPTS="$CATALINA_OPTS '-Dam.server=192.168.2.50'"
export CATALINA_OPTS="$CATALINA_OPTS '-Dsmtp.server=192.168.2.120'"
export CATALINA_OPTS="$CATALINA_OPTS '-Dlog.level=DEBUG'"
export CATALINA_OPTS="$CATALINA_OPTS '-Dam.webtier.server=2k8-wt.vcloud.local'"
export CATALINA_OPTS="$CATALINA_OPTS '-Dam.command.client.user.id=CmdClient_v6t1tw6a'"
export CATALINA_OPTS="$CATALINA_OPTS '-Dam.command.client.password=AonNwxecXQITxMdvAZZ8MoXvDMbWv0'"

5. Press [ESC] :wq! to save and exit:

:wq!

6. Restart the AMIS service:

service tomcat-amis restart

7. Run the amServiceHarness tool as an administrator.

Notes

• Damis.bind.account is the AMIS bind account created on the Security Console.
• Damis.bind.account.password is the AMIS bind account password.
• Dam.server is the Authentication Manager primary server hostname.
• Dsmtp.server is the SMTP server hostname.
• Dam.webtier.server​ is the Web  Tier server hostname.
• Command.client.user.id is the primary Authentication Manager API client user ID.
• Command.client.password is the primary Authentication Manager API client password.