Installation on Ubuntu Server 16.04 LTS

Installing on Linux server is a breeze. This installation guide is specifically for Ubuntu Server 16.04 LTS. But it should work for any recent Ubuntu or Debian based linux installation, make adjustments as needed. Pwm needs a MySql Database or AD to store some settings. This is not covered in this guide

1. Install the needed packages

   • Install Apache2
     sudo apt-get install -y apache2
   • Install PHP
     sudo apt-get install -y php libapache2-mod-php

2. Install Tomcat8 & Tomcat8 Tools
   sudo apt-get install -y tomcat8 tomcat8-docs tomcat8-examples tomcat8-admin

   • Add roles and a user to tomcat in order to install .war files trough the browser later on: Edit /etc/tomcat8/tomcat-users.xml and add the following as children of tomcat-users

     <role rolename="manager-gui"/>
<role rolename="admin-gui"/>
<role rolename="manager-script"/>
<user username="username" password="password" roles="manager-gui,admin-gui,manager-script"/>

   • Reboot tomcat for changes to take effect sudo service tomcat8 restart

   • Note: Restarting may take long (couple of minutes for me). You can install haveged entropy gathering daemon to greatly reduce tomcat startup delays, but this is not required: sudo apt-get install -y haveged

3. Install PWM through your webbrowser

   • Download the latest version from https://www.pwm-project.org/artifacts/pwm/ and extract the pwm.war file
   • Go to http://server-ip:8080/manager/html in your browser and login when prompted with the credentials defined in /etc/tomcat8/tomcat-users.xml
   • Use the gui to install the pwm.war file
     • If you have issues issues with this, then you can upload pwm.war to the webapps folder located at /var/lib/tomcat8/webapps/ instead
   • You will get 5083 ERROR_ENVIRONMENT_ERROR (application path is not specified) on the site, please follow next step

4. Create a folder for pwm to store config files and add it's path to pwm.

   • Create a folder somewhere and make 'tomcat8' the owner

     • Example commands if you want to create the folder in /media/pwm/:

       mkdir /media/pwm/
       chown tomcat8 /media/pwm/
       

   • tell pwm about the newly created folder:

     • edit /etc/default/tomcat8 and add in the top line the below then save it

       PWM_APPLICATIONPATH=/media/pwm
       

   • Note: If you rename the war for example to password.war, pwd.war, or idm.war, change PWM_ to your wars name like below

     PASSWORD_APPLICATIONPATH=/media/pwm
     

   • Restart tomcat8 for the changes to take effect sudo service tomcat8 restart

5. Now go to http://server-ip:8080/pwm/

   • Configure pwm
   • I'll update later with more on PWM configuring, for now here is a guide I used but its for 1.7.1
     https://goo.gl/1PWh3i to get PWM up and running with some trial and error.

6. Test away but when done configuring I highly suggest to secure with a cert! WARNING: Until you secure your site passwords are being sent in the clear!

   • To secure follow the Tomcat8 instructions below
     • https://tomcat.apache.org/tomcat-8.0-doc/ssl-howto.html

7. That's it, enjoy PWM!!

Still a work in progress......