# Paragent Installation Guide

*NOTE* these instructions are for installing from source code. If you download the easy installer, this whole process is automated.

## OS

We are using Fedora Core 6 for the appliance installs. After getting the initial system up and running, be sure to get the latest updates by running:


    # yum -y install emacs
    # yum -y upgrade

This will download and install any updates since the ISO images were created.

make sure that the firewall is set up correctly

    # system-config-securitylevel-tui


choose ssh, http, https, and add port 6103

make sure that SELinux is disabled. You can do this by going to `/etc/selinux/config` and setting

    SELINUX=disabled


## Dependencies

Create a `/lisp` directory and unzip deps.tar.gz to it


## SBCL

Next, you need to get sbcl installed. we typically use the latest version of sbcl from cvs. However, in order to build sbcl, you will need an initial copy that we can use to bootstrap the build process.

    # yum -y install sbcl

    # mkdir /lisp
    # cd /lisp
    # cvs -d:pserver:[email protected]:/cvsroot/sbcl login
    CVS password: [return]
    # cvs -z3 -d:pserver:[email protected]:/cvsroot/sbcl co -P sbcl
    # cd sbcl
    # emacs -nw customize-target-features.lisp



create a file called `customize-target-features.lisp` with the following code:

    ;; add threading support
    (lambda (list) (cons :sb-thread list))


Now, build sbcl:

    # sh make.sh

and install it:

    # sh install.sh

now that we have a local version, get rid of our bootstrap one

    # yum remove sbcl
    # hash -r


## ASDF-BINARY-LOCATIONS

You need to make sure that sbcl stuff doesn't get recompiled, so create a ~/.sbclrc file and put the following into it:


    ;;; -*- Lisp -*-
    (require :asdf)
    (require :asdf-binary-locations)
    (defvar asdf::*source-to-target-mappings*
            '(("/usr/local/lib/sbcl/" nil)))


## SLIME

setup emacs to use slime:

    ; .emacs setup for slime
    (setq inferior-lisp-program "/usr/local/bin/sbcl")
    (add-to-list 'load-path "/lisp/slime")
    (require 'slime)
    (slime-setup)


## MySQL

    # yum install mysql
    # yum install mysql-server
    # yum install mysql-devel
    # /etc/init.d/mysqld start

to get mysqld to restart on reboot properly, issue a 

    # chkconfig mysqld on


## Repository

    # cd /lisp
    # git clone [email protected]:tritchey/paragent.git repos



## Link asd files

    # cd /usr/local/lib/sbcl/site-systems
    # ln -s `find -P /lisp -name "*.asd" -maxdepth 2` .
    # ln -s `find -P /lisp/repos -name "*.asd"` .


## Create MySQL Database

edit `/etc/my.cnf`. Add the following two lines to `[mysqld]` config

    lower_case_table_names=1
    set-variable=max_connections=500


    # sudo mysql
    mysql> create database khala;
    mysql> grant select,update,delete,insert on khala.* to username@localhost identified by "password";
    # mysql khala </lisp/repos/db/schema.sql


## Ready cl-sql

    # cd /lisp/clsql-3.8.3/db-mysql/
    # make clean
    # make


## mod_lisp

    # cd /lisp/mod_lisp

    # yum install httpd-devel
    # /usr/sbin/apxs -ica mod_lisp2.c


Add the following in `/etc/httpd/conf/httpd.conf`

    #
    # mod_lisp2 configuration
    #

    <LocationMatch "/.*\.ucw">
        LispServer 127.0.0.1 3001 ucw
        SetHandler lisp-handler
    </LocationMatch>

    <LocationMatch "/.*\.csv">
        LispServer 127.0.0.1 3001 ucw
        SetHandler lisp-handler
    </LocationMatch>

Now, restart the apache server

    # /usr/sbin/apachectl restart
    # /sbin/chkconfig httpd on

    # cd /var/www
    # rm -rf html
    # ln -s /lisp/repos/nexus/html html

    # cd /lisp/ucw-boxset/dependencies/detachtty
    # make
    # make install



## Configure Archon

    # cd /lisp/repos/db/
    # cp config-sample.lisp config.lisp
    # emacs config.lisp

Edit `config.lisp` appropriately.


## Scarab

    # cd /lisp/repos/scarab
    # sbcl
    * (load "/lisp/repos/scarab/scarab.asd")
    * (asdf:operate 'asdf:load-op 'scarab)
    * (save-lisp-and-die "scarab.core")
    # crontab -e 00 4 * * 0 /usr/local/bin/sbcl --core /lisp/repos/scarab/scarab.core --load /lisp/repos/scarab/run.lisp



## Startup

edit `/etc/rc.d/rc.local` to include the following lines:

    /lisp/repos/arbiter/scripts/start-arbiter
    /lisp/repos/archon/scripts/start-archon
    /lisp/repos/nexus/scripts/start-nexus



## Company Creation

Load Slime (Run emacs, and then enter M-x slime)

    CL-USER> (asdf:oos 'asdf:load-op 'db)
    CL-USER> (in-package :db)
    DB> (with-db (add-company "company name" "Adminstrator email" "administrator password" "Administrator email"))



## Log Rotation
create `/etc/logrotate.d/archon` and edit

    /var/log/*-dribble {
      daily
      ifempty
      copytruncate
      compress
    }