Install the server software

  • Updated on Aug 8, 2025
  • Published on Jul 20, 2023
  • 3 minute(s) reading time
Prev Next

This article explains how to install the IXM Server software.

Prerequisites

Before you begin the IXM server installation, please note the following information:

  • The URL you use as the hostname for the IXM One website should not change. Changing this URL will require regenerating all licenses.

  • If you use a load balancer, you can install web services on multiple servers. However, for proper performance, you must install all features except the optional SecureDownloadModule.

  • You can run everything on one server or distribute the installation across multiple servers. However, note that the following components belong together:

    • MainServerPath and StandardFonts

    • Web Services

    • Services

Install the IXM Server

Note

Starting with version 11.17, connection strings must include ;TrustServerCertificate=True. This is only not required if a custom trusted certificate has been configured on the SQL Server.

To install the IXM Server using the installer, perform the following steps:

  1. In the server installation folder, right-click on the file Grassfish IXM Server and select Run as administrator.

  2. Select your setup language from the dropdown menu.

  3. In the Welcome to the Prerequisites Setup Wizard window, click Next.
     

  4. Select which prerequisites to install based on your setup.
     

  5. Click Next. The installer now installs the prerequisites which may take a few moments.

  6. In the Setup Wizard window, click Next.

  7. Under Product install, select the directory where you want to install all Grassfish services.
     

  8. Click Next.

  9. Select the features that you need to install depending on your server. Note that you must select all features if you are running everything on one server.
     Different feature selection for different servers.

  10. Click Next.

  11. For the connection string, use the information that you specified when creating the database. The script automatically creates the user globalVision.
    Example: Server=(local)\SQLExpress;Database=GV2_Base;User ID=globalVision;Password=ABC123!;TrustServerCertificate=True;
     

  12. Click Next. The installer now checks if the connection string is valid which may take a few moments.

  13. Once the database is connected, the system compares the database version to the installer version. Click Next.

  14. For the connection string of the reporting database, use the information that you specified when creating the database. The script automatically creates the user globalVision.
    Example: Server=YOUR_SERVER;Database=GenericReporting;User ID=globalVision;Password=globalVision;TrustServerCertificate=True;

  15. Click Next. The installer now checks if the connection string is valid which may take a few moments.

  16. As soon as a connection with the database has been established, you’ll see a confirmation. Click Next.

  17. Under Services, select the service prefix. You can find all Grassfish services in Windows Services with the prefix GV2.
     A screenshot of a computer  Description automatically generated with medium confidence

  18. Under Specify user account information, select one of the following options:

    • Local Service: Use the current account information. This should suffice if all services and the storage run on the same server.

    • Custom: Enter the username, domain, and password of a custom user.

  19. Click Next.

  20. Specify the Host Name to determine how to request the IXM One website in one of the following ways:

    • Enter the computer name in the format: http://myserver

    • Enter the IP address in the format: http://192.168.1.1

    • Enter a public domain name in the format: http://grassfish.company.com

  21. Specify the Main Server Path, in one of the following ways:

    • If web components are installed on a different server, enter that server’s path.

    • If you use one individual server, enter the product install path as in step 8.
       A screenshot of a computer  Description automatically generated with medium confidence

  22. Click Next.

  23. Select the following settings for IIS:

    Setting

    Description

    Website

    Specify a new name or select an existing website:

    • As a new name, we recommend a descriptive name. The system will automatically create a new web site and application pool.

    • We don’t recommend using the standard value default web site.

    • The installer only configures new components. If you select an existing website, ensure that it’s configured correctly.

    Application Pool

    Specify a new name or select a name from the existing application pool:

    • We recommend using a descriptive name.

    • The installer only configures new components. If you select an existing application pool, ensure that it’s configured correctly.

    Set IIS data folder to

    Select this option to create a virtual directory for the data directory.

    Set IIS log folder to

    Select this option to also store IIS logs in the GVServer2 directory.

    We recommend this because the Grassfish software has a log cleanup service that is only active within the GVServer2 structure.

  24. Click Next.

  25. Select Install to start the installation process.

  26. Click Complete to finish the installation process.

Check functionality and import licence

Once the installation is complete, log in to IXM One to check if the server was configured correctly and to import your licenses.

Perform the following steps:

  1. Navigate to the IXM One website.

  2. Select your language and log in with your user account.

  3. Upon the first login, you must change your password. If your login is successful, the server is configured correctly.

  4. In IXM One, go to Administration > Global > Licenses to import your licenses.

Note

The initial login is: {CUSTOMERCODE} / admin / grassfish ?

The customer code is the code specified during database setup. The default password must be changed after the first login.