Index: openacs-4/packages/acs-core-docs/www/xml/install-guide/oracle.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/install-guide/oracle.xml,v diff -u -r1.6 -r1.7 --- openacs-4/packages/acs-core-docs/www/xml/install-guide/oracle.xml 10 Aug 2002 19:53:50 -0000 1.6 +++ openacs-4/packages/acs-core-docs/www/xml/install-guide/oracle.xml 30 Nov 2002 17:17:46 -0000 1.7 @@ -5,231 +5,291 @@ by Vinod Kurup - Skip this page if you're not interested in Oracle + - NOTE: We've not yet tested - OpenACS &version; under Oracle 9i + Skip this page if you're not interested in Oracle - NOTE: This document assumes that - you'll be installing Oracle on the same box as AOLServer. For more - details on a remote Oracle installation, see Daryl Biberdorf's document. + + + + OpenACS &version; does not yet work with Oracle 9i + + + + + + This document assumes that you'll be installing Oracle on the same + box as AOLServer. For more details on a remote Oracle installation, + see Daryl Biberdorf's document. + + + + Acquire Oracle 8.1.7 Enterprise Edition + You can obtain the software through a variety of methods (You'll need to become a member of technet.oracle.com, which is free): + - Order a CD from the Oracle - Store. The cost is currently $39.95 for a 30-day - evaluation copy with delivery estimated between 3-4 business - days. - - - Download the software from the - Oracle Downloads page. - + Order a CD from the Oracle + Store. The cost is currently $39.95 for a 30-day + evaluation copy with delivery estimated between 3-4 business + days. - - - Oracle 8.1.7 now comes with a Java RunTime - Environment built-in to the distribution, so you no longer - have to download and install it separately. - + - - After the download is complete, untar the file - to a convenient location. To do this, you will need to login - and cd to the directory where the archive is. - - + + + Download the software from the + Oracle Downloads page. + + + + + + + Oracle 8.1.7 now comes with a Java RunTime + Environment built-in to the distribution, so you no longer + have to download and install it separately. + + + + + + After the download is complete, untar the file + to a convenient location. To do this, you will need to login + and cd to the directory where the archive is. + + + $ cd /directory/where/oracle/is $ tar xvf oracle81701.tar - - - + + + - - It used to be possible to get a free CD by mail, but - I can no longer find the link for that option. - + - + It used to be possible to get a free CD by mail, but + I can no longer find the link for that option. + + + + - Things to Keep in Mind + Things to Keep in Mind - - Throughout these instructions, we will refer to a number of - configurable settings and advise certain defaults. With the exception - of passwords, we advise you to follow these defaults unless you know - what you are doing. Subsequent documents will expect that you used - the defaults, so a change made here will necessitate further changes - later. For a guide to the defaults, please see . - + - - For additional resources/documentation, please see this thread. - + Throughout these instructions, we will refer to a number of + configurable settings and advise certain defaults. With the exception + of passwords, we advise you to follow these defaults unless you know + what you are doing. Subsequent documents will expect that you used + the defaults, so a change made here will necessitate further changes + later. For a guide to the defaults, please see . + + + + + For additional resources/documentation, please see this thread. + + + - Pre-Installation Tasks + Pre-Installation Tasks - - Though Oracle 8.1.7 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 recommend entering the - X window system as a normal user and then doing a su - -. This command gives you full root access. - + - + Though Oracle 8.1.7 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 recommend entering the + X window system as a normal user and then doing a su + -. This command gives you full root access. - - Login as a non-root user and start X by typing - startx - - + + + + + + + Login as a non-root user and start X by typing + startx + + joeuser:~$ startx - - - Open a terminal window type and login as root + - + + + Open a terminal window type and login as root + + joeuser:~$ su - Password: *********** root:~# - - + - Create and setup the oracle - group and oracle account - + - - We need to create a user oracle, - which is used to install the product, as well as starting and - stopping the database. - + Create and setup the oracle + group and oracle account - + + + + + We need to create a user oracle, + which is used to install the product, as well as starting and + stopping the database. + + + + root:~# groupadd dba root:~# groupadd oinstall root:~# groupadd oracle root:~# useradd -g dba -G oinstall,oracle -m oracle root:~# passwd oracle - - You will be prompted for the New Password and Confirmation of - that password. - - + - Setup the installation location for Oracle. While - Oracle can reside in a variety of places in the file system, - OpenACS has adopted /ora8 as the - base directory. - + You will be prompted for the New Password and Confirmation of + that password. - - Note: the Oracle install needs - about 1 GB free on /ora8 to - install successfully. - + + - + + + Setup the installation location for Oracle. While Oracle can + reside in a variety of places in the file system, OpenACS has + adopted /ora8 as the base + directory. + + + + + + Note: the Oracle install needs + about 1 GB free on /ora8 to + install successfully. + + + + root:~# mkdir /ora8 root:/ora8# cd /ora8 root:/ora8# mkdir -p m01 m02 m03/oradata/ora8 root:/ora8# chown -R oracle.dba /ora8 root:/ora8# exit - + - - Set up the oracle user's - environment - + - - - Log in as the user - oracle by typing the - following: - + Set up the oracle user's + environment - + + + + + + Log in as the user + oracle by typing the + following: + + + + joeuser:~$ su - oracle Password: ******** - + - - Use a text editor to edit the - .bash_profile file in the - oracle account home - directory. - + - + Use a text editor to edit the + .bash_profile file in the + oracle account home + directory. + + + + oracle:~$ emacs .bash_profile - - You may get this error trying to start emacs: - + - + You may get this error trying to start emacs: + + + + Xlib: connection to ":0.0" refused by server Xlib: Client is not authorized to connect to Server emacs: Cannot connect to X server :0. Check the DISPLAY environment variable or use `-d'. Also use the `xhost' program to verify that it is set to permit connections from your machine. - - If so, open a new terminal window and do the following: - + - + If so, open a new terminal window and do the following: + + + + joeuser:~$ xhost +localhost - - Now, back in the oracle terminal: - + - + Now, back in the oracle terminal: + + + + oracle:~$ export DISPLAY=localhost:0.0 oracle:~$ emacs .bash_profile - - Try this procedure anytime you get an Xlib connection refused - error. - + - - Add the following lines (substituting your - Oracle version number as needed) to - .bash_profile: - + Try this procedure anytime you get an Xlib connection refused + error. - + + + + + Add the following lines (substituting your + Oracle version number as needed) to + .bash_profile: + + + + export ORACLE_BASE=/ora8/m01/app/oracle export ORACLE_HOME=$ORACLE_BASE/product/8.1.7 export PATH=$PATH:$ORACLE_HOME/bin @@ -240,269 +300,334 @@ umask 022 - - Save the file by typing CTRL-X - CTRL-S and then exit by typing - CTRL-X - CTRL-C. Alternatively, use the - menus. - - - + - - Make sure that you do not add - any lines like the following - + Save the file by typing CTRL-X + CTRL-S and then exit by typing + CTRL-X + CTRL-C. Alternatively, use the menus. - + + + + + + + Make sure that you do not add + any lines like the following + + + + # NLS_LANG=american # export NLS_LANG - - These lines will change the Oracle date settings and will break - OpenACS since OpenACS depends on the ANSI date format, YYYY-MM-DD - dates. - - + - - Log out as oracle - - - + These lines will change the Oracle date settings and will break + OpenACS since OpenACS depends on the ANSI date format, YYYY-MM-DD + dates. + + + + + + + Log out as oracle + + + + oracle:~$ exit - + - - Log back in as oracle and double - check that your environment variables are as intended. The - env command lists all of the - variables that are set in your environment, and - grep shows you just the lines - you want (those with ORA in it). - + - -oracle:~$ su - oracle + Log back in as oracle and double + check that your environment variables are as intended. The + env command lists all of the + variables that are set in your environment, and + grep shows you just the lines + you want (those with ORA in it). + + + + +joeuser:~$ su - oracle oracle:~$ env | grep ORA - - If it worked, you should see: - + - + If it worked, you should see: + + + + ORACLE_SID=ora8 ORACLE_BASE=/ora8/m01/app/oracle ORACLE_TERM=vt100 ORACLE_HOME=/ora8/m01/app/oracle/product/8.1.7 ORA_NLS33=/ora8/m01/app/oracle/product/8.1.7/ocommon/nls/admin/data - - If not, try adding the files to - ~/.bashrc instead of - .bash_profile. Then logout and - log back in again. Also, be certain you are doing - su - oracle and not just - su oracle. The - - means that - .bashrc and - .bash_profile will be - evaluated. - + - - Make sure that /bin, - /usr/bin, and - /usr/local/bin are in your path - by typing: - + If not, try adding the files to + ~/.bashrc instead of + .bash_profile. Then logout and + log back in again. Also, be certain you are doing + su - oracle and not just + su oracle. The + - means that + .bashrc and + .bash_profile will be + evaluated. - + + + + + Make sure that /bin, + /usr/bin, and + /usr/local/bin are in your path + by typing: + + + + oracle:~$ echo $PATH /bin:/usr/bin:/usr/local/bin:/usr/bin/X11:/usr/X11R6/bin:/home/oracle/bin:/ora8/m01/app/oracle/product/8.1.7/bin - - If they are not, then add them to the - .bash_profile by changing the - PATH statement above to - PATH=$PATH:/usr/local/bin:$ORACLE_HOME/bin - - - + + + If they are not, then add them to the + .bash_profile by changing the + PATH statement above to + PATH=$PATH:/usr/local/bin:$ORACLE_HOME/bin + + + + - Installing Oracle 8.1.7 Server + Installing Oracle 8.1.7 Server - - - Log in as oracle and - start X if not already running. Start a new terminal: - + + + Log in as oracle and + start X if not already running. Start a new terminal: + - + joeuser:~$ xhost +localhost joeuser:~$ su - oracle Password: ********** oracle:~$ export DISPLAY=localhost:0.0 - + - - Find the runInstaller script - + - - - If you are installing Oracle from a CD-ROM, it is located in - the install/linux path from - the cd-rom mount point - + Find the runInstaller script - + + + + + + If you are installing Oracle from a CD-ROM, it is located in + the install/linux path from + the cd-rom mount point + + + + oracle:~$ su - root root:~# mount -t iso9660 /dev/cdrom /mnt/cdrom root:~# exit oracle:~$ cd /mnt/cdrom - + - - If you are installing from the tarball, the install script is - located in the Oracle8iR2 - directory that was created when you expanded the archive. - + - + If you are installing from the tarball, the install script is + located in the Oracle8iR2 + directory that was created when you expanded the archive. + + + + oracle:~$ cd /where/oracle/Disk1 - - + + - - Check to make sure the file is there. - + - + Check to make sure the file is there. + + + + oracle:/where/oracle/Disk1$ ls doc index.htm install runInstaller stage starterdb - - If you don't see - runInstaller, you are in the - wrong directory. - - + - - Run the installer - + If you don't see + runInstaller, you are in the + wrong directory. - + + + + + + Run the installer + + + + oracle:/where/oracle/Disk1$ ./runInstaller - - A window will open that welcomes you to the 'Oracle Universal - Installer' (OUI). Click on - "Next" - + - - - Some people have had trouble with this step on RedHat 7.3. If - so, try the following steps before calling - ./runInstaller: - - - - Install the compat-glibc, compat-egcs, compat-libs RPM for 2.1.3. - - - - Execute the following command: /usr/i386-glib21-linux/bin/i386-glibc21-linux-env.sh - - + A window will open that welcomes you to the 'Oracle Universal + Installer' (OUI). Click on + "Next" - - - Type export LD_ASSUME_KERNEL=2.2.5 - - - - - + - - The "File Locations" screen in the OUI: - + + + Some people have had trouble with this step on RedHat 7.3 and 8.0. If + so, try the following steps before calling + ./runInstaller: - - - "Source" path should have been - prefilled with "(wherever you mounted the - CDROM)/stage/products.jar" - + + + + - - "destination" path says - "/ora8/m01/app/oracle/product/8.1.7" - + Install the compat-glibc, compat-egcs, compat-libs RPM for + 2.1.3. + + + - - If the destination is not correct it is because your - environment variables are not set properly. Make sure you - logged on as oracle using - su - oracle. If so, edit the - ~/.bash_profile as you - did in - - + + - - Click "Next" (a pop up window will display Loading - Product information). - - - + Execute the following command: + /usr/i386-glib21-linux/bin/i386-glibc21-linux-env.sh - - The "Unix Group Name" screen in the OUI: - + + - - - The Unix Group name needs to be set to - 'oinstall' ( we made - this Unix group earlier ). - + + - - Click "Next" - + Type export LD_ASSUME_KERNEL=2.2.5 - - A popup window appears instantly, requesting you - to run a script as root: - + + + + + - - - Debian users need to link - /bin/awk to - /usr/bin/awk before - running the script below - + - -joueser:~$ su - -root:~# ln -s /usr/bin/awk /bin/awk - - + The "File Locations" screen in the OUI: - - Open a new terminal window, then type: - + - + + + + "Source" path should have been + prefilled with "(wherever you mounted the + CDROM)/stage/products.jar" + + + + + + "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 oracle using + su - oracle. If so, edit the + ~/.bash_profile as you + did in + + + + + + + Click "Next" (a pop up window will display Loading + Product information). + + + + + + + + The "Unix Group Name" screen in the OUI: + + + + + + + The Unix Group name needs to be set to + 'oinstall' ( we made + this Unix group earlier ). + + + + + + Click "Next" + + + + + + A popup window appears instantly, requesting you + to run a script as root: + + + + + + + Debian users need to link + /bin/awk to + /usr/bin/awk before + running the script below + + + + +joueser:~$ su - +root:~# ln -s /usr/bin/awk /bin/awk + + + + + + Open a new terminal window, then type: + + + + joeuser:~$ su - root:~# cd /ora8/m01/app/oracle/product/8.1.7 root:~# ./orainstRoot.sh @@ -512,202 +637,272 @@ root:~# mkdir -p /usr/local/java root:~# exit joeuser:~$ exit - + - - Click "Retry" - - - + + + Click "Retry" + + + + + + + + The "Available Products" screen in the OUI: + + + + + + + Select "Oracle 8i Enterprise Edition 8.1.7.1.0" + + + + - - The "Available Products" screen in the OUI: - + Click "Next" + + + + + + + + The "Installation Types" screen + + + + + + + Select the "Custom" installation type. + + + + + + Click "Next" + + + + + + + + The "Available Product Components" screen + + + + + + + In addition to the defaults, make sure that "Oracle SQLJ + 8.1.7.0," "Oracle Protocol Support 8.1.7.0.0," and + "Linux Documentation 8.1.7.0.0" are also checked. + + + + + + Click "Next" + + + + + + A progress bar will appear for about 1 minute. + + + + + + + + The "Component Locations" screen in the OUI + + + + + + + Click on the "Java Runtime Environment 1.1.8" It + should have the path + "/ora8/m01/app/oracle/jre/1.1.8" + + + + + + Click "Next" + + + + + + A progress bar will appear for about 1 minute. + + + + + + + + The "Privileged Operation System Groups" screen in the + OUI + + + + + + + Enter "dba" for "Database Administrator + (OSDBA) Group" + + + + - - - Select "Oracle 8i Enterprise Edition 8.1.7.1.0" - + Enter "dba" for the "Database Operator + (OSOPER) Group" - Click "Next" - - + - - The "Installation Types" screen - + - - - Select the "Custom" installation type. - + Click "Next" - Click "Next" - - + - - The "Available Product Components" screen - + - - - In addition to the defaults, make sure that "Oracle SQLJ - 8.1.7.0," "Oracle Protocol Support 8.1.7.0.0," and - "Linux Documentation 8.1.7.0.0" are also checked. - + A progress bar will appear for about 1 minute. - - Click "Next" - + + + - - A progress bar will appear for about 1 minute. - - - + - - The "Component Locations" screen in the OUI - + The "Authentication Methods" screen + + + + - - - Click on the "Java Runtime Environment 1.1.8" It - should have the path - "/ora8/m01/app/oracle/jre/1.1.8" - + Click "Next" - - Click "Next" - + + + - - A progress bar will appear for about 1 minute. - - - + - - The "Privileged Operation System Groups" screen in the - OUI - + The next screen is "Choose JDK home directory" - - - Enter "dba" for "Database Administrator - (OSDBA) Group" - + + + - - Enter "dba" for the "Database Operator - (OSOPER) Group" - + Keep the default path: /usr/local/java - - Click "Next" - + - - A progress bar will appear for about 1 minute. - - - + - - The "Authentication Methods" screen - - - - Click "Next" - - - + Click "Next" - - The next screen is "Choose JDK home directory" - - - - Keep the default path: /usr/local/java - + + + + + - - Click "Next" - - - + The "Create a Database" screen in the OUI + + + + + - - The "Create a Database" screen in the OUI - + Select "No" as we will do this later, after some + important configuration changes. + + + + - - - Select "No" as we will do this later, after some - important configuration changes. - + Click "Next" + + + + + + - - Click "Next" - - - + The next screen is "Oracle Product Support" - - The next screen is "Oracle Product Support" - + + + + - - - TCP should be checked with "Status" listed as - Required - + TCP should be checked with "Status" listed as + Required - - Click "Next" - - - + + + - - The "Summary" screen in the OUI - + Click "Next" - - - Check the "Space Requirements" section to verify - you have enough disk space for the install. - - - - Check that "(144 products)" is in the "New - Installations" section title. - + + + + + - - Click "Install" - + The "Summary" screen in the OUI - - A progress bar will appear for about 20 - 30 minutes. Now is a - good time to take a break. - + + + + - - A "Setup Privileges" window will popup towards the - end of the installation asking you to run a script as - root - + Check the "Space Requirements" section to verify + you have enough disk space for the install. - - Run the script. Switch to the oracle user first - to set the environment appropriately and then do - su to get root privileges, while keeping - the oracle user's enviroment. - + + + + Check that "(144 products)" is in the "New + Installations" section title. + - + + Click "Install" + + + + A progress bar will appear for about 20 - 30 minutes. Now is a + good time to take a break. + + + + A "Setup Privileges" window will popup towards the + end of the installation asking you to run a script as + root + + + + Run the script. Switch to the oracle user first + to set the environment appropriately and then do + su to get root privileges, while keeping + the oracle user's enviroment. + + + joeuser:~$ su - oracle Password: ********* oracle:~$ su @@ -739,555 +934,555 @@ Agent. These files may be found in the directories you use for storing other Net8 log and trace files. If such files exist, the OEM IA may not restart. - + - - Do not follow the instructions on deleting trace - and log files, it is not necessary. - - + + Do not follow the instructions on deleting trace + and log files, it is not necessary. + + - + root:~# exit joeuser:~$ exit - + - - Go back to the pop-up window and click "OK" - + + Go back to the pop-up window and click "OK" + - - The "Configuration Tools" screen in the OUI - + + The "Configuration Tools" screen in the OUI + - - - This window displays the config tools that will automatically - be launched. - - - + + + This window displays the config tools that will automatically + be launched. + + + - - The "Welcome" screen in the "net 8 Configuration - Assistant" - + + The "Welcome" screen in the "net 8 Configuration + Assistant" + - - - Make sure the "Perform Typical installation" is - not selected. - + + + Make sure the "Perform Typical installation" is + not selected. + - - Click "Next" - + + Click "Next" + - - The "Directory Service Access" screen in the - "Net 8 Configuration Assistant" - + + The "Directory Service Access" screen in the + "Net 8 Configuration Assistant" + - - Select "No" - + + Select "No" + - - Click "Next" - - - + + Click "Next" + + + - - The "Listener Configuration, Listener Name" screen in - the "Net 8 Configuration Assistant" - + + The "Listener Configuration, Listener Name" screen in + the "Net 8 Configuration Assistant" + - - - Accept the default listener name of "LISTENER" - + + + Accept the default listener name of "LISTENER" + - - Click "Next" - - - + + Click "Next" + + + - - The "Listener Configuration, Select - Protocols" screen in the "Net 8 Configuration - Assistant" - + + The "Listener Configuration, Select + Protocols" screen in the "Net 8 Configuration + Assistant" + - - - The only choice in "Select protocols:" should be - "TCP/IP" - + + + The only choice in "Select protocols:" should be + "TCP/IP" + - - Click "Next" - - - + + Click "Next" + + + - - The "Listener Configuration TCP/IP Protocol" screen in - the "Net 8 Configuration Assistant" - + + The "Listener Configuration TCP/IP Protocol" screen in + the "Net 8 Configuration Assistant" + - - - Default Port should be 1521 and selected. - + + + Default Port should be 1521 and selected. + - - Click "Next" - - - + + Click "Next" + + + - - The "Listener Configuration, More Listeners" screen in - the "Net 8 Configuration Assistant" - + + The "Listener Configuration, More Listeners" screen in + the "Net 8 Configuration Assistant" + - - - Select "No" - + + + Select "No" + - - Click "Next" - - - + + Click "Next" + + + - - The "Listener Configuration Done" screen in the - "Net 8 Configuration Assistant" - + + The "Listener Configuration Done" screen in the + "Net 8 Configuration Assistant" + - - - Click "Next" - - - + + + Click "Next" + + + - - The "Naming Methods Configuration" screen - in the "Net 8 Configuration Assistant" - + + The "Naming Methods Configuration" screen + in the "Net 8 Configuration Assistant" + - - - Select "No" - + + + Select "No" + - - Click "Next" - - - + + Click "Next" + + + - - The "Done" screen in the "Net 8 Configuration - Assistant" - + + The "Done" screen in the "Net 8 Configuration + Assistant" + - - - Click "Finish" - - - + + + Click "Finish" + + + - - The "End of Installation" screen in the OUI - + + The "End of Installation" screen in the OUI + - - - Click "Exit" - + + + Click "Exit" + - - Click "Yes" on the confirmation pop up window. - + + Click "Yes" on the confirmation pop up window. + - - The Oracle Universal Installer window should have disappeared! - - - - + + The Oracle Universal Installer window should have disappeared! + + + + - - Congratulations, you have just installed Oracle 8.1.7 Server! - However, you still need to create a database which can take about an - hour of non-interactive time, so don't quit yet. - + + Congratulations, you have just installed Oracle 8.1.7 Server! + However, you still need to create a database which can take about an + hour of non-interactive time, so don't quit yet. + - Creating the First Database - - - This step will take you through the steps of creating a customized - database. Be warned that this process takes about an hour on a - Pentium II with 128 MB of RAM. - + Creating the First Database + + + This step will take you through the steps of creating a customized + database. Be warned that this process takes about an hour on a + Pentium II with 128 MB of RAM. + - - RedHat 7.3 users: Before running dbassist, do the following. - - - Download the glibc - patch from Oracle Technet into /tmp. - - - cd $ORACLE_HOME - - - tar xzf /tmp/glibc2.1.3-stubs.tgz - - - ./setup_stubs - - - + + RedHat 7.3 and 8.0 users: Before running dbassist, do the following. + + + Download the glibc + patch from Oracle Technet into /tmp. + + + cd $ORACLE_HOME + + + tar xzf /tmp/glibc2.1.3-stubs.tgz + + + ./setup_stubs + + + - - - Make sure you are running X. Open up a terminal and - su to oracle and then run the - dbassist program. - + + + Make sure you are running X. Open up a terminal and + su to oracle and then run the + dbassist program. + - + joeuser:~$ xhost +localhost joeuser:~$ su - oracle Password: ********* oracle:~$ export DISPLAY=localhost:0.0 oracle:~$ dbassist - + - - The "Welcome" screen in the Oracle Database - Configuration Agent (ODCA) - + + The "Welcome" screen in the Oracle Database + Configuration Agent (ODCA) + - - - Select "Create a database" - + + + Select "Create a database" + - - Click "Next" - - - + + Click "Next" + + + - - The "Select database type" screen in the ODCA - + + The "Select database type" screen in the ODCA + - - - Select "Custom" - + + + Select "Custom" + - - Click "Next" - - - + + Click "Next" + + + - - The "Primary Database Type" window in ODCA - + + The "Primary Database Type" window in ODCA + - - - Select "Multipurpose" - + + + Select "Multipurpose" + - - Click "Next" - - - + + Click "Next" + + + - - The "concurrent users" screen of the ODCA - + + The "concurrent users" screen of the ODCA + - - - Select "60" concurrent users. - + + + Select "60" concurrent users. + - - Click "Next" - - + + Click "Next" + + - + - - Select "Dedicated Server - Mode", click - "Next" - + + Select "Dedicated Server + Mode", click + "Next" + - - Accept all of the options, and click - "Next" Oracle Visual - Information Retrieval may be grayed out. If so, you can ignore - it; just make sure that everything else is checked. - + + Accept all of the options, and click + "Next" Oracle Visual + Information Retrieval may be grayed out. If so, you can ignore + it; just make sure that everything else is checked. + - - For "Global Database Name", enter - "ora8"; for - "SID", also enter - "ora8" (it should do - this automatically). Click - "Next". - + + For "Global Database Name", enter + "ora8"; for + "SID", also enter + "ora8" (it should do + this automatically). Click + "Next". + - - Accept the defaults for the next screen (control file - location). Click - "Next" - + + Accept the defaults for the next screen (control file + location). Click + "Next" + - - Go to the "temporary" and - "rollback" tabs, and change the Size - (upper-right text box) to - 150MB. Click - "Next" - + + Go to the "temporary" and + "rollback" tabs, and change the Size + (upper-right text box) to + 150MB. Click + "Next" + - - Increase the redo log sizes to - 10000K each. Click - "Next" - + + Increase the redo log sizes to + 10000K each. Click + "Next" + - - Use the default checkpoint interval & timeout. Click - "Next" - + + Use the default checkpoint interval & timeout. Click + "Next" + - - Increase "Processes" - to 100; - "Block Size" to - 4096 (better for small Linux - boxes; use 8192 for a big Solaris machine). - + + Increase "Processes" + to 100; + "Block Size" to + 4096 (better for small Linux + boxes; use 8192 for a big Solaris machine). + - - Accept the defaults for the Trace File Directory. Click - "Next" - + + Accept the defaults for the Trace File Directory. Click + "Next" + - - Finally, select "Save information to a shell - script" and click - "Finish" (We're - going to examine the contents of this file before creating our - database.) - + + Finally, select "Save information to a shell + script" and click + "Finish" (We're + going to examine the contents of this file before creating our + database.) + - - Click the "Save" - button. Oracle will automatically save it to the correct - directory and with the correct file name. This will likely be - /ora8/m01/app/oracle/product/8.1.7/assistants/dbca/jlib/sqlora8.sh - + + Click the "Save" + button. Oracle will automatically save it to the correct + directory and with the correct file name. This will likely be + /ora8/m01/app/oracle/product/8.1.7/assistants/dbca/jlib/sqlora8.sh + - - It will alert you that the script has been saved - successfully. - + + It will alert you that the script has been saved + successfully. + - - Now we need to customize the database configuration a bit. While - still logged on as oracle, edit - the database initialization script (run when the db loads). The - scripts are kept in - $ORACLE_HOME/dbs and the name of - the script is usually - initSID.ora - where SID is the SID of your - database. Assuming your - $ORACLE_HOME matches our default - of - /ora8/m01/app/oracle/product/8.1.7, - the following will open the file for editing. - + + Now we need to customize the database configuration a bit. While + still logged on as oracle, edit + the database initialization script (run when the db loads). The + scripts are kept in + $ORACLE_HOME/dbs and the name of + the script is usually + initSID.ora + where SID is the SID of your + database. Assuming your + $ORACLE_HOME matches our default + of + /ora8/m01/app/oracle/product/8.1.7, + the following will open the file for editing. + - + oracle:~$ emacs /ora8/m01/app/oracle/product/8.1.7/dbs/initora8.ora - + - - Add the following line to the end: - + + Add the following line to the end: + - + nls_date_format = "YYYY-MM-DD" - + - - Now find the open_cursors line - in the file. If you're using - emacs scroll up to the top of - the buffer and do CTRL-S and - type open_cursors to find the - line. The default is 100. Change - it to 500. - + + Now find the open_cursors line + in the file. If you're using + emacs scroll up to the top of + the buffer and do CTRL-S and + type open_cursors to find the + line. The default is 100. Change + it to 500. + - + open_cursors = 500 - + - - Save the file. In emacs, do CTRL-X - CTRL-S to save followed by - CTRL-X CTRL-C to exit or use - the menu. - + + Save the file. In emacs, do CTRL-X + CTRL-S to save followed by + CTRL-X CTRL-C to exit or use + the menu. + - - At this point, you are ready to initiate database creation. We - recommend shutting down X to free up some RAM unless you have 256 - MB of RAM or more. You can do this quickly by doing a - CRTL-ALT-BACKSPACE, but make - sure you have saved any files you were editing. You should now be - returned to a text shell prompt. If you get sent to a graphical - login screen instead, switch to a virtual console by doing - CRTL-ALT-F1. Then login as - oracle. - + + At this point, you are ready to initiate database creation. We + recommend shutting down X to free up some RAM unless you have 256 + MB of RAM or more. You can do this quickly by doing a + CRTL-ALT-BACKSPACE, but make + sure you have saved any files you were editing. You should now be + returned to a text shell prompt. If you get sent to a graphical + login screen instead, switch to a virtual console by doing + CRTL-ALT-F1. Then login as + oracle. + - - Change to the directory where the database creation script is and - run it: - + + Change to the directory where the database creation script is and + run it: + - + oracle:~$ cd /ora8/m01/app/oracle/product/8.1.7/assistants/dbca/jlib oracle:/ora8/m01/app/oracle/product/8.1.7/assistants/dbca/jlib$ ./sqlora8.sh - - In some instances, Oracle will save the file to - /ora8/m01/app/oracle/product/8.1.7/assistants/dbca - Try running the script there if your first attempt does not - succeed. - + + In some instances, Oracle will save the file to + /ora8/m01/app/oracle/product/8.1.7/assistants/dbca + Try running the script there if your first attempt does not + succeed. + - - Your database will now be built. It will take > 1 hour - no - fooling. You will see lots of errors scroll by (like: - "ORA-01432: public synonym to be dropped does not - exist") Fear not, this is normal. - + + Your database will now be built. It will take > 1 hour - no + fooling. You will see lots of errors scroll by (like: + "ORA-01432: public synonym to be dropped does not + exist") Fear not, this is normal. + - - Eventually, you'll be returned to your shell prompt. In the - meantime, relax, you've earned it. - - - + + Eventually, you'll be returned to your shell prompt. In the + meantime, relax, you've earned it. + + + - Acceptance Test + Acceptance Test - - For this step, open up a terminal and - su to - oracle as usual. You should be - running X and Netscape (or other web browser) for this phase. - + + For this step, open up a terminal and + su to + oracle as usual. You should be + running X and Netscape (or other web browser) for this phase. + - - - You need to download the "Oracle Acceptance Test" file. - It's available here and at http://philip.greenspun.com/wtr/oracle/acceptance-sql.txt. - Save the file to /tmp - + + + You need to download the "Oracle Acceptance Test" file. + It's available here and at http://philip.greenspun.com/wtr/oracle/acceptance-sql.txt. + Save the file to /tmp + - - In the oracle shell, copy the file. - + + In the oracle shell, copy the file. + - + oracle:~$ cp /tmp/acceptance-sql.txt /tmp/acceptance.sql - + - - Once you've got the acceptance test file all set, stay in - your term and type the following: - + + Once you've got the acceptance test file all set, stay in + your term and type the following: + - + oracle:~$ sqlplus system/manager - - SQL*Plus should startup. If you get an ORA-01034: - Oracle not Available error, it is because your - Oracle instance is not running. You can manually start it as - the oracle user. + + SQL*Plus should startup. If you get an ORA-01034: + Oracle not Available error, it is because your + Oracle instance is not running. You can manually start it as + the oracle user. - + oracle:~$ svrmgrl SVRMGR> connect internal SVRMGR> startup - + - - Now that you're into SQL*Plus, change the default passwords - for system, sys, and ctxsys to "alexisahunk" (or to - something you'll remember): - + + Now that you're into SQL*Plus, change the default passwords + for system, sys, and ctxsys to "alexisahunk" (or 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; - + - - Verify that your date settings are correct. - + + 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 . - + + If you don't see a date that fits the format + YYYY-MM-DD, please read . + - - At this point we are going to hammer your database with an - intense acceptance test. This usually takes around 30 minutes. - + + At this point we are going to hammer your database with an + intense acceptance test. This usually takes around 30 minutes. + - + SQL> @ /tmp/acceptance.sql ; A bunch of lines will scroll by. You'll know if the test worked if @@ -1299,128 +1494,128 @@ SQL> - - Many people encounter an error regarding maximum - key length: - + + Many people encounter an error regarding maximum + key length: + - + ERROR at line 1: ORA-01450: maximum key length (758) exceeded - - This error occurs if your database block size is wrong and is - usually suffered by people trying to load OpenACS into a - pre-existing database. Unfortunately, the only solution is to - create a new database with a block size of at least - 4096. For instructions on how to - do this, see above. You - can set the parameter using the - dbassist program or by setting - the DB_BLOCK_SIZE parameter in - your database's creation script. - + + This error occurs if your database block size is wrong and is + usually suffered by people trying to load OpenACS into a + pre-existing database. Unfortunately, the only solution is to + create a new database with a block size of at least + 4096. For instructions on how to + do this, see above. You + can set the parameter using the + dbassist program or by setting + the DB_BLOCK_SIZE parameter in + your database's creation script. + - - If there were no errors, then consider yourself fortunate. Your - Oracle installation is working. - - - + + If there were no errors, then consider yourself fortunate. Your + Oracle installation is working. + + + - Automating Startup & Shutdown + Automating Startup & Shutdown - - 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. - + + 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. + - - - Oracle includes a script called - dbstart that can be used to - automatically start the database. Unfortunately, the script - shipped in the Linux distribution does not work out of the - box. The fix is simple. Follow these directions to apply - it. First, save dbstart to - /tmp. Then, as - oracle, do the following: - + + + Oracle includes a script called + dbstart that can be used to + automatically start the database. Unfortunately, the script + shipped in the Linux distribution does not work out of the + box. The fix is simple. Follow these directions to apply + it. First, save dbstart to + /tmp. Then, as + oracle, do the following: + - + oracle:~$ cp /tmp/dbstart.txt /ora8/m01/app/oracle/product/8.1.7/bin/dbstart oracle:~$ chmod 755 /ora8/m01/app/oracle/product/8.1.7/bin/dbstart - + - + - While you're logged in as - oracle, you should configure the - oratab file to load your - database at start. Edit the file - /etc/oratab: - + While you're logged in as + oracle, you should configure the + oratab file to load your + database at start. Edit the file + /etc/oratab: + - - You will see this line. + + You will see this line. - + ora8:/ora8/m01/app/oracle/product/8.1.7:N - - By the way, if you changed the service name or have multiple - databases, the format of this file is: - + + By the way, if you changed the service name or have multiple + databases, the format of this file is: + - - service_name:$ORACLE_HOME:Y || N - (for autoload) - - + + service_name:$ORACLE_HOME:Y || N + (for autoload) + + - - Change the last letter from "N" to - "Y". This tells Oracle that you want the database - to start when the machine boots. It should look like this. - + + Change the last letter from "N" to + "Y". This tells Oracle that you want the database + to start when the machine boots. It should look like this. + - + ora8:/ora8/m01/app/oracle/product/8.1.7:Y - + - - Save the file & quit the terminal. - - - + + Save the file & quit the terminal. + + + - - You need a script to automate startup and shutdown. Save oracle8i.txt in - /tmp. Then login as - root and install the - script. (Debian users: substitute - /etc/init.d for - /etc/rc.d/init.d throughout - this section) - + + You need a script to automate startup and shutdown. Save oracle8i.txt in + /tmp. Then login as + root and install the + script. (Debian users: substitute + /etc/init.d for + /etc/rc.d/init.d throughout + this section) + - + oracle:~$ su - root:~# cp /tmp/oracle8i.txt /etc/rc.d/init.d/oracle8i root:~# chown root.root /etc/rc.d/init.d/oracle8i root:~# chmod 700 /etc/rc.d/init.d/oracle8i - + - - Test the script by typing the following commands and checking the - output. (Debian Users: as root, do mkdir - /var/lock/subsys first) - + + Test the script by typing the following commands and checking the + output. (Debian Users: as root, do mkdir + /var/lock/subsys first) + root:~# /etc/rc.d/init.d/oracle8i stop @@ -1466,25 +1661,25 @@ Database "ora8" warm started. Database "ora8" warm started. - + - - If it worked, then run these commands to make the startup and - shutdown automatic. - + + If it worked, then run these commands to make the startup and + shutdown automatic. + - - Red Hat users: - + + Red Hat users: + root:~# cd /etc/rc.d/init.d/ root:~# chkconfig --add oracle8i root:~# chkconfig --list oracle8i ; You should see: oracle8i 0:off 1:off 2:off 3:on 4:on 5:on 6:off - + - Debian users: - + Debian users: + root:~# update-rc.d oracle8i defaults Adding system startup for /etc/init.d/oracle8i ... /etc/rc0.d/K20oracle8i -> ../init.d/oracle8i @@ -1494,10 +1689,10 @@ /etc/rc3.d/S20oracle8i -> ../init.d/oracle8i /etc/rc4.d/S20oracle8i -> ../init.d/oracle8i /etc/rc5.d/S20oracle8i -> ../init.d/oracle8i - + - SuSE users: - + SuSE users: + root:~# cd /etc/rc.d/init.d root:/etc/rc.d/init.d# ln -s /etc/rc.d/init.d/oracle8i K20oracle8i root:/etc/rc.d/init.d# ln -s /etc/rc.d/init.d/oracle8i S20oracle8i @@ -1538,44 +1733,44 @@ Executing /sbin/conf.d/SuSEconfig.ypclient... Processing index files of all manpages... Finished. - - + + - + - - You also need some scripts to automate startup and shutdown of - the Oracle8i listener. The listener is a name server that allows - your Oracle programs to talk to local and remote databases using - a standard naming convention. It is required for Intermedia Text - and full site search. - + + You also need some scripts to automate startup and shutdown of + the Oracle8i listener. The listener is a name server that allows + your Oracle programs to talk to local and remote databases using + a standard naming convention. It is required for Intermedia Text + and full site search. + - - Download these three scripts into - /tmp - + + Download these three scripts into + /tmp + - - - startlsnr.txt - + + + startlsnr.txt + - - stoplsnr.txt - + + stoplsnr.txt + - - listener8i.txt - - + + listener8i.txt + + - - Now issue the following commands (still as - root). - + + Now issue the following commands (still as + root). + - + root:~# su - oracle oracle:~$ cp /tmp/startlsnr.txt /ora8/m01/app/oracle/product/8.1.7/bin/startlsnr oracle:~$ cp /tmp/stoplsnr.txt /ora8/m01/app/oracle/product/8.1.7/bin/stoplsnr @@ -1586,12 +1781,12 @@ root:~# cd /etc/rc.d/init.d root:/etc/rc.d/init.d# chmod 700 listener8i - - Test the listener automation by running the following commands - and checking the output. - + + Test the listener automation by running the following commands + and checking the output. + - + root:/etc/rc.d/init.d# ./listener8i stop Oracle 8i listener start/stop Shutting down Listener for 8i: @@ -1635,18 +1830,18 @@ ora8 has 1 service handler(s) The command completed successfully - - This test will verify that the listener is operating - normally. Login into the database using the listener naming - convention. - + + This test will verify that the listener is operating + normally. Login into the database using the listener naming + convention. + - - sqlplus - username/password/@SID - + + sqlplus + username/password/@SID + - + root:~# su - oracle oracle:~$ sqlplus system/alexisahunk@ora8 @@ -1660,25 +1855,25 @@ oracle:~$ exit root:~# - - RedHat users: - - Now run chkconfig on the - listener8i script. - - + + RedHat users: + + Now run chkconfig on the + listener8i script. + + root:~# cd /etc/rc.d/init.d/ root:/etc/rc.d/init.d# chkconfig --add listener8i root:/etc/rc.d/init.d# chkconfig --list listener8i listener8i 0:off 1:off 2:off 3:on 4:on 5:on 6:off - + - Debian users: - - Now run update-rc.d on the - listener8i script. - - + Debian users: + + Now run update-rc.d on the + listener8i script. + + root:~# update-rc.d listener8i defaults 21 19 Adding system startup for /etc/init.d/listener8i ... /etc/rc0.d/K19listener8i -> ../init.d/listener8i @@ -1688,93 +1883,93 @@ /etc/rc3.d/S21listener8i -> ../init.d/listener8i /etc/rc4.d/S21listener8i -> ../init.d/listener8i /etc/rc5.d/S21listener8i -> ../init.d/listener8i - - - - - - Test the automation - + + + + + + Test the automation + - - As a final test, reboot your computer and make sure Oracle comes - up. You can do this by typing - + + As a final test, reboot your computer and make sure Oracle comes + up. You can do this by typing + - + root:~# /sbin/shutdown -r -t 0 now - - Log back in and ensure that Oracle started automatically. - + + Log back in and ensure that Oracle started automatically. + - + joeuser:~$ su - oracle oracle:~$ sqlplus system/alexisahunk@ora8 SQL> exit - - + + - - Congratulations, your installation of Oracle 8.1.7 is - complete. - + + Congratulations, your installation of Oracle 8.1.7 is + complete. + - Troubleshooting Oracle Dates + Troubleshooting Oracle Dates - - Oracle has an internal representation for storing the data based on - the number of seconds elapsed since some date. However, for the - purposes of inputing dates into Oracle and getting them back out, - Oracle needs to be told to use a specific date format. By default, it - uses an Oracle-specific format which isn't copacetic. You want - Oracle to use the ANSI-compliant date format which is of form - 'YYYY-MM-DD'. - + + Oracle has an internal representation for storing the data based on + the number of seconds elapsed since some date. However, for the + purposes of inputing dates into Oracle and getting them back out, + Oracle needs to be told to use a specific date format. By default, it + uses an Oracle-specific format which isn't copacetic. You want + Oracle to use the ANSI-compliant date format which is of form + 'YYYY-MM-DD'. + - - To fix this, you should include the following line in - $ORACLE_HOME/dbs/initSID.ora - or for the default case, - $ORACLE_HOME/dbs/initora8.ora - + + To fix this, you should include the following line in + $ORACLE_HOME/dbs/initSID.ora + or for the default case, + $ORACLE_HOME/dbs/initora8.ora + - + nls_date_format = "YYYY-MM-DD" - - You test whether this solved the problem by firing up - sqlplus and typing: - + + You test whether this solved the problem by firing up + sqlplus and typing: + - + SQL> select sysdate from dual; - - You should see back a date like - 2000-06-02. If some of the date is - chopped off, i.e. like 2000-06-0, - everything is still fine. The problem here is that - sqlplus is simply truncating the - output. You can fix this by typing: - + + You should see back a date like + 2000-06-02. If some of the date is + chopped off, i.e. like 2000-06-0, + everything is still fine. The problem here is that + sqlplus is simply truncating the + output. You can fix this by typing: + - + SQL> column sysdate format a15 SQL> select sysdate from dual; - - If the date does not conform to this format, double-check that you - included the necessary line in the init scripts. If it still - isn't working, make sure that you have restarted the database - since adding the line: - + + If the date does not conform to this format, double-check that you + included the necessary line in the init scripts. If it still + isn't working, make sure that you have restarted the database + since adding the line: + - -nsadmin:~$ svrmgrl + +joeuser:~$ svrmgrl SVRMGR> connect internal Connected. SVRMGR> shutdown @@ -1784,132 +1979,132 @@ SVRMGR> startup ORACLE instance started. - - If you're sure that you have restarted the database since adding - the line, check your initialization scripts. Make sure that the - following line is not included: - + + If you're sure that you have restarted the database since adding + the line, check your initialization scripts. Make sure that the + following line is not included: + - + export nls_lang = american - - Setting this environment variable will override the date - setting. Either delete this line and login again or add the following - entry to your login scripts after the - nls_lang line: - + + Setting this environment variable will override the date + setting. Either delete this line and login again or add the following + entry to your login scripts after the + nls_lang line: + - + export nls_date_format = 'YYYY-MM-DD' - - Log back in again. If adding the - nls_date_format line doesn't - help, you can ask for advice in our OpenACS forum. - + + Log back in again. If adding the + nls_date_format line doesn't + help, you can ask for advice in our OpenACS forum. + - Useful Procedures + Useful Procedures - - - Dropping a tablespace - + + + Dropping a tablespace + - - - Run sqlplus as the dba: - + + + Run sqlplus as the dba: + - + oracle:~$ sqlplus system/changeme - + - - To drop a user and all of the tables and data owned by that - user: - + + To drop a user and all of the tables and data owned by that + user: + - + SQL> drop user oracle_user_name cascade; - + - - To drop the tablespace: This will delete everything in the - tablespace overriding any referential integrity - constraints. Run this command only if you want to clean out - your database entirely. - - + + To drop the tablespace: This will delete everything in the + tablespace overriding any referential integrity + constraints. Run this command only if you want to clean out + your database entirely. + + SQL> drop tablespace table_space_name including contents cascade constraints; - - - - + + + + - - For more information on Oracle, please consult the documentation. - + + For more information on Oracle, please consult the documentation. + - Defaults + Defaults - We used the following defaults while installing Oracle. + We used the following defaults while installing Oracle. - - - - - Variable - Value - Reason - - + + + + + Variable + Value + Reason + + - - - ORACLE_HOME - /ora8/m01/app/oracle/product/8.1.7 - This is the default Oracle installation directory. - - - - ORACLE_SERVICE - ora8 - The service name is a domain-qualified identifier for - your Oracle server. - - - - ORACLE_SID - ora8 - This is an identifier for your Oracle server. - - - - ORACLE_OWNER - oracle - The user who owns all of the oracle files. - + + + ORACLE_HOME + /ora8/m01/app/oracle/product/8.1.7 + This is the default Oracle installation directory. + + + + ORACLE_SERVICE + ora8 + The service name is a domain-qualified identifier for + your Oracle server. + + + + ORACLE_SID + ora8 + This is an identifier for your Oracle server. + + + + ORACLE_OWNER + oracle + The user who owns all of the oracle files. + - - ORACLE_GROUP - dba - The special oracle group. Users in the dba group are - authorized to do a connect - internal within - svrmgrl to gain full system - access to the Oracle system. - - - - + + ORACLE_GROUP + dba + The special oracle group. Users in the dba group are + authorized to do a connect + internal within + svrmgrl to gain full system + access to the Oracle system. + + + + ($Id$)