frePPLev2.0
open source Production PLanning
  • Home
  • Documentation
    • Getting started
    • Modeling guide
    • User guide
    • Installation guide
    • Developer guide
    • FAQ
  • C++ API

Windows installer

Installing and uninstalling frePPLe is straightforward, and follows the normal Windows conventions.

After accepting the license agreement, the installer will guide you to select:

  • The components to install
  • The installation directory
  • The license file
  • The language and database connection parameters
  • Whether or not to register the server as a service

Depending on the selected options the installation requires between 30 and 60 MB of disk space.

The installer has been tested on Windows XP, Windows 7 and Windows 8.

  1. Prior to the installation, it is recommended (but not absolutely required…) to uninstall any previous version.
  2. Start the installer

  3. 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.
    See this section of the documentation for more details.

  4. Select the type of installation.
    If you have administrator rights on your computer, the installer will allow you choose to install frePPLe for your account only or for anybody logging in on the machine.
    If you don’t have administrator rights, this screen will automatically be skipped. Nothing to worry about.

  5. Select the installation directory.
    A default location is selected depending on the installation type.

  6. 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.
    To use the community edition you can leave this field empty. A default license file will be installed.

  7. Select the components to install.

  8. Select the installation parameters.
    Two types of parameters are specified during the installation:

    • Default language for the user interface
    • Database connection parameters

    FrePPLe supports the MysSQL, PostgreSQL 8, SQLite and Oracle 11g databases. The installer will detect which of those you have installed on you computer and allow you to choose one. The SQLite database is included with frePPLe, allowing you to get started very quickly.

    For MySQL, Oracle 11g and PostgreSQL 8 you need to specify the database name, the database user and its password, and the host and port number of the database engine. The database and the database user have to be created by the database administrator. The frePPLe database tables will be created when you first start the server.
    Make sure the database user has been created and has been granted sufficient privileges to create tables and indexes.

    For SQLite you only need to specify the database name.

    You selections are saved in the file freppledb/settings.py. The file can later be edited with a text editor when required.

  9. Installation
    During the actual installation you can see the list of installed files.

  10. 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 from the console.
    For an installation in production mode AND you have administrator rights on your computer, you can chose to register and start a service instead.

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

    • Either it was already started at the last step of the installation process
    • Select “Run Server” from the program menu to start the web server in a console window.
      If you’re new to frePPLe, this method is preferred.
    • Select “Start Service” from the program menu to run the server as a windows server. This option is available only when you choose the option to register a service during the installation.
    • Start the service from the windows service manager. Also this option is only valid if you choose to register the service during installation.

    Point your browser to the URL shown in the server window, and you’re up and running!

  12. Optional extra step: Install GraphViz
    To display a graphic representation of the supply chain, frePPLe uses graphViz: see this page for an example.
    To enable this functionality you need to install the GraphViz package from http://www.graphviz.org.

It is possible to have multiple installations in parallel on the same computer. They obviously need to be installed in different directories, and you need to set the environment variable FREPPLE_HOME to point to the directory with the version you want to run. Only one of them can be registered as a service.

    • Getting started
    • Modeling guide
      • Simplified domain model
      • Detailed domain model
      • Environment variables
      • Python interpreter
      • Global parameters
      • Buffer
      • Calendar
      • Customer
      • Demand
      • Flow
      • Item
      • Load
      • Location
      • Operation
      • Suboperation
      • Operationplan
      • Problem
      • Resource
      • SetupMatrix
      • Skill
      • Resource skill
      • Solver
      • Extension modules
        • Forecast module
        • REST web service module
        • Linear programming solver module
        • OpenERP connector module
    • User guide
      • Main features
      • Supported browsers
      • Getting around
        • Logging in
        • Logging out
        • Changing password
        • Navigation
          • Menu bar
          • Jump search
          • Context menus
          • Browser bookmarks
        • Filtering data
        • Sorting data
        • Selecting time buckets
        • Exporting data
        • Importing data
        • User preferences
        • User permissions and roles
      • Screens
        • Data input
        • Supply Path / Where Used
        • Comments
        • History – Audit trail
        • Plan analysis
          • Problem report
          • Constraint report
          • Inventory report
          • Inventory detail report
          • Resource report
          • Resource Gantt report
          • Resource detail report
          • Operation report
          • Operation detail report
          • Demand report
          • Demand detail report
          • Demand Gantt report
          • Forecast report
          • Performance indicator report
        • Execute
      • Batch commands
        • manage.py (manage.exe on Windows)
        • frepple (frepple.exe on Windows)
        • freppleservice.exe (Windows only)
    • Installation guide
      • Windows installer
      • Compiling on Windows
      • Linux binary packages
      • Compiling on Linux
      • Compiling on debian-based linux
      • Compiling on Red Hat based Linux
      • Compiling from the subversion source code repository
      • Running the VMWare virtual machine
      • Other platforms
      • Configuring the user interface
      • Configuring multiple models in the user interface
      • Configuring as a Python extension module
    • FAQ
    • Developer guide
      • Code structure
      • Class diagram
      • Solver
        • Solver features
        • Planning algorithm
          • Top level loop
          • Demand solver
          • Buffer solver
          • Flow solver
          • Load solver
          • Operation solver
          • Resource solver
        • Cluster and level algorithm
      • Extension modules
      • Version control
      • Style guide
      • Portability
      • Security
      • Internationalization
      • Translating the user interface
      • Adding or customizing a report
      • Unit tests
        • buffer_procure_1
        • calendar
        • callback
        • cluster
        • constraints_combined_1
        • constraints_combined_2
        • constraints_leadtime_1
        • constraints_material_1
        • constraints_material_2
        • constraints_material_3
        • constraints_material_4
        • constraints_resource_1
        • constraints_resource_2
        • constraints_resource_3
        • constraints_resource_4
        • constraints_resource_5
        • datetime
        • deletion
        • demand_policy
        • flow_alternate_1
        • flow_alternate_2
        • flow_effective
        • forecast_1
        • forecast_2
        • forecast_3
        • forecast_4
        • forecast_5
        • forecast_6
        • jobshop
        • load_alternate
        • load_effective
        • lpsolver_1
        • multithreading
        • name
        • operation_alternate
        • operation_available
        • operation_effective
        • operation_pre_post
        • operation_routing
        • pegging
        • problems
        • python_1
        • python_2
        • python_3
        • safety_stock
        • sample_module
        • scalability_1
        • scalability_2
        • scalability_3
        • setup_1
        • setup_2
        • skill
        • xml
        • xml_remote
    • License
      • GNU Affero General Public License
      • GNU Free Documentation License
    • Third party add-ons
  • Copyright © 2010-2013 frePPLe bvba