The instructions on this page apply to the on-premise installation and setup of the Bizzdesign Horizzon platform for Windows. If you are using a Linux-based version of Horizzon, download the latest installation bundle including instructions from the Bizzdesign Support portal.

Installation and setup should only be done by application administrators who are familiar with installing and configuring software and databases.

For updating your Bizzdesign Horizzon to a newer version, please refer to Updating to a new Bizzdesign Horizzon release.

On this page:

Downloading the software

The latest installer files for Bizzdesign Horizzon for Windows can be downloaded from the Bizzdesign Support portal.

Installing and setting up a Horizzon Server

Before you start installation, make sure that you have installed Java and PostgreSQL. See also the software requirements.

Installing the database

The Horizzon Server runs on a PostgreSQL database. Create a new empty PostgreSQL database.

Installing the Horizzon Server

After installing the database, follow the procedure below to install the Horizzon Server.

1. Unzip the Horizzon Server installer file to a location on the hard drive where the Horizzon Server must be installed. You are strongly advised to install the Horizzon Server at the root of the drive, as shown in the figure below, because the installation path cannot be longer than 49 characters, including the HorizzonServerHome installation folder.
   
   
   
   

2. In the HorizzonServerHome\conf folder, open the server.wrapper.conf file in a text editor, and configure one or more of the parameters below.
   
   Each parameter has a property name which starts with 'wrapper.java.additional.n'. The 'n' component is an integer number counting from 1. Make sure that each parameter you use is unique. By default, the numbering should be in sequence without gaps.
   
   

   HTTP port	Update the HTTP port under which the server must be running. By default, port 9000 is set. You can choose your own port by editing the port number: wrapper.java.additional.2 = -Dhttp.port=9000
   JVM memory settings	Optional. If desired, set your own JVM memory settings. Set the initial size (xms) and max size (xmx). Make sure to remove the # from the line in order to activate a parameter. wrapper.java.additional.3 = -Xms <initial size> m Set the initial size to at least 768 MB. Example:  wrapper.java.additional.3 = -Xms768m wrapper.java.additional.4 = -Xmx<max size>m The max size depends on how much memory you want to allocate. Make sure to leave some memory left for other applications and the OS. Example: wrapper.java.additional.4 = -Xmx2048m
   Use HTTPS instead of HTTP	Optional. If you want to use HTTPS instead of HTTP, please refer to Using an official HTTPS certificate for the Horizzon Server, and follow the instructions.
   Horizzon Server log rotation	Optional. The Horizzon Server logs contain technical information about events when running the Horizzon Server. By default, the logs will be rolled based on the size of the log file with a maximum of 10 MB, and a maximum of 10 files will be kept. If you want to use log rotation with different limits, or configure log rotation based on date, please refer to Configuring Horizzon log rotation, and follow the instructions.

3. Save the changes and close the file.
   
   

4. Open the application.conf file, and set the following:
   
   

   Application settings	Set the computer name of the server and the port number. If you use a different port than the default 9000, enter the port number that you previously have set in the server.wrapper.conf file. teamServiceUrl=" http://localhost:9000 "
   Configure secret key	Set the secret. Use a random string of 16 characters or more. play.http.secret.key = "Secret"
   E-mail settings	The Horizzon Server needs to send e-mail messages in various situations, for example, to newly invited users so they can create an account. But also in case of expired licenses or if users want to reset their password. Configure the necessary settings. hostname = "127.0.0.1" port = "25" isAuthRequired = "false" username = "userName" password = "password" sender = "noreply@company.com" security = "none" The options for isAuthRequired are "true" or "false". The options for security are "none", "SSL", "TLS", or "SSLTLS".
   Configure database connection	Configure the PostgreSQL database settings. Replace the default values with your data. # Configuration of PostgreSQL database db { default { driver = org.postgresql.Driver url = "jdbc:postgresql://localhost:5432/database-name" username = "Username" password = "StrongPassword" } } Replace localhost with your database location, and database-name with the name of your database. Replace Username and StrongPassword with the appropriate values.
   Allow newer postgres version	By default, the PostgreSQL version as mentioned in the system requirements is enforced. To allow usage of a newer PostgreSQL version, remove the # from the following line. # database.allowNewerVersion=true
   Optional settings	Prepared working copy First-time opening of large model packages that are stored on the Horizzon Server (shared model packages) can be time-consuming. To reduce loading times, the preparedWorkingCopy setting can be enabled. For more information and instructions, please refer to Reducing the loading time of first-time opening of shared model packages. Check for breached password By default, Horizzon performs a security check on passwords Horizzon users set. The URL mentioned in the application.conf file is used for checking on breached passwords. If you do not wish this check to be performed in Horizzon, set the following setting to false: passwordPolicy.breaches.checkEnabled = true

