| Prev | Chapter�3.�Complete Installation | Next |
|---|
by Matthew Burke and Curtis Galloway
+ +NOTE: These instructions were valid for ACS v4, but have not been tested with OpenACS and the ArsDigita binary distributions are no longer available. Currently - (10/2003), the best option to get OpenACS 5.2.0d1 running on Windows + (10/2003), the best option to get OpenACS 5.2.3b1 running on Windows is to use VMware and John Sequeira's Oasis VM distribution @@ -23,7 +24,7 @@ for the Win32 platform, which contains patches for several problems we have come across in the default AOLserver binary distribution. See the ArsDigita AOLserver 3 distribution page for details.
You can download the binary distribution from the ArsDigita download page - under "ArsDigita AOLserver 3 Binary Distribution for Win32." + under "ArsDigita AOLserver 3 Binary Distribution for Win32." Please read the release notes in the distribution for configuration notes specific to the version you are downloading.
- When you install Oracle, a good rule of thumb is "every default - setting is wrong." We will not discuss Oracle configuration here + When you install Oracle, a good rule of thumb is "every default + setting is wrong." We will not discuss Oracle configuration here except to mention that the OpenACS requires Oracle's NLS_DATE_FORMAT parameter be set to 'YYYY-MM-DD'. Fixing this depends on whether Oracle Administration Assistant for Windows NT (yes, @@ -72,7 +73,7 @@ create it. Then double-click on the empty value to change it.
Verify the date format by logging into the database using SQL Plus and run the following query: select sysdate from dual;
For more information on Oracle configuration look at http://photo.net/wtr/oracle-tips - or search the OpenACS forums. One other note: the "nuke a user" admin page and + or search the OpenACS forums. One other note: the "nuke a user" admin page and Intermedia won't run unless you set open_cursors = 500 for your database.
Extract the ArsDigita AOLserver distribution onto the C: @@ -89,11 +90,11 @@ http://jobdirect.com were on the same box then it would be at c:\web\jobdirect.
For the sake of argument, we're going to assume that your service - is called "yourdomain", is going to be at + is called "yourdomain", is going to be at http://yourdomain.com and is rooted at c:\web\yourdomain in the Windows 2000 file system. Note that you'll find our definitions files starting out with - "yourdomain.com".
download the OpenACS (see above) into + "yourdomain.com".
download the OpenACS (see above) into c:\temp\acs.tar.gz
use WinZip (or equivalent) to extract the files to c:\web\yourdomain
You'll now find that c:\web\yourdomain\www contains the @@ -111,8 +112,8 @@ directory. You will need to open a console window and run
zsh load-geo-tables foo/foopassword
- You most likely will see a slew of "Commit point reached . . . - " messages. This does not indicate a problem. + You most likely will see a slew of "Commit point reached . . . + " messages. This does not indicate a problem.
@@ -139,7 +140,7 @@ the OpenACS and is discussed below. Note that pathnames in yourdomain must use forward slashes rather than the Windows back slashes. This is also true for the .ini file.
The following items must be defined in yourdomain:
three database pools: main, subquery, and log. They must be named - as such. The default pool will be "main".
the auxconfig directory which contains the .ini file: + as such. The default pool will be "main".
the auxconfig directory which contains the .ini file: c:\web\yourdomain\parameters
the pageroot: c:\web\yourdomain\www
the directory containing the TclLibrary: c:\web\yourdomain\tcl
You can use our template file as a starting @@ -152,15 +153,15 @@ ad.ini). You don't actually have to delete ad.ini.
Each section of yourdomain.ini has a hardcoded - "yourservername" in the name (e.g. + "yourservername" in the name (e.g. [ns/server/yourservername/acs]). This means that the OpenACS will ignore your configuration settings unless your AOLserver name - happens to be "yourservername". Therefore you must go through - yourdomain.ini and change "yourservername" to + happens to be "yourservername". Therefore you must go through + yourdomain.ini and change "yourservername" to whatever you're calling this particular AOLserver (look at the server name in the nsd file for a reference).
Unless you want pages that advertise a community called - "Yourdomain Network" owned by - "webmaster@yourdomain.com", you'll probably want to edit + "Yourdomain Network" owned by + "webmaster@yourdomain.com", you'll probably want to edit the text of yourdomain.ini to change system-wide parameters. If you want to see how some of these are used, a good place to look is c:\web\yourdomain\tcl\ad-defs. The Tcl function, @@ -174,7 +175,7 @@
This will print all the AOLserver messages to the console so you can see them.
Try to connect to your new server with a web browser. If you see the - message "Error in serving group pages", you probably forgot to + message "Error in serving group pages", you probably forgot to copy the ad.ini file in c:\web\yourdomain\parameters If everything seems ok, you can kill the server with Control-c and then issue the following command to install as a Windows service:
@@ -196,18 +197,18 @@
You'll want to add yourself as a user (at /register/ ) and then add
yourself as as member of the site-wide administration group. Start by
logging out as yourself and logging in as the system user (email of
- "system"). Change the system user's password. Visit the
+ "system"). Change the system user's password. Visit the
https://yourservername.com/admin/ug/ directory and add your
personal user as a site-wide administrator. Now you're bootstrapped!
If you do not know what the system user's password is connect to
Oracle using SQL Plus and run the following query:
select password from users where last_name = 'system';
- The OpenACS ships with a user named "anonymous" (email
- "anonymous") to serve as a content owner. If you're
+ The OpenACS ships with a user named "anonymous" (email
+ "anonymous") to serve as a content owner. If you're
operating a restricted-access site, make sure to change the anonymous
user's password. In recent versions of the OpenACS you cannot log into
- "anonymous" because the account does not have a valid user
+ "anonymous" because the account does not have a valid user
state. Log in as a sysadmin and change the anonymous user's password
from https://yourservername/admin/users. You should read the
documentation for user registration and
@@ -249,4 +250,4 @@
In the services control panel you should see two services:
AOLserver-lintcollectors and
AOLserver-iguanasdirect.
- ($Id$)