Attempting to log into from the Java Client results in an invalid stream header error

Products

• CA Automic Applications Manager (AM)

Issue/Introduction

After attempting to log into the Java Client, connection to the RMI fails with the following error

14:40:50.714 AWT-EventQueue-0: .ErrorMsg: Error #: AwE-5103
14:40:50.716 AWT-EventQueue-0: .AxOptions: NoErrorMsgProperties=false
ErrorMsg: AwE-5103 network socket error
Details: Network socket error
java.io.StreamCorruptedException: invalid stream header: 123456789
    at java.io.ObjectInputStream.readStreamHeader(Unknown Source)
    at java.io.ObjectInputStream.<init>(Unknown Source)
    at com.appworx.shared.code.server.B.C(RequestSocket.java:124)
    at com.appworx.client.screen.util.ClientSocketManager.A(ClientSocketManager.java:151)
    at com.appworx.client.screen.util.ClientSocketManager.connect(ClientSocketManager.java:292)
    at com.appworx.client.screen.util.Loader.setMaster(Loader.java:648)
    at com.appworx.client.screen.logon.B.A(Logon.java:699)
    at com.appworx.client.screen.logon.B.f(Logon.java:671)
    ...
    at java.awt.EventDispatchThread.pumpOneEventForFilters(Unknown Source)
    at java.awt.EventDispatchThread.pumpEventsForFilter(Unknown Source)
    at java.awt.EventDispatchThread.pumpEventsForHierarchy(Unknown Source)
    at java.awt.EventDispatchThread.pumpEvents(Unknown Source)
    at java.awt.EventDispatchThread.pumpEvents(Unknown Source)
    at java.awt.EventDispatchThread.run(Unknown Source)

 

 

Cause

One of the main reasons an "invalid stream header" error occurs is if:

• The Java Client's client.properties file is setting 'localOptions=true' enabled which sets the Client to use the local Options.properties instead of the global Options.properties used by the master and located in the master's $AW_HOME/web/classes directory.
• The local Options.properties is disabling SSL by setting the below line:
  
  SSL=Off

Resolution

To resolve this issue:

Edit the local client.properties file (same directory as RunClient.jar) and change localOptions=true to #localOptions=true and save.

OR

Edit the local Options.properties and remove SSL=Off or change SSL=Off to SSL=ON

Then make sure that a copy of the user_keystore and user_keystore_config files found on the master's $AW_HOME/data directory is moved to the below directory of the client server:

C:\Users\<Username\AppWorx\<MASTERNAME>

If directory does not exist, create it.