Rapid Home Provisioning has several methods to provision and, optionally, configure Oracle Grid Infrastructure homes.

• To inform Rapid Home Provisioning the nodes on which to install Oracle Grid Infrastructure, and to configure Oracle Grid Infrastructure, you provide directions in a response file, as in the following example:

  $ rhpctl add workingcopy -workingcopy GI_HOME_11204_WCPY -image GI_HOME_11204 –responsefile /u01/app/rhpinfo/GI_11204_install.txt –root root/sudo credentials

  The preceding command provisions the GI_HOME_11204_WCPY working copy based on the GI_HOME_11204 gold image to a target specified in the GI_11204_install.txt response file. In addition to identifying the target nodes, the response file specifies information about the Oracle Grid Infrastructure configuration, such as Oracle ASM and GNS parameters.

  Note:

  The oracle.install.crs.rootconfig.executeRootScript=xxx response file parameter is overridden and always set to false for Rapid Home Provisioning, regardless of what you specify in the response file.
• To provision an Oracle Grid Infrastructure home to a node or cluster that is currently running Oracle Grid Infrastructure:

  $ rhpctl add workingcopy -workingcopy GI_HOME_12201_PATCHED_WCPY -image GI_HOME_12201_PSU1 –client CLUST_002 -softwareonly

  The preceding command provisions a new working copy based on the GI_HOME_12201_PSU1 gold image to the Rapid Home Provisioning Client (that is running Oracle Grid Infrastructure 12c release 2 (12.2)) named CLUST_002. When you provision to a target that is not running Oracle Grid Infrastructure 12c release 2 (12.2) (such as, a target running Oracle Grid Infrastructure 12c release 1 (12.1) or Oracle Grid Infrastructure 11g release 2 (11.2)), use the -targetnode parameter instead of -client.

Rapid Home Provisioning provides three methods to patch Oracle Grid Infrastructure software homes: rolling, non-rolling, and in batches.

If you are using Rapid Home Provisioning, then you can use a single command to upgrade an Oracle Grid Infrastructure home.

$ rhpctl upgrade gihome -sourcewc GIOH11204 -destwc GIOH12201

Use the rhpctl add workingcopy command to provision a working copy of a database home on a Rapid Home Provisioning Server, Client, or target.

• Run the rhpctl add workingcopy command on a Rapid Home Provisioning Server, similar to the following example:

  $ rhpctl add workingcopy -image db12c -path /u01/app/dbusr/product/12.2.0/db12201
    -client client_007 -oraclebase /u01/app/dbusr/ -workingcopy wc_db122_1

  The preceding command example creates a working copy named wc_db122_1 on all nodes of the Rapid Home Provisioning Client cluster named client_007. The gold image db12c is the source of the workingcopy. The directory path locations that you specify in the command must be empty.

Create an Oracle Database on a working copy.

• After you create a working copy of a gold image and provision that working copy to a target, you can create an Oracle Database on the working copy using the rhpctl add database command, similar to the following command example, which creates an Oracle Real Application Clusters (Oracle RAC) database called db12201 on a working copy called wc_db122_1:

  $ rhpctl add database –workingcopy wc_db122_1 –dbname db12201 -node client_007_node1,client_007_node2 -dbtype RAC -datafileDestination DATA007_DG

To patch an Oracle Database, you move the database home to a working copy which includes the patches you want to implement.

1. Create a working copy of the Oracle Database that you want to patch, in this case DB122.
2. Apply the patch to the working copy you created.
3. Test and validate the patched working copy.
4. Use the rhpctl add image command to create a gold image (for example, DB122_PATCH) from the patched working copy.

   Note:

   The working copy you specify in the preceding command must be hosted on the Rapid Home Provisioning Server in Rapid Home Provisioning-managed storage.
5. Delete the patched working copy with the patched Oracle Database using the rhpctl delete workingcopy command.

   Note:

   Do not remove directly using the rm command or some other method, because this does not update the Rapid Home Provisioning inventory information.
6. Create a working copy from the patched gold image, (DB122_PATCH).
7. Move myorcldb to the working copy you just created.
8. When you are confident that you will not need to roll back to the working copy on which the database was running at the beginning of the procedure, delete that working copy using the rhpctl delete workingcopy command.

