Install guide

Changing the Apache server during install
Sites may need to install WOW on a different system from which the Apache server will
eventually run. For example, WOW may need to be installed on an application server
containing the OpenWorks tree, which may be exported read-only to the intended Apache
server.
To achieve this, provide the hostname for the preferred Apache server rather than the
default during installation. Do NOT run root.sh on the installation system. Then, copy
this file to the intended Apache server and run the script locally.
Changing the Apache port during install
Sites may need to install WOW on a port other than the default port 80. To achieve this,
specify a port-qualified value for the WOW server full URL during installation, i.e.
http://<host>.<domain>:<port>.
You will need to edit httpd.conf and change the value of Listen, as described above.
It may also be necessary to open up permissions on the files and directories used by the
PidFile, ErrorLog and CustomLog variables in httpd.conf.
Changing the Apache server post-install
To move the WOW Apache server from one system to another, root access is required to
perform the following steps:
1. Copy the httpd.conf file from the old to the new server.
prompt> /etc/httpd/conf/httpd.conf
2. Edit the Apache configuration file to change the value of ServerName:
prompt> vi /etc/httpd/conf/httpd.conf
change ServerName to the new server (may also be commented out)
3. Edit the WOW configuration file to change the value of WOW_URL:
vi $OWHOME/WebApps/conf/wow.env
change WOW_URL to new server URL
4. If present, change all references from old to new server in $OWHOME/WebApps/
htdocs, files index.html and wow_css.js (3 locations in each)
vi $OWHOME/WebApps/htdocs/index.html
vi $OWHOME/WebApps/htdocs/wow_css.js
5. Stop Apache on the old server and start Apache on the new server:
prompt> /usr/sbin/apachectl stop (on old server)
prompt> /usr/sbin/apachectl start (on new server)
Changing the Apache user post-install
To change the WOW Apache user after installation, root access is required to perform the
following steps.
WOW 5000.0.1.11 Release Notes Page 83 of 104 March 2014