You'll need to use the ArsDigita binary distribution of AOLserver 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." Please read the release notes in the distribution for configuration notes specific to the version you are downloading.
Although the zsh shell is the only command-line tool required
to install the ACS, if you are a UNIX person used to typing
ls instead of dir
you'll get along much better with the Cygwin toolkit from RedHat
(available at
http://sourceware.cygnus.com/cygwin).
This is a development library and set of tools that gives you a very
UNIX-like environment under Windows. In particular, it includes
bash, gzip and tar,
which you can use to perform the ACS installation
instead of WinZip and zsh.
If it runs on your machine, proceed as follows:
select sysdate from dual;
Otherwise you will need to perform a little registry surgery as follows:
regedit and navigate down the registry keys to HKEY_LOCAL_MACHINE\Software\ORACLE.
HOME0 if you only have on einstallation of Oracle.
If you are an Oracle achiever and have more than one Oracle installation on your machine, you will see HOME0, HOME1, HOME2, etc. Choose the subtree that corresponds to the Oracle installtion you wish to use with the ACS.
NLS_DATE_FORMAT key is already present, double-click on its value and change it to 'YYYY-MM-DD' (without the quotes). If the key does not exist,
choose Edit->New->String Value from the menu and type NLS_DATE_FORMAT for the name of the new value to create it. Then double-click on the empty value to change it.
select sysdate from dual;
For more information on Oracle configuration look at http://photo.net/wtr/oracle-tips or search the Web/db Q&A Forum. One other note: the "nuke a user" admin page and Intermedia won't run unless you set open_cursors = 500 for your database.
For more information on Oracle configuration look at http://photo.net/wtr/oracle-tips.html or search the Web/db Q&A Forum. One other note: the "nuke a user" admin page and Intermedia won't run unless you set open_cursors = 500 for your database.
C:
drive into the
default aol30 directory. You can install it on any
drive, but it will make your life easier if you keep the AOLserver binary
and your ACS instance on the same drive. For the rest of these
instructions, we'll assume that you used drive C:.
c:\web.
Since most servers
these days are expected to run multiple services from multiple IP
addresses, each server gets a subdirectory from c:\web.
For example, http://scorecard.org would be rooted at
c:\web\scorecard on one of our machines and if
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
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".
c:\temp\acs.tar.gz
c:\web\yourdomain
c:\web\yourdomain\www contains the document root and c:\web\yourdomain\tcl contains Tcl scripts that are loaded when the AOLserver starts up.
states, country_codes and
counties tables using the load-geo-tables
shell script in the
c:\web\yourdomain\www\install 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.
c:\web\yourdomain\www\doc\sql and feed Oracle
the .sql files that you find there. There is a meta-loader file,
load-data-model.sql, that includes the other files in the proper
order. To use it, open a console window and run
sqlplus foo/foopassword < load-data-model.sql
c:\web\yourdomain\www\doc\sql, run
zsh load-site-wide-search foo foopassword ctxsys-password
Note that there's no slash between foo
and foopassword here. The third
argument, ctxsys-password, is the password for interMedia Text's
special ctxsys user.
You will need two configuration files. The first is a Tcl file
with configuration information for AOLserver. This should be called yourdomain and should be located in c:\aolserve3_0. The second is an .ini file that configures the ACS 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:
c:\web\yourdomain\parameters
c:\web\yourdomain\www
c:\web\yourdomain\tcl
c:\web\yourdomain\parameters and copy ad.ini to yourdomain.ini (or any other name different from 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. [ns/server/yourservername/acs]). This means that the ACS will ignore your configuration settings unless your AOLserver name 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 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, ad_parameter, is used to grab parameter values from the .ini file.
c:\aol30. Then run
bin\nsd -ft yourdomain.tcl
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
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:
bin\nsd -I -s yourdomain -t yourdomain.tcl
You can now configure error recovery and other Windows aspects of the service from the Services control panel. If you make further changes to yourdomain or yourdomain.ini you should stop and start the service from the Services control panel.
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';
https://yourservername/admin/users. You should read the documentation for user registration and access control and decide what the appropriate user state is for anonymous on your site.
c:\web.
lintcollectors.com and iguanasdirect.com. You would need the following:
lintcollectors with a user lintcollectors and password secretlint
iguanasdirect with a user iguanasdirect and password secretiguanas
c:\aolserver3_0 create files for each service, i.e. lintcollectors and iguanasdirect. These files would point to their respective pageroots, c:\web\lintcollectors\www and c:\web\iguanasdirect\www; their respective auxconfigdirs, c:\web\lintcollectors\parameters and c:\web\iguanasdirect\parameters; etc. In the respective auxconfigdirs would be the files lintcollectors.ini and iguanasdirect.ini.
Now open a console window and go to c:\aol30. You'll start up the two services as follows:
bin\nsd -I -s lintcollectors -t lintcollectors.tcl
bin\nsd -I -s iguanasdirect -t iguanasdirect.tcl
In the services control panel you should see two services: AOLserver-lintcollectors and AOLserver-iguanasdirect.