There is a single Rapid Home Provisioning command for upgrading a database.

Provision Oracle Grid Infrastructure software on two nodes that do not currently have a Grid home, and then configure Oracle Grid Infrastructure to form a multi-node Oracle Grid Infrastructure installation.

1. From the Rapid Home Provisioning Server, run the command:

   rhpctl add workingcopy -workingcopy GI122 -image GI_HOME_12201 –responsefile /u01/app/rhpinfo/GI_12201_install.rsp –root

   GI122 is the working copy based on the image GI_HOME_12201

   /u01/app/rhpinfo/GI_12201_install.rsp is the response file location.

   Provide root or sudo credentials to connect to the nodes.

   Cluster Verification Utility checks for preinstallation configuration as per requirements. Rapid Home Provisioning configures Oracle Grid Infrastructure.

This procedure provisions Oracle Database 12c release 2 (12.2) software and creates Oracle Database instances.

1. From the Rapid Home Provisioning Server, provision the Oracle Database home software:

   rhpctl add workingcopy -image db12201 -path /u01/app/dbusr/product/12.2.0/db12201
     -client client_001 -oraclebase /u01/app/dbusr/ 
   -workingcopy db122 

   The command provisions the working copy db122 to the specified path on the cluster client_001, from the image db12201 .
2. Create the database instance:

   rhpctl add database -workingcopy db122 -dbname db -dbtype RAC

   The command creates an Oracle RAC database instance db . You can use the add database command repeatedly to create more instances on the working copy.

This procedure uses Rapid Home Provisioning to upgrade your Oracle Grid Infrastructure cluster from 11g release 2 (11.2.0.4) to 12c release 2 (12.2).

1. Provision a working copy of the Oracle Grid Infrastructure 12c release 2 (12.2.0.1) software:

   rhpctl add workingcopy -workingcopy GI122 -image GI_HOME_12201 -root root

   GI122 is the working copy based on the image GI_HOME_12201.

2. Upgrade your target cluster to the GI122 working copy:

   rhpctl upgrade gihome -sourcewc GI11204 -destwc GI122

   Rapid Home Provisioning identifies the cluster to upgrade based on the name of the source working copy, and upgrades to the working copyGI122.

This procedure explains how to patch Oracle Grid Infrastructure without changing the Grid home path.

1. To patch a Grid home and move it to Oracle Layered File System (OLFS), from the Rapid Home Provisioning Server, run one of the following commands:
   1. To patch a Grid home managed by Rapid Home Provisioning (the source working copy exists because the Oracle home is managed by Rapid Home Provisioning):

      [GRID:grid@testuser:/grid_home]> rhpctl move gihome -srcwc GI_HOME_12201
       -destwc GI_HOME_12201_PSU1 -aupath  /u01/app/orabase/product/12.2.0.1/aupath
      -agpath /u01/app/orabase/product/12.2.0.1/aupath -image -path /u01/app/orabase/product/12.2.0.1/grid

      GI_HOME_12201 is the source working copy of Grid home to be patched and GI_HOME_12201_PSU1 is the working copy of the Grid home software with the patches applied.

      /u01/app/orabase/product/12.2.0.1/agpath and /u01/app/orabase/product/12.2.0.1/aupath are the logical paths that resolve to the physical path /u01/app/orabase/product/12.2.0.1/grid when the Grid home is patched.

   2. To patch an unmanaged Grid home (the source working copy does not exist because the Oracle home is not managed by Rapid Home Provisioning):

      [GRID:grid@testuser:/grid_home]> rhpctl move gihome -sourcehome /u01/app/grid
       -destwc GI_HOME_12201_PSU1 -aupath /u01/app/orabase/product/12.2.0.1/aupath 
      -agpath /u01/app/orabase/product/12.2.0.1/agpath -image -path /u01/app/orabase/product/12.2.0.1/grid

      /u01/app/grid is the path of the Grid home to be patched and GI_HOME_12201_PSU1 is the working copy of the Grid home software with the patches applied.

      /u01/app/orabase/product/12.2.0.1/agpath and /u01/app/orabase/product/12.2.0.1/aupath are the logical paths that resolve to the physical path /u01/app/orabase/product/12.2.0.1/grid when the Grid home is patched.
