<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> <title>Frepple / Windows installer</title> <link rel='stylesheet' href='../styles.css' type='text/css' /> <!--PageHeaderFmt--> </head> <body> <div id="container"> <div id="menubar"> <div id="logo" align="center"> <br/><img src='../frepple.bmp' alt="frepple" /><br/> <a href='http://www.frepple.com/'> <strong>a Free<br/>Production Planning<br/>Library</strong> </a></div> <div id="menu"> <br/> <h3><a href='../Main/HomePage.html'>Main</a></h3> <h3><a href='../UI/Main.html'>User Manual</a></h3> <h3><a href='../Tutorial/Main.html'>Tutorial</a></h3> <h3><a href='Main.html'>Reference Manual</a></h3> <h3><a href='../Main/FAQ.html'>FAQ</a></h3> <h3><a href='../reference/index.html'>C++ API</a></h3> <br/><div> </div> </div> </div> <div id="content"> <br/> <!--PageText--> <div id='wikitext'> <p><a class='wikilink' href='../Main/HomePage.html'>Main</a> > <span class='wikitrail'><a class='wikilink' href='Main.html'>Reference Manual</a> > <a class='wikilink' href='Installation.html'>Download and install</a> > <a class='wikilink' href='InstallationWindows.html'>Installing on Windows</a> > <a class='selflink' href='InstallationWindowsMSI.html'>Windows installer</a></span> </p> <p class='vspace'>Installing and uninstalling frePPLe is straightforward, and follows the normal Windows conventions. </p> <p class='vspace'>After accepting the license agreement, the installer will guide you to select: </p><ul><li>The components to install </li><li>The installation directory </li><li>The database connection parameters </li><li>Whether or not to register the server as a service </li></ul><p class='vspace'>With all options included the installation requires between 30 and 60 MB of disk space, depending on the selected options. </p> <div class='vspace'></div><ol><li><strong>Select the components to install.</strong> <div><img src='../uploads/Frepple/wininstall1.png' alt='' title='' /></div> <div class='vspace'></div></li><li><strong>Select the installation directory.</strong> <div><img src='../uploads/Frepple/wininstall2.png' alt='' title='' /></div> <div class='vspace'></div></li><li><strong>Select the installation parameters.</strong><br /> Two types of parameters are specified during the installation: <ul><li>Default language for the user interface </li><li>Database connection parameters </li></ul><div class='vspace'></div>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. <div class='vspace'></div>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.<br />Make sure the database user has been created and has been granted sufficient privileges to create tables and indexes. <div class='vspace'></div>For SQLite you only need to specify the database name. <div class='vspace'></div>You selections are saved in the file server/settings.py. The file can later be edited with a text editor when required. <div><img src='../uploads/Frepple/wininstall3.png' alt='' title='' /></div> <div class='vspace'></div></li><li><strong>Installation</strong><br /> During the actual installation you can see the list of installed files.<br /> <img src='../uploads/Frepple/wininstall4.png' alt='' title='' /> <div class='vspace'></div></li><li><strong>Finish</strong><br /> At the end of the installation you can choose to start the server immediately.<br /> For an installation in production mode, you can also chose to register a service. For a test or development installation it is recommended to run the server from the console.<br /> <img src='../uploads/Frepple/wininstall5.png' alt='' title='' /> <div class='vspace'></div></li><li><strong>Start the server</strong><br /> FrePPLe's user interface is web-based. You need to start the web server first in one of the following ways: <ul><li>Either it was already started at the last step of the installation process </li><li>Select "Run Server" from the program menu to start the web server in a console window.<br /> If you're new to frePPLe, this method is preferred. </li><li>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. </li><li>Start the service from the windows service manager. Also this option is only valid if you choose to register the service during installation. </li></ul><div class='vspace'></div>Point your browser to the URL shown in the server window, and you're up and running!<br /> <img src='../uploads/Frepple/wininstall7.png' alt='' title='' /><br /> <img src='../uploads/Frepple/wininstall6.png' alt='' title='' /><br /> <img src='../uploads/Frepple/winservice.png' alt='' title='' /> </li></ol><p class='vspace'>It is possible to have multiple installations in parallel on the same computer. They 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. </p> </div> <!--PageFooterFmt--> <!--HTMLFooter--> </div></div> </body> </html>
