###############################################################################
# Dell Oracle Deployment TAR
###############################################################################

This is the Dell Oracle Deployment TAR release, it is put together in order to 
assist in the deployment of Oracle on Dell Tested and Validated Configurations.
There are a number of RPMs that are located in this directory that will need 
dependency resolution as well as some pre-requisitions in place that will be
documented in this file.

For more information and additional documentation:

Dell Oracle Solutions Wiki: http://delltechcenter.com/enterprise

Download the latest Dell Oracle Deployment Quickstart Guide from: 
http://en.community.dell.com/dell-groups/enterprise_solutions/m/
oracle_db_gallery/default.aspx
    - The document filename will be as follows:
        Dell Oracle Deployment Tar - Version: Lin-2012-XX

http://en.community.dell.com/dell-groups/enterprise_solutions/w/
oracle_solutions/default.aspx
    - This site provides best practice how-to guides.


# PRE-INSTALL
###############################################################################

### NOTE ###
# These steps should be completed on each node of the cluster being built.
#

There are some pre-requisites that are needed for DKMS in order to build the
driver modules properly and we will also need to verify that there is an 
available yum repository in order to satisfy package dependencies during 
installation. Local yum, RHN, ULN, or otherwise are all applicable but we 
will only cover the setup of a local yum repository here.

The recommended configuration is to serve the files over http using an 
Apache http server (package name: httpd).

This readme will discuss hosting the repository files from a local 
filesystem storage. While other options to host repository files exist, 
they are outside of the scope of this readme. Using local filesystem 
storage is our recommendation for the combination of speed and simplicity 
of maintenance.    

One of the requirements is to have the DVD image mounted either by physical 
media or by ISO image.

In order to mount the DVD, insert the DVD into the server and  it should 
auto-mount into the /media directory. If not, check for the device name it
mounted as in the tail end of the /var/log/messages file and mount it to a
directory of your choosing. Example:

    mount -t iso9660 -o ro /dev/cdrom /media/myISO


In order to mount an ISO image we will need to run the following command as 
root, substituting the path name of your ISO image for the field "myISO.iso":
    
    mkdir /media/myISO
    mount -o loop myISO.iso /media/myISO


In order to install and configure the http daemon we will first need to 
configure the machine that will host the repository for all other machines to 
use the DVD image locally. Create the file /etc/yum.repos.d/local.repo and 
input the following:

    [local]
    name=Local Repository
    baseurl=file:///media/myISO
    gpgcheck=0
    enabled=0


Now we will install the Apache service daemon with the following command which 
will also temporarily enable the local repository for dependency resolution:

    yum -y install httpd --enablerepo=local

Once the Apache service daemon is installed, start the service and set it to 
start up for us next time we reboot. Run the following commands as root:

    service httpd start
    chkconfig httpd on


In order to use Apache to serve out the repository we will need to copy the 
contents of the DVD mount into a published web directory, run the following 
commands as root (make sure to switch myISO with the name of your ISO as we did
in the previous command:

    mkdir /var/www/html/myISO
    cp -R /media/myISO/* /var/www/html/myISO

### NOTE ###   
# The command "createrepo" is often used for creating custom repositories, but 
# it is not required as the DVD already holds the repository information 
# required. 
#
# The following step is only necessary if you are running SELinux on
# the server that will be hosting the repository. The following command should 
# be run as root and will restore the appropriate SELinux context to the files 
# we just copied:
#    restorecon -Rvv /var/www/html/

The final step is to gather the DNS name or IP of the server that is hosting 
the repository. The DNS name or IP of the hosting server will be used to 
configure your yum repository repo file on the client server/system. The 
following is the listing of an example config using the RHEL 5.5 Server DVD and
is held in the configuration file /etc/yum.repos.d/myRepo.repo 

This file should exist on all client nodes needing access to the yum repository.

[myRepo]
name=RHEL5.5 DVD
baseurl=http://reposerver.mydomain.com/RHEL5_5/Server
enabled=1
gpgcheck=0

### NOTE ###
# Replace reposerver.mydomain.com with your server's DNS name or ip address

### NOTE ###
# You can also place this configuration file on the server hosting the 
# repository for all other servers such that it can also use the repository as 
# a more permanent solution to what was done in Step 2
#

Now that the yum repository has been set up we will need to run the following 
command in order to pull in the packages needed for the installation of the 
DKMS system:

    yum -y install gcc kernel-devel kernel-headers


# INSTALLING
###############################################################################

### NOTE ###
# These steps should be completed on each node of the cluster being built.
#

First we need to install the Drivers which will be accomplished by running
the following command (pending the pre-requisites have been satisfied in the
previous section of this document).

    In the following example we will use the directory path /foo/bar/ but this
    should be replaced with the actual path to the extracted tar.

    yum localinstall /foo/bar/Drivers/* --nogpgcheck

Now we need to install the Dell Validated RPM (a fork of the
Oracle Validated RPM from Oracle) in order to implement Oracle 
recommendations in one easy step.

The Dell Validated RPM is located in this directory.

    First download into a local location (example /foo/bar/) and run the 
    following command replacing the /foo/bar with the correct path:

        yum -y localinstall /foo/bar/dell-validated* --nogpgcheck


From this point the system is ready for the Dell Oracle Utilities
and we will acquire those from this directory (just grab latest version). 
Download the rpm to a local location (example /foo/bar) and run the 
following command (replacing the /foo/bar with the appropriate path name 
on your system):

    yum -y localinstall /foo/bar/dell-oracle-utilities* --nogpgcheck

Among the utilities installed with this RPM, the one of importance for this
task is called "dodeploy" and stands for "Dell Oracle Deployment." In order
to complete the setup steps required for an Oracle RAC 11gR2 with Grid 
Infrastructure deployment we will run the following command:
    
    dodeploy -g -r 11gR2

    ### NOTE ###
    # For more information on dodeploy, see "man 8 dodeploy"

At this point the system is configured as needed for the deployment of
Oracle 11gR2 with Grid Infrastructure.


