This section describes how to configure the InterFormNG2 preview client. You need e.g. to  configure the client after a new installation.

The preview client section explains how to use the preview client.

The configuration is divided into four parts:

1.Enable of the preview option globally on the InterFormNG2 host.

2.The main configuration of the preview client.

3.The log configuration of the preview client.

4.You also need to enable the use of the preview client in the designer.

Configure preview globally on the InterFormNG2 host

Before you can use the preview client you need to enable it globally in InterFormNG2. You do that by signing on as a system administrator and then configure preview connections to the host as described in the section, Remote Design preview setup.

On the host you need to decide what port number to use for previews. This is default 8110 and should also be referenced on the client settings below as the preview port.

If you want a secure https connection, then you also need to setup a keystore on the host (recommended) or to use the internal demo keystore of InterFormNG2.

Please note, that you need to stop and start the InterFormNG2 service (on the host) in order to active any change on the host preview configuration.

After a restart of the service you should consider to check the system log to verify, that the keystore and matching password could be used.

Main configuration

The first time you start the InterFormNG2 preview client you will see this in the middle of the pop up window:

Each of the parameters are covered below:

Protocol

Here you setup how secure the connection should be. The possible values are:

http: If you select this, then the connection is unsecure, but it easier to setup. You can e.g. first ensure, that you can get an unsecure connection and then switch https, when you are sure that the http value works.

https: This sets up a secure connection, but for this you also need to configure a keystore and setup a keystore path and password below.

Host

The machine, where InterFormNG2 is running. If you are running the preview client on the same machine as InterFormNG2, then you should here type localhost or 127.0.0.1.

Service port

This is the port number, that you use for accessing the InterFormNG2 web interface on the host. The default value in InterFormNG2 is 8086, so you should probably change the value to that.

Preview port

Specify the port via which the preview client should preview. This must match the port number specified on the hosts global preview settings.

Keystore path

This is the path to the local keystore, that should be used for the preview client. The local keystore should match the preview keystore of the host. The default value refers to a simple built in keystore, but it is recommended to use your own keystore. This is covered in the section: Create a keystore for the preview client.

Keystore password

Here you type the password for the local keystore. This parameter is optional. If the keystore has no password, then you can of course ship this parameter.

Tenant

Here you type the name of the tenant on the InterFormNG2 host, that you want to connect to. If the InterFormNG2 host only has a single tenant, then you can leave this blank.

User name

The user on the tenant that is used for signing on to the InterFormNG2 host.

Password

The password for the user specified above on the InterFormNG2 host.

Log configuration

In the bottom of the Preview client configuration you can setup the log level of messages, that you want to see in the preview client:

The default and recommended setting is shown above. Especially debug and trace should be avoided if possible - they are only for special debugging sessions.

The message decrease in severity and the increase in number from left to right:

Error

Only error messages are shown in the log.

Warning

Only warnings are shown in the log.

Info

All information messages are shown in the log.

Debug

Includes a lot of debug information. This setting effects performance.

Trace

Includes even more debug information as it dumps a lot of data in the log. This setting effects performance.