Settings for system

Settings for system

There are two kinds of system settings for InterFormNG2:

1. The most of the system settings are setup via the web interface as described as the first thing below.
2. Other special system settings are set via configuration files followed by a restart of the InterFormNG2 service. These settings are described in the bottom of this section.

Other global administrative options like System log, system monitor, licensing and backup are covered in the section, System administration.

System settings setup via the web interface

The settings for the whole InterFormNG2 system can only be seen/changed, if you are registered as a system administrator.

 

The section below concerns the global system settings. Tenant settings are also available.

 

In order to access these settings you need to select the System Admin folder, after you have signed on:

(If you cannot see the System Admin folder as shown below, then your profile is not a system administrator)


  

After you have selected this, then you will see a limited dashboard. To change the settings you select the Settings tab in the top:


  

Then you will see this drop down list:




If you click the General Settings, then you will see these settings:


Each option is linked below:

  1. Resources
    Github server This might be referenced for tenant repositories.
    Database Resources This is used, if you want to store the settings and resources of InterFormNG2 in a database.

          


System settings setup via configuration files

Not all system settings can be setup via the web interface as described above. Some can only be setup in configuration files.

The configuration file application-default.properties

The main configuration file for InterFormNG2 is the file: application-default.properties
On the Windows platform it is found in the folder: C:\Program Files\InterFormNG2 and on the IBM i platform it is stored in the IFS folder: /iformng2/InterFormNG-shell/Core

The file is a simple text file and before editing the contents you should save a copy of the original contents and only use a simple text editor like e.g. Notepad or Notepad++ when the contents is edited.
You might need to save the changed file as a different name in a different folder and then later copy the file to the correct folder. 

Notes
Remember to restart the InterFormNG2 service to activate any changes done in the configuration files.

Below are lines, that you can consider to add to the configuration file, application-default.properties:

designer.preview.timeout.seconds=120
This line is an example of how you can change the preview time out of the designer. The default is 60 seconds. If you edit very large templates/outputs, then you can consider to increase this time out with the command above. The recommendation is however to only use smaller input files, that generates a few output pages e.g. 2 or 3. This will increase the time out to 120 seconds. This option is described in the section, Global designer settings.

enable.as400.commandLine=true
Add this line if you want to enable the use of the IFORMNG2/NG2CMD command on the IBM i platform to call a workflow in InterFormNG2.

enable.as400.functionality=true
If InterFormNG2 is installed on the IBM i platform, then you can insert this to enable functionality, which makes it possible for InterFormNG2 to connect to an IBM i machine and e.g. process spooled files from this machine.

server.port=8086
The default port number used by InterFormNG2 is 8086, which is setup with the line above. So the line above does not cause any change in InterFormNG2, but you can use the same command to change the port number used. If you e.g. add the line server.port=8081 (or change it to this port number), then the used port number will be 8081 instead of 8086.

Store settings and resources in a database
If you want to store setting and resources in a database, then application-default.properties should be changed according to the descriptions in the section, Storing settings and resources in a database.

HTTPS enabling
Please refer to the section, Https enabling for details.

Configure a remote client
This is covered in this section.

High Availability setup
The section, High Availability setup covers this.

pdf.forceBarcodeDPI=600
The resolution/DPI of the PDF output is normally set on the template element inside the used template, but with this line you can force InterFormNG2 to use another resolution for all output PDF files generated by InterFormNG2. Here this is forced to 600 DPI.

file.overwriteChangesOnly=true
If this line is added to the application-default.properties file, then InterFormNG2 will avoid any unnecessary saves of templates. This will allow you to open a template and change the contents of a referenced template component and if you save the template, then only the changed template components are saved - not the main template.  The template will only be saved if the contents of the template has changed or if another sample file has been loaded. 

authentication.login.forceScheme
When using the built-in authentication and user management, the application will do a webservice call on itself during the login process for the web interface. This call will try to auto-detect the correct protocol scheme to use (HTTP or HTTPS). In some network configurations, the scheme may be incorrect.
With the application property authentication.login.forceScheme, the scheme can be set to a specific value, overriding the auto-detected one.
For example to force the scheme to HTTP you should add this line in the application-default.properties file:
authentication.login.forceScheme=http
 

The configuration file NG2.exe.vmoptions

Another configuration file is the file, NG2.exe.vmoptions. This file is not shipped with InterFormNG2, but you can create the file yourself as a simple text file. You should edit the contents with a simple text editor like Notepad or Notepad++. This is a configuration file for the Windows platform only. You should create the file in the directory C:\Program Files\InterFormNG2 (or the selected program files folder if another directory was selected during installation).

Notes
Remember to restart the InterFormNG2 service to activate any changes done in the configuration files.

Below are text lines, that you can add to this configuration file:

-Djava.io.tmpdir=<DIR>
where <DIR> is the directory, that you want to use for the temporary work files. The normal directory used is: {{env:INTERFORMNG2_HOME}}/temp (which with a default setup selects the directory: C:\ProgramData\InterFormNG2\temp. If the folder with the temporary work files are stored within {{env:INTERFORMNG2_HOME}} then the directory will be cleared during startup of the InterFormNG2 service.

-Djavax.net.ssl.trustStoreType=WINDOWS-ROOT
If you add this line to the NG2.exe.vmoptions file, then InterFormNG2 will trust any certificate, that is trusted by Windows.

-Dfile.encoding=UTF-8
For Schematon validation of XML files it can be necessary to setup the default file encoding to be utf-8. That is done with the line above.

-Xmx<Size>
This command can be used for setting the maximum heap size for InterFormNG2, where <Size> is the size, that you want to set. The line: -Xmx4g sets the heap size to 4Gb and -Xmx8g sets the heap size to 8Gb.

    • Related Articles

    • Settings

      The settings of InterFormNG2 are set in two levels: Settings for system level. These settings are used globally on the InterFormNG2 installation - for all tenants. Settings for tenant. These are the settings for one specific tenant/environment. It is ...

    • Global system settings

      This section concerns advanced system setup for InterFormNG2. In order to setup the global system settings, you first need to sign in as described here. Then you click System on the left below Other: Then you see this: The options are: Environment ...

    • Performance settings

      You can edit the system performance settings, if you sign on to InterFormNG2 as a system administrator. If you want to change tenant throttling setup or the cache settings for InterFormNG2, then you can now click the Performance option in the bottom ...

    • System administration

      The system administration for the complete InterFormNG2 system can only be seen/changed, if you are registered as a system administrator. The section below concerns this system administration. For system level settings you should consult the section, ...

    • Other global settings

      The other global system settings are: Global system settings. Performance settings.