Skip to end of metadata
Go to start of metadata

The information on this page applies to the Enterprise Studio release 4 - 4 February 2021. If you are installing an older version, please contact BiZZdesign support.

Team Server is now called HoriZZon Server. While the new name is being implemented in the software and on the Support pages, the old name may still be visible in places until the process is completed. See also Team Server is now HoriZZon Server.


The instructions on this page apply to the on-premise installation and setup of Enterprise Studio and HoriZZon Server. For updating an existing Enterprise Studio to a newer version, please refer to Updating to a new Enterprise Studio release.

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


On this page:


Downloading the software

The latest installer files can be downloaded from the BiZZdesign Support site.

Installing and setting up a HoriZZon Server

Before you start installation, make sure that you have installed Java and Microsoft SQL Server or PostgreSQL, depending on the type of database you are going to use. See also the software requirements.

Installing the database

The HoriZZon Server can run on a Microsoft SQL Server or PostgreSQL database; use of PostgreSQL is highly recommended.

  1. Create a new empty SQL Server or PostgreSQL database.

  2. Create a database user having at least read and write rights for the created database. The user needs the "db_owner" role.

Configuring network access for SQL Server

Perform this procedure only if you have installed an SQL Server database.

Enterprise Studio uses the network to connect to an SQL database, even when it is locally installed. The following steps must be performed to successfully connect to the SQL Express database.

  1. Open the SQL Server Configuration Manager.

  2. In the SQL Server Configuration Manager window, expand the SQL Server Network Configuration and click Protocols for SQLEXPRESS, or something similar if your are using a different SQL.

  3. In the list of protocols for SQLEXPRESS, right click TCP/IP, and then click Enable.



  4. Right click TCP/IP once again and subsequently click Properties.

  5. Click the IP Addresses tab and scroll down to IPAll. Set the TCP Port, for example to 1433.



  6. In the SQL Server Configuration Manager window, select the SQL Server Services and restart SQL Server (SQLEXPRESS) by right clicking it and then clicking Restart.

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. The structure of your HoriZZon Server installation should look similar to this:



  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 HTTPOptional. 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. Open the application.conf file, and set the following:

    1. In the section "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 wrapper.conf file.

      teamServiceUrl="http://localhost:9000"

    2. In the section "Configure secret key", set the secret. Use a random string of 16 characters or more.

      play.http.secret.key = "Secret"

    3. In the section "Configure database connection", select the database type you are using, remove the # from the lines of the complete database connection string, and replace the default values with your data. The following database connections are available:

      db {
        default {
          driver = com.microsoft.sqlserver.jdbc.SQLServerDriver
          url = "jdbc:sqlserver://localhost:1433;databaseName=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.

      If you use a Microsoft SQL Server database and you want to log in using an SQL account, make sure that it allows SQL logins. You can check this as follows: start Microsoft SQL Server Management Studio, right-click the server, and select Properties. Under Security, make sure that the server authentication option SQL Server and Windows Authentication mode is selected.


      When using integrated security, the HoriZZon Server will try to sign in to the database using the credentials of the user running the HoriZZon Server.

      If you decide to use integrated security, you are advised not to use a personal account. Instead, use a separate IT service account.

      db {
        default {
          driver = com.microsoft.sqlserver.jdbc.SQLServerDriver
          url = "jdbc:sqlserver://localhost:1433;databaseName=database-name;integratedSecurity=true"
          }
      }


      Replace
      localhost with your database location, and database-name with the name of your database.

      If you are using the JDBC driver, follow these steps:

      1. Download the mssql-jdbc_auth.zip  file from https://github.com/microsoft/mssql-jdbc/releases/tag/v8.2.0 to connect the JDBC driver to the database.

      2. Unzip the file, and copy the appropriate dll file to a directory on your Windows system path, for example C:\Windows\System32 or ..\Program Files\Java…
        Ensure that the dll is loadable by Java by placing the dll in a directory listed in the java.library.path system property. On Windows, this is set to the value of the PATH environment variable. Additional instructions are located at https://docs.microsoft.com/en-us/sql/connect/jdbc/building-the-connection-url?view=sql-server-ver15#Connectingintegrated.

      3. After that, restart the system.

      4. Make sure the login user for the HoriZZon Server Service has rights to be able to access the database and HoriZZon Server. Per default your service will be added as "local system" account. It might be necessary to change this login for a user who has access to those components.
      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.


    4. Optional: 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 in the application.conf file. For more information and instructions, please refer to Reducing the loading time of first-time opening of shared model packages.

    5. Save the changes.

  4. Verify that the HoriZZon Server is correctly configured:

    1. In the HoriZZonServerHome\bat folder, run the runServer.bat file. When it's finished, leave the Command prompt open.

      You may see some error messages in the window, these will be resolved after completion of the HoriZZon Server setup.



      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.

  5. 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.

  6. Run the generateSchedule.bat file (located in the HoriZZonServerHome\bat folder). After finishing a new file schedule.ps1 is present in the bat folder.

  7. 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 BiZZdesign Worker.

  8. 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.

  9. 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.

  10. 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.

  11. 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 HoriZZon Server identity, identify the installed server by entering a display name.



  3. Under Configure e-mail settings , specify the e-mail settings for the HoriZZon Server.



  4. Test the e-mail settings. In Recipient, fill out an e-mail address that is outside your mail server domain, and then click Send test e-mail.



  5. Under Configure initial system administrator, create the initial system administrator user for the HoriZZon Server.



  6. 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 in 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.

During installation of Enterprise Studio you will be prompted to close all open applications. If you leave applications open, unsaved data may be lost.

  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.