Configure an Oracle Fleet Patching and Provisioning server
Introduction
This tutorial provides step-by-step procedures to configure a new Oracle Fleet Patching and Provisioning (Oracle FPP) server by creating an Oracle FPP server and adding an Oracle FPP client to the server.
Objectives
In this tutorial, you will learn about the following procedures:
- Create and configure an Oracle FPP server
- Add a new Oracle FPP client to the server
- Configure audit recovery
Prerequisites
Before you start this tutorial, ensure that you have the following:
- Oracle Grid Infrastructure cluster
- Oracle Automatic Storage Management (Oracle ASM) disk group with 200 GB free disk space
- IP address is available for use on the same subnet as the
net1
public network - Grid Infrastructure Management Repository (GIMR) or Management Database (MGMTDB)
- Root access to the
srvctl remove rhpserver
,srvctl add gns
, andsrvctl add rhpserver
commands
Create an Oracle FPP Server
An Oracle FPP server is an Oracle Grid Infrastructure service that manages Oracle Grid Infrastructure and Oracle Database servers.
- As the
root
user, remove any existing local automaton from your cluster.[grid@fppserver ~]# srvctl stop rhpserver [grid@fppserver ~]# srvctl remove rhpserver -f
Note: Ignore any message similar to
Fleet Patching and Provisioning server is not running
. - Remove all local Oracle FPP directories from each cluster node.
[grid@fppserver ~]# rm -rf $ORACLE_BASE/rhp_images
- As the
grid
user, list the Oracle ASM disk groups and identify a disk group to store the Oracle FPP images.[grid@fppserver ~]$ asmcmd ASMCMD> lsdg
- As the
root
user, add the Grid Naming Service Virtual IP Address (GNS VIP) without zone delegation.[grid@fppserver ~]# srvctl add gns -vip myhost-gnsvip3 [grid@fppserver ~]# srvctl start gns [grid@fppserver ~]# srvctl status gns GNS is running on node fpp-server-n04. GNS is enabled on node fpp-server-n04.
- Create a central Oracle FPP server.
[grid@fppserver ~]# Grid_home/bin/srvctl add rhpserver -storage /rhp -diskgroup DATA
- As the
grid
user, start the Oracle FPP server.[grid@fppserver ~]$ Grid_home/bin/srvctl start rhpserver
- Check the status of the Oracle FPP server.
[grid@fppserver ~]$ srvctl status rhpserver Rapid Home Provisioning Server is enabled Rapid Home Provisioning Server is running on node fpp-server-n04
Add an Oracle FPP Client
Oracle FPP clients are the Oracle Grid Infrastructure and Oracle Database servers that you manage using an Oracle FPP server.
- As the
grid
user, check the name of the Oracle FPP client cluster.[grid@fpp-client3-n04 ~]$ olsnodes -c fpp-client3-cluster
- Create an Oracle FPP client data file on the Oracle FPP server using the client name from the output of the previous command.
[grid@fppserver ~]$ rhpctl add client -client fpp-client3-cluster -toclientdata /tmp fpp-server-n04: Audit ID: 833 fpp-server-n04: Creating client data ... fpp-server-n04: Client data created for client "fpp-client3-cluster".
- As the
root
user, create an Oracle FPP client using the client data file.# srvctl add rhpclient -clientdata /tmp/fpp-client3-cluster.xml
- Start the Oracle FPP client.
# srvctl start rhpclient
- Check the status of the newly created Oracle FPP client.
[root@fpp-client3-n04 ~]# srvctl status rhpclient Rapid Home Provisioning Client is enabled Rapid Home Provisioning Client is running on node fpp-client3-n04
- As the
grid
user, check the configuration of the Oracle FPP client.[grid@fppserver ~]$ rhpctl query client -client fpp-client3-cluster fpp-server-n04: Audit ID: 834 Site: fpp-client3-cluster Rapid Home Provisioning Client Version: 21.0.0.0.0 Enabled: true Host from which RHPC last registered: fpp-client3-n04.yourcorp.com Port number last registered by RHPC: 23795 RHP Enabled: true Standalone: false Managed: true OSConfig Enabled: false
Perform a Simple Audit Review
Oracle FPP maintains an audit log of all the server activities. You can review these activities by time, operation, and operation against an entity.
- Review the last two activities on your Oracle FPP server.
[grid@fppserver ~]$ rhpctl query audit -last 2 fpp-server-n04: Audit ID: 99 Audit ID: 99 Start time: 2021-05-04T01:48:36.965 Command executed: rhpctl query audit -last 2 End time: Command result: RUNNING User name: exagrid Node name: fpp-server-n04@fpp-server-cluster Target cluster: fpp-server-cluster Audit ID: 98 Start time: 2021-05-04T01:37:46.107 Command executed: rhpctl query client -client fpp-client3-cluster End time: Command result: RUNNING User name: exagrid Node name: fpp-server-n04@fpp-server-cluster Target cluster: fpp-server-cluster
- Review the last two delete operations on your Oracle FPP server.
[grid@fppserver ~]$ rhpctl query audit -operation delete fpp-server-n04: Audit ID: 100 Audit ID: 25 Start time: 2021-04-24T23:13:53.663 Command executed: rhpctl delete image -image GI186_190416 End time: 2021-04-24T23:14:00.000 Command result: SUCCESS User name: exagrid Node name: fpp-server-n04 Target cluster: fpp-server-cluster Audit ID: 47 Start time: 2021-04-30T11:51:16.221 Command executed: rhpctl delete workingcopy -workingcopy GI195_191015_WC_fpps End time: 2021-04-30T11:52:03.000 Command result: SUCCESS User name: exagrid Node name: fpp-server-n04 Target cluster: fpp-server-cluster
- Review the image entity delete operations on your Oracle FPP server.
[grid@fppserver ~]$ rhpctl query audit -operation delete -entity image fpp-server-n04: Audit ID: 101 Audit ID: 25 Start time: 2020-04-24T23:13:53.663 Command executed: rhpctl delete image -image GI186_190416 End time: 2020-04-24T23:14:00.000 Command result: SUCCESS User name: exagrid Node name: fpp-server-n04 Target cluster: fpp-server-cluster
Increase Oracle FPP Audit Record History
By default, Oracle FPP stores 2000 audit trail records. If you exceed that threshold, then Oracle FPP deletes the oldest records.
- Update Oracle FPP audit record history to maintain 20000 audit trail records.
[grid@fppserver ~]$ rhpctl modify audit -maxrecord 20000 fpp-server-n04: Audit ID: 7
- Confirm the new audit record history settings.
[grid@fppserver ~]$ rhpctl query audit -config fpp-server-n04: Audit ID: 8 Maximum number of records to store: 20000
Understand the RHPCTL Online Help
Check RHPCTL online help for a list of the RHPCTL commands, command options, and their usage.
- List all the RHPCTL command options.
$ rhpctl -h Performs Rapid Home Provisioning operations and manages Rapid Home Provisioning servers and clients. Usage: rhpctl add Adds a resource, type or other entity. rhpctl addnode Adds nodes or instances of specific resources. ... ... rhpctl zdtupgrade Performs zero downtime upgrade of a database. For detailed help on each command use: rhpctl <command> -help
Note: Use the RHPCTL commands in the format
rhpctl command object [parameters]
. Use the-h
option with any segment of the command for more details. - List all the command options and parameters for the
rhpctl add image
command.$ rhpctl add image -h Creates a new image from an existing working copy. Usage: rhpctl add image -image <image_name> -workingcopy <workingcopy_name> [-imagetype <image_type>] [-series <series_name>] [-state {TESTABLE| RESTRICTED| PUBLISHED}] -image <image_name> Name of the image -workingcopy <workingcopy_name> Name of the working copy -imagetype <image_type> The software type. ('ORACLEDBSOFTWARE' (default) for Oracle database software, 'ORACLEGISOFTWARE' for Oracle Grid Infrastructure software, ORACLEGGSOFTWARE for Oracle GoldenGate software, 'LINUXOS' for linux Opearting System ISO, and 'SOFTWARE' for all other software. For a custom image type, use the image type name.) -series <series_name> Name of the series -state {TESTABLE|RESTRICTED|PUBLISHED} State name
Related Links
- Oracle Fleet Patching and Provisioning
- Oracle Fleet Patching and Provisioning Technical Brief
- Oracle Fleet Patching and Provisioning Administrator’s Guide
Acknowledgements
- Authors - Subhash Chandra (Principal User Assistance Developer), Dave LaPoint (Consulting Member of Technical Staff)
- Contributors - Ludovico Caldara (Product Manager, Oracle MAA), Prakash Jashnani (User Assistance Development Manager)
More Learning Resources
Explore other labs on docs.oracle.com/learn or access more free learning content on the Oracle Learning YouTube channel. Additionally, visit education.oracle.com/learning-explorer to become an Oracle Learning Explorer.
For product documentation, visit Oracle Help Center.
Configure an Oracle Fleet Patching and Provisioning server
F43508-01
June 2021
Copyright © 2021, Oracle and/or its affiliates.
This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, then the following notice is applicable:
U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group.
This software or hardware and documentation may provide access to or information about content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services, except as set forth in an applicable agreement between you and Oracle.