Configure a remote client

Configure a remote client

You can configure a remote client after you have installed and run a remote client for the first time.

 

After that you can configure the remote client:

 

The remote output client can be configured by modifying the file

<INTERFORMNG2_HOME>/profiles/default/settings/remote_output_settings.json

The file is created automatically when the service is started for the first time. The default configuration is:

{
 "protocol" : "https",
 "host" : "localhost",
 "port" : 8086,
 "tenant" : "home",
 "locationId" : "Default",
 "username" : "default",
 "password" : "password",
 "notifier" : null
}
  • Protocol
    "protocol" can be "http" or "https" and this should match how the main application web interface is accessed.

  • Host and Port
    "host" and "port" should match the host and port for the main application web interface.

NotesNOTE: You should probably change the value into 8086, to match the port number used for InterFormNG2.

  • Tenant
    "tenant" must be the name of the tenant to connect to. This is required when using notifications. If notifications are not used and the user only has access to one tenant, then it can be left out.

  • LocationId
    If multiple remote output clients (for the same tenant) are installed in different locations, and should pick up different outputs, then the "locationId" should specify the location of this remote client. Only outputs sent to this location id will be picked up by the client.
    If only one remote output location is needed, then this is best left at "Default".

  • Username and password
    "username" and "password" must be the username and password of the user that will be used to authenticate with the main application (as described above). That means, that this user and password need to be defined on the InterFormNG2 host on the selected tenant. This user need to be specified on the tenant of the host with the user roleweb service.

 

  • Notifications
    If notifications are enabled on the main application and on the tenant that this client connects to, then the client needs to be configured with notifier settings.
    After "notifier", replace null (in the example above) with:

    {
     "host": "localhost",
     "port": 8100,
     "accessPassword": "password",
     "keystorePath": "internal:remoteoutput.jks",
     "keystorePassword": "password"
    }


  • Host
    "host" should be the same as above (maybe we can remove this, since it seems to be duplicate).

  • Port
    "port" should be the port that was configured as notifier port in the main application settings.

  • AccessPassword
    "accessPassword" should be the password configured as remote output notifier access password on the tenant settings.

  • KeystorePath and password
    "keystorePath" and "keystorePassword" should point to the same keystore as the main application system settings for notifications.

 

After changing the settings, the remote output client service may need to be restarted (if it failed to connect with the previous settings, it will actually automatically retry with the new ones).

Check the log to verify that the remote client is able to connect to the host.

    • Related Articles

    • Remote client module

      If InterFormNG2 is running on a remote machine, such as in the cloud, and you need to print on local printers that are otherwise unreachable (e.g., due to the lack of a VPN connection), you may want to consider purchasing the remote client module for ...
    • Remote clients

      If you wish to store output files generated by InterFormNG2 on external servers, there are several options available, as outlined here. One option is to gain access via a remote client, which requires purchasing a specialized Remote client module. ...
    • Log for the remote client

      The remote output client log file is here: <INTERFORMNG2_HOME>/profiles/default/logs/remote_output_client.log If you see connection errors with code 401, then it is typically because the user that is used to connect does not have the "web service" ...
    • Configuration of the preview client

      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. This section describes how to ...
    • Remote output

      If you want InterFormNG2 to allow a remote client to connect the current tenant, then you need to configure the remote output as below. A requirement is, that remote output is activated in the global settings. In order to setup remote output ...