5. Save the changes and close the file.
   
   

6. Verify that the Horizzon Server is correctly configured:
   
   
   1. In the HorizzonServerHome\bat folder, run the runServer.bat file. It is finished when you see the text 'Listening for HTTP on ....' appear. When it is finished, leave the Command prompt open.
      
      If the Command prompt automatically closes, then an error has occurred during the execution. Check the server.log file in the logs folder for any errors. If you are not able to interpret the errors yourself, please send the log file to Bizzdesign Support.
      
      
      
      
   2. Open your web browser and point locally to http://servername:portnumber . Replace servername with the name of the computer you are installing the server on and replace portnumber with the specified port number. You should see the Horizzon Server setup page:
      
       
      If the page is not displayed immediately, refresh it.
      
      
7. If everything is running correctly, close the web page. Press Ctrl+C in the Command prompt to stop the Horizzon Server, type Y and press Enter to terminate the batch job and close the window.
   
   
8. Run the generateSchedule.bat file (located in the HorizzonServerHome\bat folder). After finishing a new file schedule.ps1 is present in the bat folder.
   
   
9. Right-click the schedule.ps1 file and select Run with PowerShell. This file is used for scheduling tasks in the Horizzon Server database, which will be processed by the Horizzon Worker.
   
   
10. Verify that the Horizzon Worker is correctly configured. In the HorizzonServerHome\bat folder, run the runWorker.bat file. The Command prompt that opens should show the information similar to the following:
    
    
    
    If the Command prompt automatically closes, then an error has occurred during the execution. Check the worker.log file in the logs folder for any errors. If you are not able to interpret the errors yourself, please send the log file to Bizzdesign Support.
    
    
11. If everything is running correctly, press Ctrl+C in the Command prompt to stop the Horizzon Worker, type Y and press Enter to terminate the batch job and close the window.
    
    
12. Add the new Horizzon Server and Horizzon Worker services to the services by running the installServer.bat and installWorker.bat files located in the bat folder of the Horizzon Server installation.
    
    
13. Start the new Horizzon Server and Horizzon Worker services by running the startServer.bat and startWorker.bat files located in the bat folder of the Horizzon Server installation, or go to Control Panel > Administrative Tools > Services and start the services there.

Configuring the Windows firewall (optional)

Verify that the specified port number is open to other users. If not, configure your Windows firewall in order to make it accessible. Use Windows Firewall with Advanced Security to create a new incoming rule for the port by right clicking Inbound Rules and then clicking New Rule. Make sure you clear the Public check box in the list of network profiles while adding the new rule.

Setting up the Horizzon Server

After installing the Horizzon Server, set up the server and create the initial administrator user.

1. Open your web browser and enter the address the users will use to access the Horizzon Server. Example: http://bizzhorizzonserver:9000
   
   The Horizzon Server setup page appears.
    
2. Under Configure initial system administrator, create the initial system administrator user for the Horizzon Server.
   
   
   
   
3. Click Finish setup to complete the Horizzon Server setup.

Activating the license

1. Sign in to the Horizzon Server as a System Administrator user, and on the sidebar menu, go to Settings > License.
   
   

2. Copy the license key you have received from Bizzdesign, and paste it in License key.
   
   If you have not received a license key, please contact Bizzdesign Support.
   
   
   
   

3. Click Apply to save the changes.

If activation is successful, License status is set to 'Active', and Expires on shows an end date for the license.

Installing Enterprise Studio

Install Enterprise Studio on the computers on which it should run. To install Enterprise Studio, you must have administrator rights on that computer.

1. Save the Enterprise Studio installer file (zip) somewhere local to a temporary location.
   
   
2. Extract the zip file and double-click the EnterpriseStudioSetup.exe file to start the installation.
   
   
3. The installation wizard starts. If you want to install Enterprise Studio on a different location than the default, or if you want to deactivate file associations with Enterprise Studio, click Options and make the desired changes before you proceed. Otherwise, follow the steps of the wizard.
   
    
   
   
4. After installation is complete, click Close.

To continue, each user requires a license, enabling him or her to work with Enterprise Studio. This license can be acquired by registering with the Horizzon Server.  Add users to the Horizzon Server (manually or via an identity provider) using the initial System Administrator user. Once users are registered with the Horizzon Server, they can download the Horizzon Server configuration file and add it to Enterprise Studio in order to receive a license and access to the Horizzon Server.