Installing InterFormNG2 on Windows

Installing InterFormNG2 on Windows

Installing InterformNG2 on Windows:

A video, that covers the installation on the Windows platform is included below:



 

In order to install, you first need to unzip the distribution file, and then run the unzipped installation file. Now you will see these screens:

 

NG2WinInst0001

Click Next on the screen above.

 

You need to accept the agreement in order to be able to proceed:

 

NG2WinInst0002

 

Now state the place where InterFormNG2 should be installed. The path below is suggested:

 

NG2WinInst0003

 

The next screen asks for the path for where data files and configuration files should be placed.

 

NG2WinInst0004

 

The default path is:

C:\Program Data\InterFormNG2

(Please check/correct the exact path in your installation).

 

Before you go with the suggested path above: Please notice, that the ProgramData folder often is a hidden folder, so you may need to change the view in MS Explorer in order to see this. You can e.g. chose to ‘unhide’ it, or decide to ‘display hidden folders’.

 

Please make sure if this path is OK and change it if needed. You will need to use this path whenever InterFormNG2 is exchanging files e.g. XML files, so a more simple path may be a good idea. The selected path is referenced as {INTERFORMNG2_HOME} in this manual and is stored as the environment variable, INTERFORMNG2_HOME.

 

Next you need to decide if you want to connect to InterFormNG2 with http (unsecure) or https (secure):

 

NG2WinInst0005

 

If you select https you need to consider the certificate to be used, and the next screen is shown (only if you select https above):

 

The details are covered here.

 

NG2WinInst0006

 

 

The next screen specifies what name to use for InterFormNG2 in the Start menu folder:

 

NG2WinInst0007

 

Click Install on the last screen to start the installation:

 

NG2WinInst0008

 

When the installation is done this screen is shown:

 

NG2WinInst0009

 

Before starting the InterFormNG2 process, you should consider what port number to use, when accessing InterFormNG2. The default port number is 8086, so that you can access InterFormNG2 locally via either:

 

https://127.0.0.1:8086 or http://127.0.0.1:8086 - depending on if you have activated https or http in the install screen above.

 

Here you can sign on for the first time.

 

Now you might need a license code for InterFormNG2.

 

Request and installation of a license code is covered here: The license code.

 

If required you can setup InterFormNG2 to run under a specific user. This might be necessary to give InterFormNG2 access to folders on other machines like IFS on an AS400.

 

Application-default.properties on Windows

The application-default.properties is the file, that contains the main configuration of the InterFormNG2 installation. On the Windows platform you can find this file in the directory: C:\Program Files\InterFormNG2. For some special configuration you might need to edit this file. You can edit it with a simple text editor like notepad or notepad++.

 

RAM usage

InterFormNG2 runs as default with 4Gb RAM, but if InterFormNG2 is processing very large files (or running multi-tenant), then it might be a good idea to increase the usage to 8Gb RAM. This is covered in this section.

 

 

Temporary folder for Windows work files

From version 2.4.0 the default folder, that is used for temporary work files (on the Windows platform) is: {{env:INTERFORMNG2_HOME}}/temp.

 

It is possible to set another folder to be used for work files. You can setup such a directory, if you create a new file named: NG2.exe.vmoptions in the directory: C:\Program Files\InterFormNG2 with the contents: -Djava.io.tmpdir=<DIR>, where <DIR> is the directory, that you want to use for the temporary work files.

 

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.

Run the InterFormNG2 service under a specific user:

On the Windows platform you can choose to run the service under a specific user. This might be required, if you e.g. want to monitor an IFS folder on an AS400 on the Windows platform.

 

In order to change the user for the InterFormNG2 service you need to start the services application:

 

NG2Services0001

 

If you right click on the InterFormNG2 Service and then select Properties like above, then you can choose to assign a specific user for this service:

 

NG2Services0002

 

You just need to select 'This account' like above and then type in the user and password. You need to restart the service to activate the change.


    • Related Articles

    • Installing InterFormNG2 on IBM i

      Installing InterformNG2 on IBM i: Installation of InterFormNG2 on the IBM i platform is described below. Please notice the prerequisites - especially for OS400 and Java 8. You can also view this video: Please refer to Spool2XML for details regarding ...
    • Installing the preview client

      As an aid to the designer you can choose to install a preview client. The preview client works together with the designer and constantly merge the current template with the selected sample file in the designer. The preview client can e.g. be used, if ...
    • Installing InterFormNG2 on Linux

      The following is a suggestion on how to set up InterFormNG2 on Linux. This has been tested on Ubuntu v20 and it also runs on e.g. Red Hat Linux 8, as long it is not the headless version. Run as a service with systemd (HTTPS version) If not already ...
    • Read from Windows share

      You can setup InterFormNG2 to read input files from a folder found via Windows share (Samba network/UNC). For that you need to create a workflow with the input type, Read from Windows share. This can e.g. be useful, if you want to monitor a folder on ...
    • To Windows share

      If you want to store output files e.g. PDF files generated by InterFormNG2, then you have many options. One of them is the To filesystem. If you want to store an output file onto the file system of another machine, then you can e.g. consider to e.g. ...