OpenPKG CVS Repository
  http://cvs.openpkg.org/
  ____________________________________________________________________________

  Server: cvs.openpkg.org                  Name:   Ralf S. Engelschall
  Root:   /e/openpkg/cvs                   Email:  [EMAIL PROTECTED]
  Module: openpkg-src openpkg-web          Date:   30-Jan-2004 16:44:54
  Branch: HEAD                             Handle: 2004013015445201

  Modified files:
    openpkg-src/oracle-barebone
                            oracle-barebone.spec oracle-barebone.txt
    openpkg-web             news.txt

  Log:
    enhance documentation

  Summary:
    Revision    Changes     Path
    1.6         +1  -1      openpkg-src/oracle-barebone/oracle-barebone.spec
    1.3         +106 -65    openpkg-src/oracle-barebone/oracle-barebone.txt
    1.8376      +1  -0      openpkg-web/news.txt
  ____________________________________________________________________________

  patch -p0 <<'@@ .'
  Index: openpkg-src/oracle-barebone/oracle-barebone.spec
  ============================================================================
  $ cvs diff -u -r1.5 -r1.6 oracle-barebone.spec
  --- openpkg-src/oracle-barebone/oracle-barebone.spec  24 Jan 2004 13:11:45 -0000     
 1.5
  +++ openpkg-src/oracle-barebone/oracle-barebone.spec  30 Jan 2004 15:44:53 -0000     
 1.6
  @@ -33,7 +33,7 @@
   Group:        Database
   License:      Commercial
   Version:      9.2.0.1
  -Release:      20040124
  +Release:      20040130
   
   #   list of sources
   Source0:      