2. To patch a Grid home that is compliant with Oracle Layered File System (OLFS), from the Rapid Home Provisioning Server, run the following:

   [GRID:grid@testuser:/grid_home]> rhpctl move gihome -sourcewc gihome12201_lpm
    -destwc gihome12201_psu1_lpm -aupath /u01/app/orabase/product/12.2.0.1/aupath 
   -image GIHOME_12201_LPM

   The Grid home running from the source working copy gihome12201_lpm is moved to the working copy gihome12201_psu1_lpm, based on the image GIHOME_12201_LPM and contains the patches.

This procedure patches Oracle Grid Infrastructure and Oracle Databases on the cluster to the latest patch level without cluster downtime.

1. Prepare target Oracle homes as follows:
   1. Provision software-only Grid home on the cluster to be patched:

      rhpctl add workingcopy -workingcopy GI_HOME_12201_PATCHED_WCPY 
      -image GI_HOME_12201_PSU1 –client CLUSTER_005 -softwareonly

   2. Provision each release Database home, without database instances, to be patched:

      rhpctl add workingcopy -workingcopy DB_HOME_12201_PATCHED_WCPY 
      -image DB_HOME_12201_PSU1
      rhpctl add workingcopy -workingcopy DB_HOME_12102_PATCHED_WCPY 
      -image DB_HOME_12102_PSU5

2. Patch Oracle Grid Infrastructure and all Oracle RAC Databases on node1 as follows:

   rhpctl move gihome -sourcewc GI_HOME_12201_WCPY -destwc GI_HOME_12201_PATCHED_WCPY -auto 
   -dbhomes DB_HOME_12102_WCPY=DB_HOME_12102_PATCHED_WCPY,DB_HOME_12201_WCPY=DB_HOME_12201_PATCHED_WCPY -targetnode node1 -root

   When you run the command, you move your active Oracle Grid Infrastructure from working copy GI_HOME_12201_WCPY to GI_HOME_12201_PATCHED_WCPY, Oracle RAC Database db1 from DB_HOME_12201_WCPY to DB_HOME_12201_PATCHED_WCPY, and Oracle RAC Database db2 from DB_HOME_12102_WCPY to DB_HOME_12102_PATCHED_WCPY.

This procedure explains how to patch Oracle Database 12c release 1 (12.1.0.2) with the latest patching without bringing down the database.

1. To patch an Oracle Database home managed by Rapid Home Provisioning, and there exist working copies of the source and destination databases, run:

   rhpctl move database -sourcewc db12102 -patchedwc db12102_psu

   db12102 is the source working copy of the database being patched

   db12102_psu is the working copy of the Oracle Database software with patches applied, based on the image DB12102_PSU.

2. To patch an unmanaged Oracle Database home (source working copy does not exist because the Oracle home is not managed by Rapid Home Provisioning), run:

   rhpctl move database -sourcehome /u01/app/orabase/product/12.1.0.2/dbhome_1
    -patchedwc db12102_psu -targetnode node1

   targetnode specifies the node on which the database to be upgraded is running, because the source Oracle Database is on a 12.1.0.2 cluster.

   /u01/app/orabase/product/12.1.0.2/dbhome_1 is the path of the database being patched

   db12102_psu is the working copy of the Oracle Database software with patches applied, based on the image DB12102_PSU.

   Use the saved gold image for standardized patching of all your databases of release 12c release 1 to the same patch level.
3. If for some reason, you want to rollback the patches applied to an unmanaged Oracle Database home, run:

   rhpctl move database -patchedwc db12102_psu 
   -sourcehome /u01/app/orabase/product/12.1.0.2/dbhome_1
    targetnode node1

This procedure describes how to upgrade an Oracle Database from 11.2 to 12c release 2 with a single command, using Rapid Home Provisioning, both for managed and unmanaged Oracle homes.

