--- title: "Install the server software" slug: "install-server-software" tags: ["Server"] updated: 2026-09-21T10:56:32Z published: 2026-09-21T10:56:32Z canonical: "docs.grassfish.com/install-server-software" excludeFromExternalSearch: true --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.grassfish.com/llms.txt > Use this file to discover all available pages before exploring further. # Install the server software 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] > 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. ![Grassfish IXM One setup wizard displaying language selection options for installation.](https://cdn.document360.io/e2b87f73-d9f5-43cb-8182-2641762664fd/Images/Documentation/installer_1.png?sv=2026-02-06&spr=https&st=2026-10-26T10%3A39%3A00Z&se=2026-10-26T11%3A39%3A00Z&sr=c&sp=r&sig=8qOsMJYUiwJx0nOlfoMMYrgEuB8mFaZpvlhca8Sr51c%3D) 3. In the **Welcome to the** **Prerequisites Setup Wizard** window, click **Next**. 4. Select which prerequisites to install based on your setup. ![Installation prerequisites for Grassfish IXM One Server, including .NET and Visual C++ components.](https://cdn.document360.io/e2b87f73-d9f5-43cb-8182-2641762664fd/Images/Documentation/installer_3.png?sv=2026-02-06&spr=https&st=2026-10-26T10%3A39%3A00Z&se=2026-10-26T11%3A39%3A00Z&sr=c&sp=r&sig=8qOsMJYUiwJx0nOlfoMMYrgEuB8mFaZpvlhca8Sr51c%3D) 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. ![Installation folder selection for Grassfish IXM One Server Installer setup process.](https://cdn.document360.io/e2b87f73-d9f5-43cb-8182-2641762664fd/Images/Documentation/installer_4.png?sv=2026-02-06&spr=https&st=2026-10-26T10%3A39%3A00Z&se=2026-10-26T11%3A39%3A00Z&sr=c&sp=r&sig=8qOsMJYUiwJx0nOlfoMMYrgEuB8mFaZpvlhca8Sr51c%3D) 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. ![Comparison of web and backend server features in IXM One installer interface.](https://cdn.document360.io/e2b87f73-d9f5-43cb-8182-2641762664fd/Images/Documentation/installer_imp.png?sv=2026-02-06&spr=https&st=2026-10-26T10%3A39%3A00Z&se=2026-10-26T11%3A39%3A00Z&sr=c&sp=r&sig=8qOsMJYUiwJx0nOlfoMMYrgEuB8mFaZpvlhca8Sr51c%3D) 10. Click **Next**. 11. For the connection string, use the information that you specified when [creating the database](/grassfish/docs/create-the-database#create-the-database). The script automatically creates the user **globalVision**. Example: `Server=(local)\SQLExpress;Database=GV2_Base;User ID=globalVision;Password=ABC123!;TrustServerCertificate=True;` ![](https://cdn.document360.io/e2b87f73-d9f5-43cb-8182-2641762664fd/Images/Documentation/image-1778505686253.png?sv=2026-02-06&spr=https&st=2026-10-26T10%3A39%3A00Z&se=2026-10-26T11%3A39%3A00Z&sr=c&sp=r&sig=8qOsMJYUiwJx0nOlfoMMYrgEuB8mFaZpvlhca8Sr51c%3D) 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](/grassfish/docs/create-the-database#create-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](https://cdn.document360.io/e2b87f73-d9f5-43cb-8182-2641762664fd/Images/Documentation/image-1778505667893.png?sv=2026-02-06&spr=https&st=2026-10-26T10%3A39%3A00Z&se=2026-10-26T11%3A39%3A00Z&sr=c&sp=r&sig=8qOsMJYUiwJx0nOlfoMMYrgEuB8mFaZpvlhca8Sr51c%3D) 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](https://cdn.document360.io/e2b87f73-d9f5-43cb-8182-2641762664fd/Images/Documentation/image-1778505703681.png?sv=2026-02-06&spr=https&st=2026-10-26T10%3A39%3A00Z&se=2026-10-26T11%3A39%3A00Z&sr=c&sp=r&sig=8qOsMJYUiwJx0nOlfoMMYrgEuB8mFaZpvlhca8Sr51c%3D) 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] > 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.