http://www.oracle.com/::/oracle-barebone-%{version}.ix86-linux.cpio.bz2
  @@ .
  patch -p0 <<'@@ .'
  Index: openpkg-src/oracle-barebone/oracle-barebone.txt
  ============================================================================
  $ cvs diff -u -r1.2 -r1.3 oracle-barebone.txt
  --- openpkg-src/oracle-barebone/oracle-barebone.txt   24 Jan 2004 13:11:45 -0000     
 1.2
  +++ openpkg-src/oracle-barebone/oracle-barebone.txt   30 Jan 2004 15:44:53 -0000     
 1.3
  @@ -1,66 +1,107 @@
  -This is the Oracle Barebone distribution,
  -containing the Oracle 9i 9.2.0.1 Client C API. 
  -It is a stripped down installation file set of 
  -a standard Oracle 9i Client Run-Time installation.
  -
  -The following procedure was used to create this:
  -
  -1. Download from http://www.oracle.com/ (or currently directly on
  -   http://otn.oracle.com/software/products/oracle9i/) the Oracle 9i
  -   9.2.0.1 Distribution CPIO Archives:
  -
  -   553239173 May 10  2003 lnx_920_disk1.cpio.gz
  -   588798999 May 10  2003 lnx_920_disk2.cpio.gz
  -   442087410 May 10  2003 lnx_920_disk3.cpio.gz
  -   502320826 May 10  2003 92010Sol_Disk1.cpio.gz (32-bit download)
  -   597226006 May 10  2003 92010Sol_Disk2.cpio.gz (32-bit download)
  -   379469467 May 10  2003 92010Sol_Disk3.cpio.gz (32-bit download)
  -
  -   Actually on Linux/ix86 only Disk 1 is required while
  -   on Solaris/sparc64 Disk 1 and Disk 2 are required.
  -
  -2. On the target machine, create an "oracle" user and group plus an
  -   empty directory /oracle which is owned by this user/group. Then copy
  -   the CPIO archives into /oracle/src and unpack them into the subdirs
  -   /oracle/src/Disk[123].
  -
  -3. After making sure that you have X11 run-time environment available on
  -   both the target machine and your desktop, go to the /oracle/src/Disk1
  -   on the target machine and run the commands:
  -   
  -   $ DISPLAY=desktop:0
  -   $ export DISPLAY
  -   $ sh runInstaller
  -
  -   Then follow the dialogs and use "/oracle/oraInventory", the name
  -   "OracleHome" and the path "/oracle/OracleHome" when asked for the
  -   inventory path and the Oracle home name and directory. Then request
  -   the "Oracle 9i Client" product and use type "Run-Time" first. Then
  -   install through "Custom" type also the "Oracle Call Interface" and
  -   "Oracle Programmer" parts.
  -   
  -4. After all this you have around 200-300MB under /oracle/OracleHome
  -   now. Copy the companion oracle-barebone.pl file into
  -   /oracle/OracleHome and run the command:
  -
  -   #   on Linux:
  -   $ perl oracle-barebone.pl 9.2.0.1 ix86-linux
  -
  -   #   on Solaris:
  -   $ perl oracle-barebone.pl 9.2.0.1 sparc64-solaris
  -
  -   As a result you get CPIO archives like this one:
  -
  -   24650873 Dec 18 20:43 oracle-barebone-9.2.0.1.ix86-linux.cpio.bz2
  -   27713659 Dec 18 20:46 oracle-barebone-9.2.0.1.sparc64-solaris.cpio.bz2
  -
  -5. Copy the newly-created CPIO archive to:
  -   %{l_prefix}/RPM/SRC/oracle-barebone/
  -
  -6. To build an oracle-barebone binary RPM, go to 
  -   %{l_prefix}/RPM/SRC/oracle-barebone and run:
  -   rpm -bb oracle-barebone.spec
  -
  -7. Note that you will still need to build and install the oracle RPM
  -   in order to satisfy the dependencies of any package requiring ORACLE.
  +This is the OpenPKG Oracle "Barebone" distribution, containing the
  +Oracle 9i 9.2.0.1 Client CLI and C API. It is a heavily stripped
  +down installation file set of a standard Oracle 9i Client Run-Time
  +installation.
  +
  +The following step-by-step procedure was used to create the source RPM
  +oracle-barebone-9.2.0.1.src.rpm for use on the sparc64-solaris and
  +ix86-linux platforms:
  +
  +1.  Download (to your desktop) from http://www.oracle.com/ (or currently
  +    directly on http://otn.oracle.com/software/products/oracle9i/) the
  +    Oracle 9i 9.2.0.1 Distribution CPIO Archives:
  +
  +    desktop$ w3m http://otn.oracle.com/software/products/oracle9i/
  +
  +    553239173 May 10  2003 lnx_920_disk1.cpio.gz
  +    588798999 May 10  2003 lnx_920_disk2.cpio.gz
  +    442087410 May 10  2003 lnx_920_disk3.cpio.gz
  +    502320826 May 10  2003 92010Sol_Disk1.cpio.gz
  +    597226006 May 10  2003 92010Sol_Disk2.cpio.gz
  +    379469467 May 10  2003 92010Sol_Disk3.cpio.gz
  +
  +2.  On all target machines (for us a ix86-linux and a sparc64-solaris
  +    server), create an "oracle" user and group plus an empty directory
  +    /oracle which is owned by this user/group. Then copy the Oracle
  +    CPIO archives into /oracle/src and unpack them into the subdirs
  +    /oracle/src/Disk[123].
  +
  +    target$ mkdir /oracle
  +    target$ mkdir /oracle/src
  +    target$ cd /oracle/src
  +    target$ scp desktop:~/<target-id>[123].cpio.gz .
  +    target$ for i in 1 2 3; do \
  +            gunzip -d -c <target-id>$i.cpio.gz | cpio -idvmu; done
  +    target$ chown -R oracle:oracle /oracle
  +
  +3.  After making sure that you have a X11 run-time environment available
  +    on both the target machine and your desktop, run the Oracle installer:
  +
  +    target$ DISPLAY=desktop:0
  +    target$ export DISPLAY
  +    target$ cd /oracle/src/Disk1
  +    target$ sh runInstaller
  +
  +    Then follow the dialogs and use "/oracle/oraInventory", the name
  +    "OracleHome" and the path "/oracle/OracleHome" when asked for the
  +    inventory path and the Oracle home name and directory. Then request
  +    the "Oracle 9i Client" product and use type "Run-Time" first. Then
  +    install through "Custom" type also the "Oracle Call Interfaces" and
  +    "Oracle Programmer" parts.
  +
  +4.  Optionally, copy a suitable version of "tnsnames.ora" or "sqlnet.ora"
  +    to "/oracle/OracleHome/network/admin/".
  +
  +5.  After all this you have around 200-300MB under /oracle/OracleHome
  +    now. Copy the companion oracle-barebone.pl file into
  +    /oracle/OracleHome/ and run the command:
  +
  +    target$ cd /oracle/OracleHome
  +    target$ scp build:<prefix>/RPM/SRC/oracle-barebone/oracle-barebone.pl .
  +    #   on Linux target machine only:
  +    target$ perl oracle-barebone.pl 9.2.0.1 ix86-linux
  +    #   on Solaris target machine only:
  +    target$ perl oracle-barebone.pl 9.2.0.1 sparc64-solaris
  +
  +    As a result you get CPIO archives like these ones:
  +
  +    24650873 Dec 18 20:43 oracle-barebone-9.2.0.1.ix86-linux.cpio.bz2
  +    27713659 Dec 18 20:46 oracle-barebone-9.2.0.1.sparc64-solaris.cpio.bz2
  +
  +6.  Copy the newly-created CPIO archive from all target hosts back to
  +    your OpenPKG build host and build the "oracle-barebone" source RPM:
  +
  +    target$ scp *.cpio.bz2 build:<prefix>/RPM/SRC/oracle-barebone/
  +
  +    build$ cd <prefix>/RPM/SRC/oracle-barebone
  +    build$ rpm -bs oracle-barebone.spec
  +
  +7.  Now you can build and install the resulting "oracle-barebone" source
  +    RPM into all target-compatible servers. Just notice that you will still
  +    need to build and install the "oracle" OpenPKG package in order to
  +    satisfy the dependencies of any package requiring "ORACLE".
  +
  +HINTS:
  +
  +-   The "oracle-barebone" package is intended for mass deployment of
  +    Oracle Clients with the help of OpenPKG with the goal of no longer
  +    requiring X11 for installation and no longer requiring such a lot
  +    of disk space. If you just want to install the Oracle client on
  +    a single box where OpenPKG runs, this is not worth the efforts.
  +    Then stick with the standard Oracle Client installation and use the
  +    "oracle" glue package to locate it.
  +
  +-   In smaller environments the build and target hosts could be the
  +    same machine, of course. Here just forget our above notion of
  +    "build" host.
  +
  +-   In environments where you deploy the "oracle-barebone" package
  +    always into OpenPKG instaces under the same filesystem
  +    prefix, it could be reasonable (to avoid problems with
  +    the linkage of libraries) that you create a symlink from
  +    <prefix>/share/oracle-barebone to /oracle/OracleHome and then use
  +    <prefix>/share/oracle-barebone instead of /oracle/OracleHome in the
  +    Oracle installer. This way your library dependencies use already the
  +    target paths and you do not have to make sure that the applications
  +    you link against the libraries know about the paths.
   
  @@ .
  patch -p0 <<'@@ .'
  Index: openpkg-web/news.txt
  ============================================================================
  $ cvs diff -u -r1.8375 -r1.8376 news.txt
  --- openpkg-web/news.txt      30 Jan 2004 10:06:37 -0000      1.8375
  +++ openpkg-web/news.txt      30 Jan 2004 15:44:52 -0000      1.8376
  @@ -1,3 +1,4 @@
  +30-Jan-2004: Upgraded package: P<oracle-barebone-9.2.0.1-20040130>
   30-Jan-2004: Upgraded package: P<findutils-4.1.20-20040130>
   30-Jan-2004: Upgraded package: P<perl-gtk-20040130-20040130>
   30-Jan-2004: Upgraded package: P<postfix-mailgraph-1.7-20040130>
  @@ .
______________________________________________________________________
The OpenPKG Project                                    www.openpkg.org
CVS Repository Commit List                     [EMAIL PROTECTED]

Reply via email to