Workpoint Designer connection problems.

Document ID : KB000030415
Last Modified Date : 14/06/2018
Show Technical Document Details
Introduction:

Customers have recently run into the following problem when trying to use Workpoint Designer; they found it won't connect to the server:

 

Cannot retrieve authentication information. NamingException caught attempting to locate the 'ServerConfigPvt_EJB' object. Please verify that the server is running and the client configuration is correct.; nested exception is:

javax.naming.CommunicationException: Could not obtain connection to any of these urls: wpserver.corp.com:1099 and discovery failed with error: javax.naming.CommunicationException: Receive timed out [Root exception is java.net.SocketTimeoutException: Receive timed out] [Root exception is javax.naming.CommunicationException: Failed to connect to server wpserver.corp.com:1099 [Root exception is javax.naming.ServiceUnavailableException: Failed to connect to server wpserver.corp.com:1099 [Root exception is java.net.ConnectException: Connection refused: connect]]]

Additional errors may occur such as "Authentication failed: the server presented no authentication mechanisms" or "Attempt failed to retrieve authorization options from server. Either the server is not running or the client configuration may not be set up correctly."

 

Instructions:

1.  We have found that one possible reason is missing jar files. The jar files required to get this to work correctly are listed herein. These jars are supposed to be under workpoint / lib folder:

wpClient.jar

wpServer.jar

wpServices.jar

wpSQL.jar

 

2.  To connect with EJB you will also need to make sure to have a correct JBoss application user in place:

 

In jboss/bin folder there is a batch file called add-user. Please run it and create a jboss application user.

Example: What type of user do you wish to add?
a) Management User (mgmt-users.properties)
b) Application User (application-users.properties)
(a): b

Enter the details of the new user to add.
Realm (ApplicationRealm) :
Username : imuser
Password :

Note the name and password of the user you created.

When asked "Is this new user going to be used for one AS process to connect to another AS process?" Select No as the user information will be inserted in the Domain configuration instead of the standalone configuration. 

Once you have created your user, open your workpoint-client.properties file (it is under \CA\Identity Manager\IAM Suite\IdentityManager\tools\Workpoint\conf):

Under the line:  remote.connection.default.connect.options.org.xnio.Options.SASL_POLICY_NOANONYMOUS=false

add the following two lines:

remote.connection.default.username=imuser
remote.connection.default.password=Password1!

Change the username and password to be what you entered when you created your user.

Note, for JBOSS 6.4, have to specifically change workpoint-client.properties to one of the following combinations:
java.naming.provider.url=remote://<server>:4447 
java.naming.factory.initial=org.jboss.naming.remote.client.InitialContextFactory
OR
java.naming.provider.url=<server name>
java.naming.factory.initial=org.jboss.as.naming.InitialContextFactory
remote.connection.default.host=<server name>
remote.connection.default.port=4447

For Wildfly, use remote.connection.default.port=8080.
 

No restart need on JBoss side – Designer should work now.