Wacs Installation Guide

Eleventh Edition

for WACS 1.0.1

B "Beaky" King

This work is licensed under the Creative Commons Attribution License. To view a copy of this license, visit http://creativecommons.org/licenses/by/2.0/ or send a letter to Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305, USA.

Sunday 10th July 2022

Revision History
Revision Eleventh Edition10th July 2022
  • For release 1.0.1
  • General updates
  • MySQL 8 and MariaDB 10.3 now treated as different DBs
Revision Tenth EditionNovember 2019
  • For release 1.0.0
  • Massive re-write of Ubuntu install instructions - updated from Hardy Heron (08.04) to Bionic Beaver (18.04)

Abstract

WACS is a tool for building Adult Web Sites; it is equally suitable for managing a private collection or building a commercial web site. It has many best of breed features including dynamic filtering, model catalogs, automatic download and powerful search engine. It comes with a powerful API (application programming interface) implemented in both Perl and PHP7 languages to allow web developers to leverage it's facilities from their own programs.

This book describes the actions required to install the WACS System onto a suitable host system (typically a server). The intended audience is system administrators and prospective WACS site managers wishing to install WACS on a machine. The guide will try to cover three types of installation: Packaged installation (using RPMs on Fedora/RHEL/CentOS, DEBs on Ubuntu/Debian), installation onto a WebHost environment and manual installation on other Unix/Linux versions.

The WACS source code and other documentation and support tools can all be found at the WACS website at Sourceforge and at the Wacs page on launchpad.net. A demonstration site built using the WACS tools can be found at PinkMetallic.com - CAUTION: contains adult material. Commercial add-ons and support options can be purchased from Bevtec Communications Ltd, see their website at Bevtec Communications.


Table of Contents

1. Introduction to WACS Installation
WACS Overview
About This Book
Goals
About The Examples
2. Preparation For Installation
Preparation Tasks
Linux Operating Systems
3. Prerequisites
Web Server
Relational Database
Content Storage
4. Linux: Options
Methods Available
Linux Package Install
Linux easyinstall (Depricated)
Linux Manual Install
5. Installing WACS Using Packages
Package List
RPM Installation Steps
Downloading The RPMs
RPM Installation
Other System Issues
DEB Installation Steps
Downloading The DEBs
DEB Installation
RPM/DEB Initial Setup
Permissions Issues
6. Creating The Initial WACS Databases
Overview: WACS Database Creation
Creating Initial Databases With wacssetup
wacssetup itself
After wacssetup
Manual Database Creation Steps
1. Create the WACS database account (MySQL)
2. Create the necessary database schemas
3. Create default database contents (optional)
4. Import sample model records (optional)
5. Import sample set records (optional)
7. Installation On A Web Hosting Site
Caution
WebHost Installation: Steps
Preparation On Web Host
The Wacs Code Itself
Configuration
Database Setup
Database Schema Creation
Support Scripts
Populate The Initial Database
Initial User Creation for Database Authentication
Final Notes For Web Hosting
Webhost History
Known Issues
Adding Missing Helper Programs
8. Manual Installation
Caution
Manual Installation: Steps
Preparation
The Wacs Code Itself
Configuration
Database
Database Schema Creation
Support Scripts
Populate The Initial Database
Initial User Creation for Database Authentication
More On SELinux
9. Performance And Security
Performance Tuning
MP4/H264 streaming with Apache
Improving Performance With mod_perl
Security
10. Upgrading An Existing Installation
About Upgrading
Introduction
The WacsSchema Command
Software & Data Upgrade Tools
The Upgrade Command
Additional Steps
Upgrading The Data
11. Using wacssetup To Upgrade
Wacssetup Does Upgrades Too...
Backing Up The Database
Performing The Upgrade
12. Moving XML Files Between Releases and Installations
Introduction To Moving XML
XML Default Values Files
Porting Older XML Files
13. Troubleshooting
Introduction
Installation Troubleshooting
Checking Database And Accounts
Checking Structures
Beyond That
wacssetup completes but you can't login
If All Else Fails
General Troubleshooting Tips
Troubleshooting Checklist
Special Notes About SELinux
14. Using Other Databases
Position Overview
Oracle 10, 11, 12, 18 and 19
Oracle Perl Driver
Oracle Php5 Driver
Oracle PHP7 driver
PostgreSQL Version 12 and 13
PostgreSQL Installation Basics
Enabling Network Operation In PostgreSQL
Other PostgreSQL issues
15. Installing With EasyInstall
WARNING: easyinstall is depricated
Easyinstall: Download
Easyinstall: Running
Index

List of Tables

2.1. Software Pre-Requisites For WACS On Linux
5.1. List of Packages
10.1. Aspects of an Upgrade
12.1. XML Defaults files in WACS
12.2. Required XML Entities
14.1. Required Client Side Oracle Packages
14.2. Oracle Environment Variables

List of Examples

8.1. Sample Apache wacs.conf File