Index: openacs-4/packages/acs-core-docs/www/xml/install-guide/overview.xml
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/install-guide/overview.xml,v
diff -u -r1.5.2.1 -r1.5.2.2
--- openacs-4/packages/acs-core-docs/www/xml/install-guide/overview.xml 24 Nov 2002 21:29:24 -0000 1.5.2.1
+++ openacs-4/packages/acs-core-docs/www/xml/install-guide/overview.xml 30 Mar 2003 05:56:18 -0000 1.5.2.2
@@ -39,68 +39,72 @@
+
Purpose of this document
- This document will describe how to install OpenACS &version; from scratch,
- using the source code. We will assume that you have an OS installed,
- but we'll discuss this more in the next section. For most of this
- guide, we will assume that you are using Linux on a PC, but we'll
- also point you to excellent step-by-step guides for other operating
- systems.
+
+ This document will describe how to install, configure, and
+ maintain an installation of OpenACS &version; on a Unix-like
+ system, including all supporting software. All examples
+ in this chapter are part of the OpenACS &version;-P or
+ OpenACS &version;-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
+
+ Pentium processor
+ 128 MB RAM
(much more if you want Oracle)
- 4 GB hard drive
-
-
-
+ 4 GB hard drive
+
+ You will need all of the required software.
+
+
If you want to serve pages to people outside of your machine, you'll
need a network connection of some type.
-
-
+
+
Note that these are minimum requirements to get a development system
up and running. For a production system, we recommend you read about
the ArsDigita
Server Architecture
-
-
+
+
Running a reliable database-backed web server requires experience
with the server's environment, in this case UNIX. UNIX is not always
an intuitive environment and this guide cannot hope to explain every
nuance. You should be comfortable with the following tasks before
attempting an installation:
-
-
-
+
+
+
Adding users, groups, setting passwords
-
-
- Starting an X server and running an X program remotely
+
+ (For Oracle) Starting an X server and running an X program remotely
-
-
+
+
Basic file management using cp, rm,
mv, and cd
-
-
- Compiling a program using a Makefile
+
+
+ Compiling a program using ./config and make.
@@ -135,16 +139,52 @@
Install a database (Oracle or
PostgreSQL)
-
- Install a database
- driver (allows the webserver to talk to the database)
- Configure the webserver and
- database Start the OpenACS
- installer
+
+
+ Install a database driver (allows the webserver to talk to the database)
+
+
+
+ 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
+DROP DATABASE
+[nsadmin@localhost aolserver]$ createdb server1
+CREATE DATABASE
+su - nsadmin
+svc -d /service/server1
+dropdb server1
+createdb server1
+
+
+
+
What if I get stuck?
@@ -186,9 +226,17 @@
+ The bottom of each page has a link to OpenACS.org, where you can post
+ comments and read other users comments about the
+ contents of the page.
+
+
+
+
+
Ask questions at the irc channel on openprojects.net
- (#openacs). They're knowledgeable and quite friendly if you can
- keep them on topic.
+ (#openacs). They're knowledgeable and quite friendly
+ if you can keep them on topic.
@@ -240,6 +288,9 @@
I've used something that you've written without proper credit, let me
know and I'll fix it right away.
+ Version 4.6.x was edited by Joel Aufrecht.
+
These are a few of my sources:
@@ -261,13 +312,109 @@
My own Brief OpenACS4
installation guide
-
+
+ Joel
+ Aufrecht's OpenACS 4.5 Quick Guide.
+
+
+
Please also see the section for more acknowledgements.
+
+ Linux Install Guides
+
+ Here's a list of some helpful documentation for various OS's
+
+
+
+
+ Painless Debian
+ GNU/Linux by Stephen van Egmond
+
+
+
+
+ Official
+ Debian Guide
+
+
+
+
+
+ RedHat
+
+
+
+
+
+ Mandrake
+
+
+
+
+
+ SuSE
+
+
+
+
+
+
+
+
+ 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
+ some basic precautions, but security is a process, not a
+ condition. If you are responsible for a computer hooked to the
+ internet, you are responsible for learning some rudiments of
+ security, such as monitoring the state of a computer,
+ maintaining patch levels, and keeping backups. We recommend
+ these resources:
+
+
+
+
+
+ Securing and Optimizing Linux - version 2.0
+
+
+
+ Jon
+ Griffin's notes
+
+
+ Linux Administrators
+ Security Guide
+
+
+ Installation
+ of a Secure Webserver
+
+
+
+ Bruce
+ Schneier's Crypto-Gram, especially The
+ security patch treadmill and Monitoring First.
+
+
+
+
+
Resources