Wacs Installation Guide

Fifth Edition

for WACS 0.8.5

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.

11th March 2010

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 PHP5 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 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
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. Installing With EasyInstall
Easyinstall: Download
Easyinstall: Running
8. Manual Installation
Caution
Manual Installation: Steps
Preparation - With Root Account
Preparation - Web Hosting Site
Wacs Code - With Root Account
Wacs Code - Web Hosting Site
Configuration - With Root Account
Configuration - Web Hosting Site
Database - With Root Account
Database - With Web Hosting
Database Schema Creation - Both Environments
Support Scripts - With Root Account
Support Scripts - With Web Hosting
Populate The Initial Database - Both Environments
Initial User Creation for Database Authentication
Final Notes - With Web Hosting
More On SELinux
9. Upgrading An Existing Installation
About Upgrading
The Upgrade Command
Additional Steps
10. 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
11. Using Other Databases
Position Overview
Oracle 10 and 11
Oracle Perl Driver
Oracle Php5 Driver
Index

List of Tables

2.1. Software Pre-Requisites For WACS On Linux
5.1. List of Packages