mirror of
https://github.com/CAcertOrg/cats.git
synced 2024-11-03 04:34:04 +00:00
Added INSTALL.txt for installation instructions
This commit is contained in:
parent
e4b15e52d6
commit
1c321e198b
1 changed files with 54 additions and 0 deletions
54
INSTALL.txt
Executable file
54
INSTALL.txt
Executable file
|
@ -0,0 +1,54 @@
|
||||||
|
Installation procedure for CATS
|
||||||
|
===============================
|
||||||
|
|
||||||
|
Prerequesites
|
||||||
|
-------------
|
||||||
|
|
||||||
|
- Apache 2.2.4 ist installed and configured to run with HTTPS. The CAcert roots should
|
||||||
|
be trusted.
|
||||||
|
- PHP 5.2.4
|
||||||
|
- MySQL (Version 5.0) is installed and running
|
||||||
|
- git is installed and has access to github.com
|
||||||
|
- You have a browser with a valid CAcert client certificate installed
|
||||||
|
- You may want to set up your own CAcert testsystem like described in https://wiki.cacert.org/Software
|
||||||
|
to play around with certificates more freely
|
||||||
|
|
||||||
|
|
||||||
|
Setup
|
||||||
|
-----
|
||||||
|
|
||||||
|
- Get CATS from github into your webserver's document directory (or any subdir):
|
||||||
|
git clone git@github.com:CAcertOrg/cats.git
|
||||||
|
|
||||||
|
- Connect to your MySQL server with an administrative user and create a database for CATS:
|
||||||
|
CREATE DATABASE cats_db;
|
||||||
|
- Create a user for CATS to access the database:
|
||||||
|
CREATE USER cats-user IDENTIFIED BY '<a password>';
|
||||||
|
- Grant the necessary user rights. These are a bit more than the absolute minimum:
|
||||||
|
GRANT DELETE, INSERT, SELECT, UPDATE ON cats_db.* TO cats_user;
|
||||||
|
- Change the database to the newly created cats_db:
|
||||||
|
USE cats_db;
|
||||||
|
- Execute the scripts from the database subdirectory to create the database structure.
|
||||||
|
First execute create_db.sql, then all update*.sql in numerical order
|
||||||
|
|
||||||
|
- Change to cats directory, copy index.php.template to index.php
|
||||||
|
- Edit index.php, replace the string "FILEPATHTOHERE" with the absolute path of the
|
||||||
|
cats directory. Make sure to finish with a slash.
|
||||||
|
- Change to the includes subdirectory
|
||||||
|
- Copy db_connect.inc.template to db_connect.inc
|
||||||
|
- Edit db_connect.inc
|
||||||
|
- You may want to install a sample test by executing sample_test.sql from the database directory
|
||||||
|
|
||||||
|
- Make sure that the directive "SSLVerifyClient optional" or "SSLVerifyClient require"
|
||||||
|
are active for the CATS web directory, otherwise no client certificate login is requested
|
||||||
|
from your browser
|
||||||
|
|
||||||
|
|
||||||
|
Create an administrative user
|
||||||
|
-----------------------------
|
||||||
|
|
||||||
|
- Open your browser and browse to your CATS web directory using https.
|
||||||
|
- Click "Login" and accept registering with "Yes"
|
||||||
|
- Connect to your mysql database
|
||||||
|
- Set the admin flag on all existing users (should be only one):
|
||||||
|
UPDATE USER SET admin=1;
|
Loading…
Reference in a new issue