1. From the Rapid Home Provisioning Server, run one of the following commands as per your source and destination database:
   1. To upgrade an Oracle home managed by Rapid Home Provisioning, and there exist working copies of the source and destination databases, run:

      [GRID:grid@testuser:/grid_home]>  rhpctl upgrade database -dbname test_database 
      -sourcewc db112 -destwc db122 -root

      test_database is the name of the database being upgraded.

      db112 is the source working copy of the pre-upgrade database.

      db122 is the working copy of the upgraded Oracle Database software.

   2. To upgrade an unmanaged Oracle home (source working copy does not exist because the Oracle home is not managed by Rapid Home Provisioning), run:

      [GRID:grid@testuser:/grid_home]>  rhpctl move database -sourcehome 
      /u01/app/orabase/product/11.2.0/dbhome_1 -destwc db122 -targetnode node1 -root

      /u01/app/orabase/product/11.2.0/dbhome_1 is the path of the database being upgraded.

      db122 is the working copy of the upgraded Oracle Database software.

      targetnode specifies the node on which the database to be upgraded is running, because the source Oracle Database is on a 11.2.0.4 cluster.

To your two-node cluster, you can add a new node, and extend an Oracle RAC Database to the new node, using Rapid Home Provisioning.

1. From the Rapid Home Provisioning Server, run the following command to add a node to the existing Oracle Grid Infrastructure working copy:

   rhpctl addnode gihome -workingcopy GI_HOME_12202_WCPY -newnodes -root n3:n3-vip -root

   The command extends the cluster by adding node3.
2. Add instances to the administrator-managed Oracle RAC Database on the new node:

   rhpctl addnode database -workingcopy DB_HOME_12202_WCPY -dbname db321 -node n3 -root

   The command extends the database home on the node3 and creates database db321 on this node.

Create gold images of software home and store them on the Rapid Home Provisioning Server, to use later to provision Oracle homes.

1. Import an image from an installed Oracle home on the Rapid Home Provisioning Server:

   rhpctl import image -image db12201 -path /share/software/122/dbhome -imagetype ORACLEDBSOFTWARE 

   The gold image of imagetype Oracle Database 12c release 2 software is created and stored on the Rapid Home Provisioning Server.

   You can also create by gold images of Oracle Grid Infrastructure or any other software by specifying -imagetype as ORACLEGISOFTWARE or SOFTWARE respectively.

2. Import an image from an installed Oracle home on a Rapid Home Provisioning Client by running the following command from the Rapid Home Provisioning Client:

   rhpctl import image -image db12201 -path /u01/app/dbusr/product/12.2.0/

   The command creates and adds the image db12201 based on the local Oracle home installed in the specified path.

You can install and configure any type of software using Rapid Home Provisioning user actions. Review this procedure to automate deployment of Apache Web Server using Rapid Home Provisioning.

1. Create the script to install Apache Web server:
   1. On the Rapid Home Provisioning Server, download and extract the Apache Web server installation kit.
   2. Create the script to install, configure, and start the Apache Web server.
2. Register the script as a user action with Rapid Home Provisioning. Run the following command from the Rapid Home Provisioning Server:

   rhpctl useraction -useraction apachestart 
   -actionscript /user1/useractions/apacheinstall.sh 
   -post -optype ADD_WORKINGCOPY -onerror ABORT

   The command adds the apachestart user action for the action script stored in the specified directory. As per the specified properties, the user action runs after the ADD_WORKINGCOPY operation and aborts if there is any error.

3. Create an image type and associate the user action with the image type:

   rhpctl add imagetype -imagetype apachetype -basetype SOFTWARE 
   -useraction "apachestart"

   The command creates a new image type called apachetype, a derivative of the basic image type SOFTWARE with an associated user action apacherstart.

4. Create a gold image of the image type:

   rhpctl import image -image apacheinstall -path /user1/apache2219_kit/ 
   -imagetype apachetype

   The command creates a gold image apacheinstall with the script for Apache Web server installation, in the specified path based on the imagetype created earlier.

   To view the properties of this image, run the rhpctl query image -image apacheinstall command.
5. Deploy a working copy of the gold image on the target:

   rhpctl add workingcopy -workingcopy apachecopy -image apacheinstall 
   -path /user1/apacheinstallloc -sudouser user1 
   -sudopath /usr/local/bin/sudo -node node1 -user user1 
   -useractiondata "/user1/apachehome:1080:2.2.19

   Rapid Home Provisioning provisions the software to the target and runs the script apachestart specified in the user action. You provide the Apache Web server configuration details such as port number with the useractiondata option. If the target is a Rapid Home Provisioning Client, then you need not specify sudo credentials.