The Hitchhiker's Guide to the ACS

by Bryan Quinn, Adam Farkas, Doug Hoffman, Hiroyoshi Iwashima, Ryan Lee and Ravi Jasuja,

Installing the ArsDigita Community System

  1. Downloading the ACS.

    This step should be done as nsadmin.

  2. Prepare Oracle for ACS

    You should be logged on as nsadmin for this step and you should make sure that nsadmin is in the dba group. You can verify this by typing groups when you login.

  3. Set up nightly Oracle exports

    You should do this step as root.

  4. Set up the Arsdigita Community System on your virtual server

  • Configure the AOLServer Virtual Server Configuration Files. You should do these steps as nsadmin.
    1. Start with the ini-template.ini template and copy it to /home/aol30/{service_name}.ini

    2. Change each occurance of User=service_name to:

      • User=web in service_name.ini

      • User=web-dev in service_name-dev.ini ( remember this oracle account needs to be created! )

      • Note: we should really change this in the template to service_database_username...

    3. Change each occurance of Password=service_database_password to:

      • User=web in service_name.ini

      • User=web-dev in service_name-dev.ini ( or whatever oracle password was assigned to web-dev! )

    4. Change each occurance of Hostname=service_domain to:

      • Hostname=www.arfdigita.org in service_name.ini

      • Hostname=dev.arfdigita.org in service_name-dev.ini

      • Note: we should really change this in the template to service_ipname...

    5. Change each occurance of service_name=service_domain community system to:

      • service_name=Service_Name's community system in service_name.ini

      • service_name=Service_Name-Dev's community system in service_name-dev.ini

      • Note: we should really change this in the template to service_pretty_name_for_acs...

    6. Change each occurance of ServerLog=/home/nsadmin/log/service_name-error.log to:

      • ServerLog=/webroot/aol30/log/service_name-error.log in service_name.ini

      • ServerLog=/webroot/aol30/log/service_name-dev--error.log in service_name-dev.ini

    7. Note: this needs to be automated!!!!

    8. Feed the geography tables into oracle via sqlloader
      • make sure your bashrc is correct for the web account!!!

      • cd /webroot/service_name/www/install

      • ./load-geo-tables web/web ( for each server with the right accnts... =)

      • cd /webroot/service_name/www/doc/sql

      • ./load-site-wide-search web web changeme