Windows installer

Installing and uninstalling frePPLe is straightforward. After accepting the license agreement, the installer will guide you to select:

• The components to install

• The installation directory

• The license file, applicable only for the Enterprise Edition

• The language and database connection parameters

• Whether or not to register the server as a service

The installer is 64-bit and has been tested on Windows 7, Windows 8 and Windows 10.

1. Start the installer

   

2. Accept the license agreement

   FrePPLe is released with a dual license: you can choose either to apply the GNU Affero General Public License (aka AGPL) or to buy a commercial license.

   

3. Select the installation directory

   A different location is selected depending on the user name.

   

4. Select the license file

   The Enterprise Edition requires a license file to be activated. You get the license file when you register your copy on the support section of the website.

   The license file contains the customer name, validity date and licensed modules.

   

5. Select the components to install

   Optional extra components can be enabled.

   

   • Install and configure the PostgreSQL database.

     PostgreSQL 10 or higher is required by frePPLe. You can choose to use either 1) the postgreSQL included with frePPLe, or 2) install and configure PostgreSQL yourself (advanced users only).

     If you choose to download and install PostgreSQL manually please follow these instructions:

     1. Cancel the frePPLe installer and restart it again after the postgreSQL installation is done.

     2. Download and run the postgreSQL installer.

     3. Use the PgAdmin administration tool to create a login role for frePPLe.

        If you intend to use the default login role “postgres”, you can skip this step.

        See http://www.postgresqltutorial.com/postgresql-roles/ for detailed steps.
     4. Use the PgAdmin administration tool to create a database for frePPLe.

        Make sure to assign the login role created in the previous step as the owner.

        See http://www.postgresqltutorial.com/postgresql-create-database/ for detailed steps.
     5. Database connection parameters

        If you are upgrading frePPLe you should copy the following from the old custom/djangosettings.py to the new custom/djangosettings.py
        • Default language for the user interface
        • Database connection parameters
     Advanced administrators can further fine-tune the database instance.

     For a simple trial installation, you want to skip this.
     • FrePPLe assumes that the database uses UTF-8 encoding.

       FrePPLe needs the following settings for its database connections. If these values are configured as default for the database (in the file postgresql.conf) or the database role (using the ‘alter role’ command), a small performance optimization is achieved:

       client_encoding: 'UTF8',
       default_transaction_isolation: 'read committed',
       timezone: 'UTC' when USE_TZ is True, value of TIME_ZONE otherwise.
       

     • The default configuration of PostgreSQL is not configured right for intensive use.

       We highly recommend using the pgtune http://pgtune.leopard.in.ua/ to optimize the configuration for your hardware.

6. Select the installation parameters

   If you chose to install the database from the frePPLe installer, two types of parameters will be specified during the installation:

   1. Default language for the user interface

   2. Database connection parameters

      You will not be able to the next screen when a test connection to the database fails, or if you followed the regular install.

   

   Your selections are saved in the file custom/djangosettings.py. The file can later be edited with a text editor.

7. Installation

   During the actual installation you can see the list of installed files, and monitor the creation of the database schema.

   

8. Finish

   At the end of the installation you can choose to start the server immediately.

   For a test or development installation it is recommended to run the server as a system tray application.

   For an installation in production mode AND when you have administrator rights on your computer, you can chose to register and start a service instead (currently in development).

   

9. Start the server

   FrePPLe’s user interface is web-based. You need to start the web server first in one of the following ways:

   1. Either it was already started at the last step of the installation process.

   2. Select “Run frePPLe server” from the program menu to start the web server in the system tray. If you’re new to frePPLe, this method is preferred.

   3. Select “Start Service” from the program menu or the Windows service manager. This option is available only when you choose to register a service during the installation.

   FrePPLe in the system tray:

   

   FrePPLe as a service:

   

1. Open your browser http://localhost:8000/

   You can type in the URL manually or double click the system tray icon.

   An administrator user account is created initially: admin with password admin.