Index: openacs-4/packages/acs-core-docs/www/install-overview.html =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/install-overview.html,v diff -u -r1.7.2.8 -r1.7.2.9 --- openacs-4/packages/acs-core-docs/www/install-overview.html 4 May 2003 06:30:02 -0000 1.7.2.8 +++ openacs-4/packages/acs-core-docs/www/install-overview.html 7 May 2003 17:40:58 -0000 1.7.2.9 @@ -1,17 +1,17 @@ -Overview

Overview

+Overview

Overview

by Vinod Kurup
OpenACS docs are written by the named authors, and may be edited by OpenACS documentation staff. -

What is OpenACS?

+

What is OpenACS?

According to Philip Greenspun:

- “The ArsDigita Community System (ACS) is a toolkit of software + “The ArsDigita Community System (ACS) is a toolkit of software that will help you build Web services with a collaborative dimension, ranging from knowledge management within companies to B2C ecommerce to product support and community among the customers. The software is free and open-source and has been tested in heavy use since - 1995.” + 1995.

What's OpenACS? OpenACS was born when Don Baccus, Ben Adida, et al decided to port ACS from Oracle to @@ -25,7 +25,7 @@ the word) to extend it to other databases. Don Baccus leads the development and numerous developers (and non-developers) contribute from around the world. -

Purpose of this document

+

Purpose of this document

This document will describe how to install, configure, and maintain an installation of OpenACS 4.6.3 on a Unix-like @@ -34,11 +34,11 @@ OpenACS 4.6.3-O Reference Platform, which use Red Hat 8.0. Differences between the Reference Platform and common alternate platforms are noted where known. -

Requirements

+

Requirements

You will need a PC (or equivalent) with at least these minimum requirements:

  • Pentium processor

  • 128 MB RAM - (much more if you want Oracle)

  • 4 GB hard drive

You will need all of the required Chapter�2.

+ (much more if you want Oracle)

  • 4 GB hard drive

  • You will need all of the required Chapter�2, Prerequisite Software.

    If you want to serve pages to people outside of your machine, you'll need a network connection of some type.

    @@ -57,8 +57,8 @@

  • (For Oracle) Starting an X server and running an X program remotely

  • - Basic file management using cp, rm, - mv, and cd + Basic file management using cp, rm, + mv, and cd

  • Compiling a program using ./config and make.

  • @@ -70,37 +70,37 @@ All of the software that you will need is free and open-source, except for Oracle. You can obtain a free copy of Oracle for development purposes. This is described in the Acquire Oracle section. -

    Steps involved

    +

    Steps involved

    The basic steps to getting OpenACS up and running are:

    1. Install an OS

    2. Install a webserver (AOLServer)

    3. Install a database (Oracle or PostgreSQL)

    4. Install a database driver (allows the webserver to talk to the database) -

    5. Start the OpenACS installer, which will configure a database instance..

    How to use this guide

    • This is text you will see on - screen, such as a Button or link - in a radio button list or menu.

    • This is text that you will type.

    • This is text from a program or file which you may need to +

    • Start the OpenACS installer, which will configure a database instance..

    How to use this guide

    • This is text you will see on + screen, such as a Button or link + in a radio button list or menu.

    • This is text that you will type.

    • This is text from a program or file which you may need to examine or edit:

      if {$database == "oracle"} {
           set db_password        "mysitepassword"
       }
    • This is text that you will -see and type in a command shell, including text you may have to -change. It is followed by a list of just the commands, -which you can copy and paste.

      [root@localhost root]# su - nsadmin
      -[nsadmin@localhost aolserver]$ svc -d /service/server1
      -[nsadmin@localhost aolserver]$ dropdb server1
      +see and type in a command shell, including text you may have to
      +change.  It is followed by a list of just the commands,
      +which you can copy and paste.

      [root@localhost root]# su - nsadmin
      +[nsadmin@localhost aolserver]$ svc -d /service/server1
      +[nsadmin@localhost aolserver]$ dropdb server1
       DROP DATABASE
      -[nsadmin@localhost aolserver]$ createdb server1
      +[nsadmin@localhost aolserver]$ createdb server1
       CREATE DATABASE
      -
      su - nsadmin
      -svc -d /service/server1
      -dropdb server1
      -createdb server1

    What if I get stuck?

    +

    su - nsadmin
    +svc -d /service/server1
    +dropdb server1
    +createdb server1

    What if I get stuck?

    We'll do our best to assure that following our instructions will get you to the promised land. If something goes wrong, don't panic. There are plenty of ways to get help. Here are some tips:

    Is there an easier way?

    +

    Is there an easier way?

    After reading through this tome, you may ask yourself if there is a better way. Well, not quite. Jonathan Marsden has created RPMs (at @@ -140,7 +140,7 @@ 4.6.3. There has been talk about automating the install process, but that hasn't happened yet. Stay tuned! -

    Where did this document come from?

    +

    Where did this document come from?

    This document was created by Vinod Kurup, but it's really just plagiarism from a number of documents that came before it. If I've used something that you've written without proper credit, let me @@ -161,7 +161,7 @@ Aufrecht's OpenACS 4.5 Quick Guide.

    Please also see the Credits section for more acknowledgements. -

    Linux Install Guides

    +

    Linux Install Guides

    Here's a list of some helpful documentation for various OS's

    Security Information

    +

    Security Information

    Once you get your OS installed, it's imperative that you secure your installation. As Jon Griffin repeatedly warns us, "No distribution is secure out of the box." The Reference Platform implements @@ -207,9 +207,9 @@

  • Bruce Schneier's Crypto-Gram, especially The - security patch treadmill and Monitoring First.

  • Resources

    + security patch treadmill and Monitoring First.

    Resources

    Here are some resources that OpenACS users have found useful. -

    Books