Please note: The remote preview client application has been decommissioned in version 3.5.1 and all related settings have been removed. It is only available for previous versions. The articles will be removed soon.

If you try to run the preview client, and you see this error:

Login failed, check connection details and credentials.

Then many different things might have gone wrong. Below there is a checklist, that you can use in order to verify why the preview client is unable to login/connect:

1.You need to ensure, that previewing is activated on the system level of the InterformNG2 host, and that a keystore has been selected. You can verify that here.

2.You can verify, that the keystore and keystore password could be used and that the InterformNG2 service has been stopped and started, if you look into the system log and e.g. search for .jks for any reference to keystore files.
The system log should include a line like this:
Remote preview server started
This indicates, that the preview option has been activated in the system settings, and that the keystore could be opened.

If e.g. the password for the keystore is not correct, then you will however see this message: 

If you are unsure about the password of a keystore, then you can either create a new keystore or you can verify the password of a keystore with the command:

keytool -list -keystore previewclient.jks

You can e.g. run the command on a Windows machine or in QShell (STRQSH) on the IBM i platform.

 

3.If the things above checks out fine, then you can concentrate on the setup of the preview client. For debugging the preview client, it can be a good idea to check out the log of the preview client.

 

4.First of all you need to make sure, that you have remembered to type in the (right) password (and user) for the tenant user in the bottom of the pop up window of the client:
 

 

5.You can also verify, that both the user and password are correct by signing on to the same tenant on the host.

 

6.The other settings of the preview client should of course also be verified. The first one is Protocol, which can be either http or https. This must fit the http or https setting on the InterformNG2 host. You will see the error This combination of host and port requires TLS in the Preview client log, if the client setting does not match the host.

 

7.The next field is Host. The predefined value, Localhost means, that the preview client is expecting InterformNG2 to be installed on the same machine as InterformNG2. If not, then you need to make sure that this contains the IP-address or DNS name of the server, where InterformNG2 is running.

 

8.The service port should be 8086 unless you specifically have changed the port number into something else. This should be the same port number, that you use in your browser, when you sign on to InterformNG2.

 

9.The preview port is default 8110, but if you select another port number, then the selected port number need to be the same in the system setting as on the preview client. If the port number is not correct (or if it is blocked) you will see this message in the preview client:
Failed to connect to preview socket. Check preview port
 

The preview client log indicated the problem with the messages:
Creating socket for localhost:xxxx
Connection refused: connect

10. You need to make sure, that the connection/firewalls between the host and the client is open for both ports mentioned above.

 

11. If the path or name to the keystore and/or keystore password is not correct, then you will see this error in the preview client:
​

Failed to connect to preview socket. Check preview port

In the preview client log you will see an indication of the real error with the message: Could not create SSL context.