Windows Installation

Windows Installation

To install the ProfileManagementTool on Windows Server 2008/2012 R2, follow the steps below.

Install MongoDB

1. Download the latest stable release of MongoDB Community Server for Windows Server 2008 R2 64-bit and later with SSL from here: https://www.mongodb.com/download-center?jmp=nav#community
2. Follow these instructions to install MongoDB for Windows: https://docs.mongodb.com/manual/tutorial/install-mongodb-on-windows/#install-mongodb-community-edition
3. After the installation, follow these instructions to create a Windows Service for MongoDB: https://docs.mongodb.com/manual/tutorial/install-mongodb-on-windows/#configure-a-windows-service-for-mongodb-community-edition
4. Optionally, to enable authentication follow these instructions: https://docs.mongodb.com/manual/tutorial/enable-authentication/ If you do that, make sure to create a database and an according user with write access for the ProfileManagementTool. After installing the latter, you would have to change the MongoDB Connection URI accordingly, see https://github.com/ShapeChange/ProfileManagementTool/wiki/Configuration.

Install Node.js

1. Download the latest LTS version of the 64-bit Windows Installer for Node.js from here: https://nodejs.org/en/download/
2. Execute the installer with the default settings and follow the instructions.
3. To verify the installation, open a command prompt and run "node -v". That should print the installed Node.js version.

Install the ProfileManagementTool

1. Download the latest release (pmt-version.zip) from here: https://github.com/ShapeChange/ProfileManagementTool/releases/latest
2. Unzip the archive to a directory of your choice, e.g. "C:\Program Files".
3. Open a command prompt with administrative rights and go to the installed directory, e.g. "C:\Program Files\pmt".
4. To install the application as a Windows Service, run "node install-service.js". If instead you just want to temporarily run the application from the command line, run "node src/server/server.js". Either way the ProfileManagementTool should now be running on port 80.
5. Open http://localhost in a web browser, if the browser is running on the same machine, or http://hostname-of-pmt-machine otherwise.