This section also relies on some OpenACS files, which you can get with the section called -“Unpack the OpenACS -tarballâ€.
+“Unpack the OpenACS +tarball”.Compile AOLserver. Compile and install Index: openacs-4/packages/acs-core-docs/www/configuring-install-packages.adp =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/configuring-install-packages.adp,v diff -u -r1.1.2.1 -r1.1.2.2 --- openacs-4/packages/acs-core-docs/www/configuring-install-packages.adp 23 Sep 2015 11:54:24 -0000 1.1.2.1 +++ openacs-4/packages/acs-core-docs/www/configuring-install-packages.adp 23 Sep 2015 18:51:42 -0000 1.1.2.2 @@ -36,8 +36,8 @@ on. If you're installing from Local Files, and you are missing any packages, you may have to add the packages your desired package depends on: the section called -“Upgrading the OpenACS -files†+“Upgrading the OpenACS +files”
If you run into any errors at all, check your /var/lib/aolserver/$OPENACS_SERVICE_NAME/log/error.log file, and post your error on the OpenACS forums
Once the package has been installed, then you will need to Index: openacs-4/packages/acs-core-docs/www/cvs-guidelines.adp =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/cvs-guidelines.adp,v diff -u -r1.1.2.2 -r1.1.2.3 --- openacs-4/packages/acs-core-docs/www/cvs-guidelines.adp 23 Sep 2015 18:37:44 -0000 1.1.2.2 +++ openacs-4/packages/acs-core-docs/www/cvs-guidelines.adp 23 Sep 2015 18:51:43 -0000 1.1.2.3 @@ -238,8 +238,8 @@ repository:
Use one of the checkout methods described above to get files to your system. This takes the place of steps 1 and 2 in the section called -“Installation Option 2: Install from -tarballâ€. Continue setting up the site as described +“Installation Option 2: Install from +tarball”. Continue setting up the site as described there.
Fix bugs and add features.
-
Commit that file (or files):
cvs commit -m "what I did and why" filenameBecause this occurs in your personal checkout and not an anonymous one, this commit automagically moves back upstream to the @@ -286,8 +286,8 @@ cvs tag -b oacs-5-1
See the section called -“How to package and release an OpenACS -Package†+“How to package and release an OpenACS +Package”
Note
Some packages are already in cvs at openacs-4/contrib/packages. Starting with
Index: openacs-4/packages/acs-core-docs/www/docbook-primer.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/docbook-primer.adp,v
diff -u -r1.1.2.1 -r1.1.2.2
--- openacs-4/packages/acs-core-docs/www/docbook-primer.adp 23 Sep 2015 11:54:27 -0000 1.1.2.1
+++ openacs-4/packages/acs-core-docs/www/docbook-primer.adp 23 Sep 2015 18:51:43 -0000 1.1.2.2
@@ -386,7 +386,7 @@
OpenACS Documentation Strategy
OpenACS documentation development is subject to the constraints
of the software project development and release methods and cycles
(the section called
-“Using CVS with OpenACSâ€).
+“Using CVS with OpenACS”).
Essentially, all phases of work may be active to accommodate the
asynchronous nature of multiple subprojects evolving by the efforts
of a global base of participants with culturally diverse time
@@ -520,7 +520,7 @@
can be used with all elements. It comes in very handy when
interlinking between documents (more about this when talking about
links in the section called
-“Linksâ€). The value of
+“Links”). The value of
id has to be unique throughout
the book you're making since the id's in your sect1's will turn into filenames when the
book is parsed into HTML.
@@ -584,7 +584,7 @@ <xref linkend="packages-looks"></xref>.
And the output is:
- Find information about what a package looks like in -the section called “What a Package Looks Likeâ€. +the section called “What a Package Looks Like”.
Note that since I haven't provided an xreflabel for the subsection, packages-looks, the parser will try its
best to explain where the link takes you.
See also the section -called “Running a PostgreSQL database on another -serverâ€.
Index: openacs-4/packages/acs-core-docs/www/individual-programs.adp =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/individual-programs.adp,v diff -u -r1.1.2.2 -r1.1.2.3 --- openacs-4/packages/acs-core-docs/www/individual-programs.adp 23 Sep 2015 18:37:45 -0000 1.1.2.2 +++ openacs-4/packages/acs-core-docs/www/individual-programs.adp 23 Sep 2015 18:51:43 -0000 1.1.2.3 @@ -99,12 +99,12 @@ install bash to work with the scripts. Substitute
fetch when the instructions
suggest you use wget to download software.Mac OS X. the section called -“OpenACS Installation Guide for Mac OS -X†+“OpenACS Installation Guide for Mac OS +X”
Windows/VMWare. the section called -“OpenACS Installation Guide for -Windows2000†The only way to run OpenACS on Windows +“OpenACS Installation Guide for +Windows2000” The only way to run OpenACS on Windows is through the VMWare emulator. (Please let me know if you have OpenACS running directly in Windows.)
Install a database (see the section called -“Install Oracle 8.1.7†or +“Version Compatibility +Matrix”.
Install a database (see the section called +“Install Oracle 8.1.7” or Install PostgreSQL).
Install AOLserver (Install AOLserver 4) .
Create a unique database and system user. Install the OpenACS tarball, start and AOLserver instance, and use the OpenACS web pages to complete installation (see Install OpenACS 5.7.0).
Specific instructions are available for Mac OS X and Windows2000 (see the section called -“OpenACS Installation Guide for Mac OS -X†or the section called -“OpenACS Installation Guide for -Windows2000â€).
You can try out OpenACS using some binary installers. In general, they are not yet supported by the community, so they are @@ -44,8 +44,8 @@
128MB RAM (much more if you want Oracle)
1GB free space on your hard drive (much more if you want Oracle)
A Unix-like operating system with Tcl, tDOM, and a mail transport agent like sendmail or qmail. (see the -section called “Prerequisite -Softwareâ€)
All of the software mentioned is open-source and available without direct costs, except for Oracle. You can obtain a free copy of Oracle for development purposes. This is described in the Index: openacs-4/packages/acs-core-docs/www/maint-performance.adp =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/maint-performance.adp,v diff -u -r1.1.2.1 -r1.1.2.2 --- openacs-4/packages/acs-core-docs/www/maint-performance.adp 23 Sep 2015 11:54:41 -0000 1.1.2.1 +++ openacs-4/packages/acs-core-docs/www/maint-performance.adp 23 Sep 2015 18:51:43 -0000 1.1.2.2 @@ -17,7 +17,7 @@
Isolating and solving database problems.
Without daily internal maintenance, most databases slowly degrade in performance. For PostGreSQL, see the section called -“Vacuum Postgres nightlyâ€. For +“Vacuum Postgres nightly”. For Oracle, use
exec dbms_stats.gather_schema_stats('SCHEMA_NAME')(Andrew Piskorski's Oracle notes).-
You can track the exact amount of time each database query on a Index: openacs-4/packages/acs-core-docs/www/openacs.adp =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/openacs.adp,v diff -u -r1.1.2.2 -r1.1.2.3 --- openacs-4/packages/acs-core-docs/www/openacs.adp 23 Sep 2015 18:37:45 -0000 1.1.2.2 +++ openacs-4/packages/acs-core-docs/www/openacs.adp 23 Sep 2015 18:51:43 -0000 1.1.2.3 @@ -124,7 +124,7 @@ ###################################################################### [root root]#
You can proceed to the section -called “Next Stepsâ€.
+called “Next Steps”.
Installation Option 2: Install from @@ -272,7 +272,7 @@
Your table space is now ready. In case you are trying to delete a previous OpenACS installation, consult these commands in the section called -“Deleting a tablespace†+“Deleting a tablespace” below.
Make sure that you can login to Oracle using your service_name account:
@@ -286,8 +286,8 @@
You should see today's date in a format 'YYYY-MM-DD.' If you can't login, try redoing step 1 again. If the date is in the wrong format, make sure you followed the steps outlined in the section called -“Troubleshooting Oracle -Dates†+“Troubleshooting Oracle +Dates”
Test your backup and recovery procedure.
Set up the section called -“External uptime -validationâ€.
In order for OpenACS to work properly you need to set the +called “Defaults”.
In order for OpenACS to work properly you need to set the environment appropriately.
export ORACLE_BASE=/ora8/m01/app/oracle export ORACLE_HOME=$ORACLE_BASE/product/8.1.7 @@ -263,7 +263,7 @@"destination" path says "
/ora8/m01/app/oracle/product/8.1.7"If the destination is not correct it is because your environment variables are not set properly. Make sure you logged on as
oracleusingsu - oracle. If so, edit the~/.bash_profileas you did in the section called -“Pre-Installation Tasks†+“Pre-Installation Tasks”
Click "Next" (a pop up window will display Loading Product information).
Verify that your date settings are correct.
SQL> select sysdate from dual;
If you don't see a date that fits the format YYYY-MM-DD, please read the section called
-“Troubleshooting Oracle
-Datesâ€.
At this point we are going to hammer your database with an intense acceptance test. This usually takes around 30 minutes.
@@ -583,7 +583,7 @@ pre-existing database. Unfortunately, the only solution is to create a new database with a block size of at least4096. For instructions on how to do this, see the section called -“Creating the First Database†+“Creating the First Database” above. You can set the parameter using thedbassistprogram or by setting theDB_BLOCK_SIZEparameter in your database's creation script.If there were no errors, then consider yourself fortunate. Your @@ -935,8 +935,8 @@
the -section called “Creating an appropriate tuning -and monitoring environmentâ€
+section called “Creating an appropriate tuning +and monitoring environment”We used the following defaults while installing Oracle.