Install guide

Using an existing Apache server during install

By default, WOW installation requires a system with Apache installed but not configured or

running. Sites may wish to install WOW and rather use an existing Apache, e.g. the server

shipped with PowerExplorer.

To do so, run WebAppsInstall (or WOWInstall directly) with an additional –n flag to

skip Apache configuration during installation, as illustrated below. In this example the

server is http://wow.oilco.com and the WebApps tree is in the default

$OWHOME/WebApps location, where $OWHOME is /apps/ow.

prompt> cd $OWHOME/WebApps/install

prompt> ./WebAppsInstall

Usage: WebAppsInstall -o <OpenWorks Path> [-a <WOW Path>] [-n (no

Apache config)]

prompt> ./WebAppsInstall –o $OWHOME -n

Using the –n flag bypasses the default checks for Apache being already configured or

running on the install system, allowing the installation to continue with an existing server. It

also skips the creation of the root.sh script which does the default httpd.conf

configuration and starting of Apache. Instead, it writes an Apache.README file instructing

the installer what to change and what to add to the existing Apache's httpd.conf. An

example is illustrated below:

prompt> cat /apps/ow/WebApps/install/Apache.README

WOW requires the following directives to be set in the relevant

httpd.conf on wow.oilco.com:

User owadm (critical)

Group admins (critical)

ServerAdmin support@oilco.com (optional)

ServerName wow.oilco.com (confirm this matches the current setting)

WOW requires the following stanzas to be added to the relevant httpd.conf

on wow.oilco.com:

Alias /wow/ "/apps/ow/WebApps/htdocs/"

Options Indexes FollowSymLinks

AllowOverride None

Order allow,deny

Allow from all

</Directory>

ScriptAlias /bin/ "/apps/ow/WebApps/cgi-bin/"

AllowOverride AuthConfig

Options None

Order allow,deny

Allow from all

</Directory>

The setting of the User and Group directives is critical: this should be a user with read-

write (interpret) access to the OpenWorks projects – typically a data loader or

administrator. It should not be set to root, apache, nobody etc.

WOW 5000.0.1.11 Release Notes Page 82 of 104 March 2014