This guide describes how to install Pure on Windows, and it assumes that you have a basic knowledge of Windows.

Prerequisites

If you are planning to use Internet Explorer on the server during the installation, you will need to disable Internet Explorer Enhanced Security Configuration.

You can also install Firefox or Chrome, or use a web browser on a client that can access Pure on the server.

Paths

First create the paths needed for the Pure installation. The paths used here are the default paths used by Atira, but you can change them to match your system.

d:\pack\pure_data
d:\pack\scripts

d:\pack\pure_data: This is used by Pure to store the run-time data, the search index, and any files uploaded to Pure.

d:\pack\scripts: This is used for the Pure deploy script and Pure configuration files

Java

Install a supported version of Java, either a OpenJDK version, we recommend AdoptJDK, or the version supported directly by Oracle. Please note that if you select OpenJDK we recommend that you configure Java to use the Microsoft Crypto API, see the guide in the Tomcat section below.

Install Java in the default folder.

For Java 8 Update 201 that would be C:\Program Files\Java\jdk1.8.0_201\ and C:\Program Files\Java\jre8\

Tomcat

Go to tomcat.apache.org and download the newest Tomcat 8.5 32-bit/64-bit Windows Service Installer.

Choose the Minimum type during installation, as the rest is not needed for Pure. Install it in the default location C:\Program Files\Apache Software Foundation\Tomcat 8.5.x and Configure the tomcat as below.

Point the Tomcat installation to the default Java path as above.

Lastly, don't run the Apache Tomcat now.

Server Shutdown Port: 8005
HTTP/1.1 Connector Port: 80 (Note this is changed, if you plan to have a proxy in front of Pure this does not need to be changed)
AJP/1.3 Connector Port: 8009

Server.xml

Open the Tomcat server.xml file in an editor (notepad / notepad++ ).

Location: C:\Program Files\Apache Software Foundation\Tomcat 8.0\conf\server.xml

Find the HTTP and AJP connectors

and configure them for UTF-8

Apache Tomcat Properties

After installation of Tomcat we have to configure its properties, this is done by starting Tomcat8w.exe. It can be found in the Tomcat installation folder in the bin folder. The default installation folder is C:\Program Files\Apache Software Foundation\Tomcat 8.0\bin\.

Now click on the Java tab and configure the Initial memory pool and the Maximum memory pool.

We recommend setting both to at least 4096 MB.

Any extra options for Tomcat should be added to the Java Options field.

Please refer to the Tomcat command-line parameters page for details on the required, recommended and optional JVM parameters.

Database Connection Configuration

The database connection also needs to be configured in the Java Options field.

You can set the parameters directly, or you can put them in a properties files, and then reference than instead.

Setting the parameters directly

If you want to set the parameters directly, add the following to the Java Options field

-Ddb.user=user
-Ddb.password=password
-Ddb.url=database_url

For examples of database URLs see Pure database URL 

Setting the parameters using a properties file

To configure the database connection using a properties file, add the following to the Java Options field

Create the properties file in d:\pack\scripts\ and edit it with an editor like Notepad or Notepad++

And add the following:

For examples of database URLs see Pure database URL 

Deploy script

Download one of the following deploy script and copy it to d:\pack\scripts\ : deploy.cmd, deploy.ps1

Now we have to configure the script to match our settings, open the script in an editor (notepad / notepad++), and edit the following lines such that it matches your setup:

set DIST="d:\pack\scripts"
set JAVA="C:\Program Files\Java\jdk1.8.0_45"
set DEP="C:\Program Files\Apache Software Foundation\Tomcat 8.0\webapps"

For information about how to deploy Pure manually see Manual Pure Deployment on Windows

Deploy Pure

Before first deployment: It is a good practices to clean the "webapps" directory in Tomcat before the first deployment, as you will most likely not use the default installed webapps.

Download the Pure distribution file and run the deploy script with this file by opening a command prompt as Administrator and navigate to the deploy script:

Create the database

If you have not already created the database and user for Pure, it should be created now.

Start Pure

You can now start Pure, this is done by locating the Apache Tomcat service in the windows services.msc

Run: services.msc

Check the Tomcat log file to make sure that it starts correctly by opening the following file in an text editor (Notepad/Notepad++).

The default location is C:\Program Files\Apache Software Foundation\Tomcat 8.0\logs\ and the log file to check is tomcat8-stdout.YYYY-MM-DD.log

Look for something similar to the following:

[INFO  20131007095644 ootManager: WebBootSequenceInteractionManager] ------------------------------------------------------------------------------
[INFO  20131007095644 ootManager: WebBootSequenceInteractionManager] | Entering maintenance mode!                                                 |
[INFO  20131007095644 ootManager: WebBootSequenceInteractionManager] | Go to http://<your server>/admin/prestartup/maintenance.xhtml              |
[INFO  20131007095644 ootManager: WebBootSequenceInteractionManager] | Password: 123ab45c-67de-8910-f2g3-h9900i80j509                             |
[INFO  20131007095644 ootManager: WebBootSequenceInteractionManager] ------------------------------------------------------------------------------

When it appears, go to the next step: Pure maintenance mode (installation)