Install guide

1. Edit the Apache configuration file to change the value of User/Group:
prompt> vi /etc/httpd/conf/httpd.conf
change User and Group to the new user’s credentials.
2. Edit the WOW configuration file to change the value of APACHE_USER:
vi $OWHOME/WebApps/conf/wow.env
change APACHE_USER to new username
change HOME to match the home directory of the APACHE_USER.
3. Stop and start Apache:
prompt> /usr/sbin/apachectl stop
prompt> /usr/sbin/apachectl start
Important note on file permissions: WOW contains self-configuration modules which
require the Apache user have write access to the WebApps tree. Furthermore, any
patches applied to the tree need to be made as a user with appropriate permissions,
otherwise errors will occur. The Apache user should therefore belong to a group which has
write access to the WebApps tree.
Installing Multiple Apache Servers for WOW R5000
Instructions are provided below for RHEL 4 only. In this example, a new Apache binary
distribution is installed into /usr/local/apache2 running on server
http://wow.oilco.com port 8082, using a duplicated WebApps tree in
$OWHOME/WebApps2 where $OWHOME is /apps/ow.
See the next section for instructions for building Apache from source for both RHEL 4
(Apache 2.0) and RHEL 5 (Apache 2.2). Building from source is an alternative where a
binary distribution is not available or is unsuitable for any reason. In such cases, replace
steps 1 and 2 below with the steps in the next section.
1. Obtain the Apache binary distribution. Download from
http://archive.apache.org/dist/httpd/binaries/linux/
; look for the latest 2.0.x version, e.g.
httpd-2.0.48-x86_64-unknown-linux-gnu.tar.gz
2. Install Apache to a writeable local directory e.g. /usr/local/apache2. Use any
new directory, taking care not to overwrite any existing Apache installations:
cd /tmp
gzip -dc
httpd-2.0.48-x86_64-unknown-linux-gnu.tar.gz | tar xvf -
cd httpd-2.0.48
./install-bindist.sh /usr/local/apache2
3. Configure Apache httpd.conf with the following changes (line numbers are
approximate):
vi /usr/local/apache2/conf/httpd.conf
line 218: Listen 8082
line 295: User <WOW user>
line 296: Group <group of WOW user>
line 305: ServerAdmin <system administrator’s email>
line 319: ServerName <WOW server hostname>:8082
line 381: change AllowOverride None to AllowOverride AuthConfig
(this is an optional change to allow .htaccess authentication of static web pages)
line 613: Add lines:
WOW 5000.0.1.11 Release Notes Page 84 of 104 March 2014