-
Notifications
You must be signed in to change notification settings - Fork 250
Installation on Windows OS
hybridlinux edited this page Aug 15, 2024
·
11 revisions
Installation on the Windows platform is rather trivial, and consists of the following stages:
- Download and Install Java from Adoptium.
- Download and Install Tomcat from Apache.
- Download the latest build of PWM Current Build.
- Extract pwm.war from downloaded zip file and explode by copying to Tomcat Webapps folder
- Configure the PWM_APPLICATIONPATH environment variable.
- Start the configuration wizard by going to the default application url.
- OpenJDK Java 11 LTS is probably the safest version. The Java requirements depend on the PWM version.
- Download Java from: https://adoptium.net/
- Choose the MSI installer for your platform (x64 or x86).
- Install Java with default settings
- Download Tomcat 9 from: Download Tomcat 9 From Apache
- Should choose: 32-bit/64-bit Windows Service Installer
- Install Tomcat, unselect install the Web Manager application (we dont need it).
- Start the Tomcat service, and set the start action to Automatic.
- Check Java/Tomcat are working by going to "http://localhost:8080" in a browser other than IE, and you should get either a tomcat startup page or 404 error depending on tomcat version/options. If you get something else get tomcat working before proceeding.
- Download PWM build and rename the WAR file to pwm.war if it isn't already.
- Copy pwm.war to tomcat's "webapp" directory. (for 64bit os, default is at: C:\Program Files\Apache Software Foundation\Tomcat 9.0\webapps). Make sure the filename is pwm.war exactly, tomcat will explode the war file to a "pwm" folder and will also use "/pwm" as the URL suffix.
- Create a directory somewhere on your server for PWM's application path (data folder) like "c:\pwm"
- Review PWM docs on setting the PWM_APPLICATIONPATH property here: http://www.pwm-project.org/pwm/public/reference/environment.jsp. Probably the most straightforward way to do this is to set an en environment variable on the Tomcat Windows Service using the --Environment switch as documented in the service documation to "PWM_APPLICATIONPATH=C:\pwm". See https://tomcat.apache.org/tomcat-9.0-doc/windows-service-howto.html. After setting the environmental variable, you will need to restart the Tomcat service in order for it to pick that up.
- You can now start the configuration by going to: http://localhost:8080/pwm and the config UI will guide you through the configuration.