Forum OpenACS Q&A: Response to Newbee documentation

Collapse
Posted by Torben Brosten on

Since you want to "tune" the applications etc. I understand that this document is to be a guide for beginning developers, sort of like the documentation at https://openacs.org/doc/ but for OpenACS 4.5.


>       1. What do I need before I start? (e.g., FreeBSD server;
>PuTTY, iXPLORE on desktop; a link to Philip and Alex's Guide);

General information about scalable dynamic web sites can be found at:

http://philip.greenspun.com/internet-application-workbook
http://philip.greenspun.com/wtr/dead-trees/
In lieu of a 4year education in Computer Science, learn the material contained in
the harddisk available from: http://aduni.org 

More specific information:
http://philip.greenspun.com/sql/  SQL for Web Nerds
http://philip.greenspun.com/tcl/  TCL for Web Nerds
See also the docs at Aolserver.com, postgresql.org, and the documentation
associated with the distribution of unix/linux you are using.
There are also various docs peppered throughout the forums that
need to be collected for this part of the docs.

Notes that some have managed to get OpenACS to work in some configurations of
Windows2000. See https://openacs.org/doc/openacs-4/win-install.html

>
>       2. Where and how do I get and store the relevant sources?
>(wget, cvsup, ports, aolserver, libxml, freebsd-aolserver-extras,
>aol-startscript,
>       postgresql, postgres-headers, postgres-startscript, pgdriver,
>daemontools, openacs-core, openacs-packages, openacs-openfts-driver
>package,
>       dotlrn-core)
>

These should be available via the links in the document "Installing on Unix/Linux"
as a part of https://openacs.org/doc/openacs-4/

>       3. How do I compile and configure aolserver and postgres?
>

In general, regarding compiling programs: 
http://www.tldp.org/FAQ/Linux-FAQ/porting.html#HOW-DO-I-COMPILE-PROGRAMS

>       4. How do I configure monitoring aolserver and postgresql as
>services? 

Do you want to verify that services are working? you might try:
http://uptime.openacs.org 
Uptime is discussed in Greenspun's "Philip and Alex's Guide to Web Publishing" 
as a case study in Chapter 15.

>
>       5. How do I install OpenACS-core and -packages?
>

See the section of OpenACS 4.5 documentation entitled "Install OpenACS 4.5"
available at https://openacs.org/doc/openacs-4/openacs.html

Once the system is operating and you have signed in as Administrator, a
"Congratulations!" page appears. The section "How to Add Functionality to Your
Site" addresses installing and managing packages.  

More documentation is available at http://your-local-installation/doc/
A package has to be installed to see its documentation. Go to the "Package
Manager" (linked from the front page), followed by "Install packages". Select the
packages you want to install, but do not "enable" them unless you are ready to use
them. Installing and enabling *all* packages will cause problems as there are
package conflicts (but I don't have a list of them at this time).

>       6. How do I configure FreeBSD, aolserver and postgres for
>some speed?
>

There are some unix commands and other info mentioned in the forums that help
address the monitoring of the system for tuning purposes. For example:

https://openacs.org/bboard/q-and-a-fetch-msg.tcl?msg_id=0005nN&topic_id=11&topic=OpenACS

https://openacs.org/bboard/q-and-a-fetch-msg.tcl?msg_id=0004ei&topic_id=11&topic=OpenACS

https://openacs.org/bboard/q-and-a-fetch-msg.tcl?msg_id=00052Z&topic_id=11&topic=OpenACS

Also note, as a scalable community system by design, the system is already
optimized for working well under moderate to heavy load.


>       7. How do I install OpenFTS-driver?
>
It's installed as a part of following the directions on the lower half of the page
at:

https://openacs.org/doc/openacs-4/nextsteps.html  Note that some other OpenFTS
preparations are made during the installation of other components of the system
prior to reaching this page.


>       8. How do I install dotLRN-core?
>

I think dotLRN-core is OpenACS-core, and that dotLRN packages install on top of
OpenACS, but I'm just guessing at this point as I have not tried it.

>       9. How do I install and configure external packages?

I understand that this is also addressed in the "How to Add Functionality to Your
Site" part of the "Congratulations!" page of your local installation.

Go to the "ACS Package Manager" linked from the ACS Admin page (
http://your-local-installation/acs-admin/ 
 ) or the "Congratulations!" page. Then follow the "Load a new package from a URL 
 or local directory" link.

Please someone correct me if I have miss stated something or there is a doc that states all of this.