![]() |
The Hitchhiker's Guide to the ACSby Bryan Quinn, Adam Farkas, Doug Hoffman, Hiroyoshi Iwashima, Ryan Lee and Ravi Jasuja, |
You have the following options:
You can order an installation CDROM from RedHat or download an ISO image and burn one yourself. Once you have the CDROM, you need to boot the computer. If you have a recent BIOS and CDROM, you should be able to boot directly to the CDROM. Check your system's BIOS to see if this is an option and make sure the CDROM is set to boot before the primary hard drive. Then insert the CDROM, boot the computer and RedHat should start. Otherwise, you will need a boot disk. You can easily create one using one of the standard RedHat images. RedHat offers more information.
You can run the RedHat install over the network if you have a fast-enough connection. You'll need to copy roughly 300-600 MB of data, so be prepared. You need to prepare a bootdisk with the network image.
To begin the installation process, insert your boot media and boot your computer. RedHat should load and will present you with a LILO prompt. Read the instructions, but it should be safe to press enter unless you have unusual hardware. The RedHat kernel will then load and the installation program will start. You will need to inform the installation program of what kind of media you are installing from (CDROM or network).
You need to specify a Custom installation type in order to ensure you get all of the necessary packages.
Production linux servers require careful configuration of partitions in order to optimize performance. Such reccomendations are beyond the scope of this document. A simple configuration for a simple drive is
Partition Name | Size | Description |
---|---|---|
/boot | 15 M | Stores the kernel and basic boot configuration. |
/ | 3000+ M | Stores the major part of the file system. |
<swap> | 2x RAM or 256 Mb (whichever is smaller) | Virtual memory |
The following packages, at a minimum, should be installed. Feel free to install above and beyond this. Also, you may choose to individually select packages. It is not necessary to do this, but you may do this to add files to the distribution. You should not remove any of these packages. You can also install RPMs post-installation, so don't feel too concerned about this phase.
Package | Description | Why You Need This |
---|---|---|
Printer Support | Allows you to print | If you ever want to print anything. |
X Windows | Graphical system for UNIX | Needed for Oracle installation. |
GNOME | X Window Manager and GUI | Needed to run X properly |
Mail/WWW/Tools | Tools for checking mail, accessing the web. | Basic user programs. |
Networked Workstation | Basic tools for configuring networking. | Neccessary for server programs. |
Anonymous FTP | A FTP server | Useful for serving files to the world. |
Emacs | The Ultimate Text Editor. | Necessary for anything. |
Development | Basic compilers and scripting languages. | Needed to compile AOLServer and various other programs. |
Kernel Development | Source for the Linux kernel. | Necessary for recompiling. |
Utilities | Basic utilities for Linux. | Neccesary for accessing the system. |
Set a password for root. You do not need to add any more users at this time.
In order to boot your workstation, you either need to install LILO or have a bootdisk. The LILO option is reccomended. LILO (LInuxLOader) writes some data to your hard drives MBR which allows the computer to find the operating system. It is possible to configure LILO to boot multiple OSes. Check the LILO documentation for more information. We reccomend creating an emergency boot disk and installing LILO.
RedHat should automatically detect your network card. You will need to enter in your networking information or select DHCP. DHCP will automatically configure your networking, but your network must have a DHCP server already installed and running.
RedHat should automatically detect your graphics card. You can configure your system to use a graphical login, but this is not necessary for a production system. If your monitor is not listed, select a "Generic" or "Generic Multisync monitor."
At this point, sit back while RedHat copies itself over.
startx
. You may need to run Xconfiguratior
.
useradd <username> passwd <username>
Throughout these instructions, we will refer to a service name or SID of ora8. You may choose to customize this. If so, change any reference to ora8 excluding pathnames to your customized name. If you are confused by this, stick to using ora8.
Though Oracle 8.1.6 has an automated installer, we still need to perform several manual, administrative tasks before we can launch it. You must perform all of these steps as the root user.
We need to create a user called "oracle", which is used to install the product, as well as start and stop the database.
# groupadd dba # groupadd oinstall # useradd -g oinstall -G dba -m oracle # passwd oracle {to change the password}
Oracle can be mounted in a variety of places, but we will put it in the places that ArsDigita conventionally uses, to make our ACS installation that much smoother.
# mkdir /ora8 # cd /ora8 # mkdir m01 m02 m03 # chown -R oracle.dba /ora8 {change the owner to oracle from root..}
ORACLE_BASE=/ora8/m01/app/oracle export ORACLE_BASE ORACLE_HOME=$ORACLE_BASE/product/8.1.6 export ORACLE_HOME PATH=$PATH:$ORACLE_HOME/bin export PATH LD_LIBRARY_PATH=$ORACLE_HOME/lib:/lib:/usr/lib export LD_LIBRARY_PATH ORACLE_SID=ora8 {Change this if needed.} export ORACLE_SID ORACLE_TERM=vt100 export ORACLE_TERM ORA_NLS33=$ORACLE_HOME/ocommon/nls/admin/data export ORA_NLS33 umask 022 NLS_LANG=american export NLS_LANG
$ su root {enter your root password} # mount -t iso9660 /dev/cdrom /mnt/cdrom # exit {to exit from superuser status}
$ cd /mnt/cdrom/install/linux {if you downlaoded it from Technet& aren't using a CD-ROM,} {then cd to: wherever it was untarred]/Oracle8iR2/install/linux} $ ./runInstaller
Open a new terminal window, then type:
$ su root {then enter root's password} # cd $ORACLE_HOME # ./orainstRoot.sh # exit {to exit superuser privs.} # exit {to close the term}
Open a new terminal window, then type:
$ su root {enter root password} # cd $ORACLE_HOME # chmod 744 root.sh # ./root.sh Hit "Enter" when it asks for the path to the local bin directory. Then: # exit {exit superuser status} $ exit {close the terminal}
$ dbassist &
nls_date_format = "YYYY-MM-DD"
open_cursors = 500
This is a good time to shut down X and login via the console. You can switch to a virtual console by doing "Ctrl-Alt-F1". Database creation will proceed significantly faster if more RAM is available.
./sqlora8.sh
Eventually, you'll be returned to your shell prompt. In the meantime, go get some food.
Did it work? Now's the time to find out.
$ mv acceptance-sql.txt acceptance.sql
$ mkdir -p /ora8/m03/oradata/ora8 $ sqlplus system {we are entering Oracle's SQL*Plus program;} {type "manager" when asked for a password.}Now that you're into SQL*Plus, change the default passwords for system, sys, and ctxsys to "alexisahunk" (or change them to something you'll remember):
SQL> alter user system identified by alexisahunk; SQL> alter user sys identified by alexisahunk; SQL> alter user ctxsys identified by alexisahunk;Now we'll create a new tablespace:
SQL> create tablespace web datafile '/ora8/m03/oradata/ora8/web.dbf' size 50m autoextend on;And we'll create a user:
SQL> create user web identified by web default tablespace web temporary tablespace temp quota unlimited on web;
SQL> grant create session to web; SQL> grant connect,resource to web;Next, quit out of SQL*Plus:
SQL> quitLog back into SQL*Plus as user "web"
$ sqlplus web {password: web} SQL>@/[path to the acceptancesql file]/acceptance.sql
You will want to automate the database startup and shutdown process. It's probably best to have Oracle spring to life when you boot up your machine.
$ su root {enter root pw} # cd /etc
# chmod +x /etc/rc.d/init.d/oracle8i
# ./oracle8i stop # ./oracle8i start # ./oracle8i restart # ./oracle8i invalid-parameter
# ln -s /etc/rc.d/init.d/oracle8i /etc/rc.d/rc0.d/K10oracle8i # ln -s /etc/rc.d/init.d/oracle8i /etc/rc.d/rc6.d/K10oracle8i
# ln -s /etc/rc.d/init.d/oracle8i /etc/rc.d/rc5.d/S99oracle8i # ln -s /etc/rc.d/init.d/oracle8i /etc/rc.d/rc3.d/S99oracle8i # ln -s /etc/rc.d/init.d/oracle8i /etc/rc.d/rc2.d/S99oracle8i
Reboot your computer and ensure that Oracle starts automatically by starting sqlplus. If it works, then your Oracle installation is complete.
AOLServer can be configued with two different configuration files: nsd.tcl and nsd.ini. By default,
nsd.tcl is used. However, the ACS uses a special file, parameters.ini for its own configuration.
In order to use this file, you need to be using nsd.ini. By default, AOLServer comes with nsd.tcl,
but you can translate this: from the aol3 directory, run
If you use nsd.ini, make sure that the home directory is properly set, or AOLServer will not work.
Edit nsd.ini, and set
You should also comment out all references to nsssl.
Test to make sure your installation is running.
bin/translate-tcl
.
CHECK THIS: does parameters.ini work with nsd.tcl?
home=/webroot/aol3
bin/nsd -fc nsd.ini -s server1
. Surf over to
localhost:8000, and make sure you can see the page.Installing Monitors
(note: Cassandracle and Cassandrix untar to directories named cassandracle and cassandrix.
This is convenient for installation purposes. MTA Montior untars to /www/mmon. It should untar to /mmon.)
Installing Oracle
Create user oracle (primary GID oinstall, secondary dba)
Untar the archive. Cd to /OracleRi2
Type ./runInstaller.
File Locations:
Source (automatically set)
Destination /ora8/m01
OraInventory /ora8/.oraInventory
Database directory /ora8/m02
Set Install group to oinstall
Typical Installation.
Name your database. This name is used for accessing the db from oracle tools.
You need a service name and a system identifier: SID. The service name should be a database name and
your domain. For instance, we used chaos.arsdigita.com. This gives us a SID of chaos.
Wait.
A database will be created for you with two accounts:
SYS, change_on_install (lucky2)
SYSTEM, manager (lucky)
Post-install
Edit the init-scripts for your shell (e.g. .bashrc) and set the (supposedly optional)
ORACLE_BASE and ORACLE_HOME environment variables.
ORACLE_BASE=/ora8/m01
ORACLE_HOME=/ora8/m01
ORACLE_SID=SID
Moving on to http://www.arsdigita.com/doc/architecture-install.html and
http://www.arsdigita.com/doc/installation.html
Architecture install has a legacy print-out of Oracle data files.
Find where the tablespaces are stored
SVRMGR> select file_name from dba_data_files;
Example results:
/ora8/m01/app/oracle/oradata/ora8/system01.dbf
/ora8/m01/app/oracle/oradata/ora8/oemrep01.dbf
/ora8/m01/app/oracle/oradata/ora8/rbs01.dbf
/ora8/m01/app/oracle/oradata/ora8/temp01.dbf
/ora8/m01/app/oracle/oradata/ora8/users01.dbf
/ora8/m01/app/oracle/oradata/ora8/indx01.dbf
/ora8/m01/app/oracle/oradata/ora8/drsys01.dbf
/ora8/m02/oradata/ora8/jsc01.dbf (misleading!)
A fresh installation looks like this:
SVRMGR> select file_name from dba_data_files;
FILE_NAME
--------------------------------------------------------------------------------
/ora8/m01/oradata/order/tools01.dbf
/ora8/m01/oradata/order/drsys01.dbf
/ora8/m01/oradata/order/users01.dbf
/ora8/m01/oradata/order/indx01.dbf
/ora8/m01/oradata/order/rbs01.dbf
/ora8/m01/oradata/order/temp01.dbf
/ora8/m01/oradata/order/system01.dbf
7 rows selected.
Export and Import *must* be done from svrmgrl. This is not specified in the documentation.
For the export-oracle script, all instances of 'app/oracle/product/8.1.5/' should be deleted.
Installing the ACS
When configuring service-name.ini, delete the [ns/setup] section. This was only for AOLServer 2.3.3.
Must set a Port for the [ns/server/service_name/module/nssock]
nscache.so is also deprecated.
When compiling Oracle driver, one usually gets the warning
ld: warning: type and size of dynamic symbol `sskgslgf' are not defined
This should be more prominently documented.
Provide documentation for [ns/parameters] in nsd.ini.
Include instructions to update the webserver user's LD_LIBRARY_PATH with the $ORACLE_HOME/lib
ArsDigita Server installation references 'nsd-oracle' which is deprecated.
Keepalive installation instructions references a 'restart-aolserver' script which we could not find
on the web, but had from bootcamp.
Knowing where nsd-oracle is would help a lot.
Setting up Glassroom
Exactly what must one do?
Setting up Monitors
ad-utilities-preload.tcl should be included with KeepAlive, WatchDog, etc.
Watchdog needs better setup instructions.
Glassroom needs better setup instructions.
Using CVS
Other Installation Documents
Covers the installation of ACS given a Unix server, Oracle, and AOLServer.