Cluster Server 7.3.1 Agent for Oracle Installation and Configuration Guide - Solaris

Last Published:
Product(s): InfoScale & Storage Foundation (7.3.1)
Platform: Solaris
  1. Introducing the Cluster Server agent for Oracle
    1. About the Cluster Server agent for Oracle
      1.  
        About the agent for Oracle ASM
    2.  
      Supported software for VCS agent for Oracle
    3.  
      Changes introduced in the 7.3.1 release
    4. How the agent makes Oracle highly available
      1.  
        How the Oracle and Netlsnr agents support intelligent resource monitoring
      2.  
        How the agent monitors Oracle instances running in Solaris zones
      3.  
        How the agent makes Oracle ASM instance highly available
      4.  
        How the agent supports container database (CDB) and pluggable database (PDB) in Oracle 12C
    5. About Cluster Server agent functions for Oracle
      1. Oracle agent functions
        1.  
          Startup and shutdown options for the Oracle agent
        2.  
          Startup and shutdown options for the pluggable database (PDB)
        3.  
          Recommended startup modes for pluggable database (PDB) based on container database (CDB) startup modes
        4.  
          Monitor options for the Oracle agent in traditional database and container database
        5.  
          Monitor for the pluggable database
        6.  
          How the agent handles Oracle error codes during detail monitoring
        7.  
          Info entry point for Cluster Server agent for Oracle
        8.  
          Action entry point for Cluster Server agent for Oracle
        9. How the Oracle agent supports health check monitoring
          1.  
            Generating the executable required for Oracle health check monitoring
          2.  
            Considerations to run the build_oraapi.sh script
          3.  
            Building the Oracle agent executable using the build_oraapi.sh script
      2.  
        Netlsnr agent functions
      3. ASMInst agent functions
        1.  
          ASMInst agent Startup options
        2.  
          ASMInst agent Shutdown options
        3.  
          Monitor options for the ASMInst agent
      4.  
        ASMDG agent functions
    6.  
      Typical Oracle configuration in a VCS cluster
    7.  
      About setting up Oracle in a VCS cluster
  2. Installing and configuring Oracle
    1.  
      About installing Oracle in a VCS environment
    2.  
      Before you install Oracle in a VCS environment
    3. About VCS requirements for installing Oracle
      1.  
        Location of the $ORACLE_HOME
      2.  
        Replacing the long pathnames for $ORACLE_HOME in the agent attributes
      3.  
        Failing over Oracle after a VCS node failure during hot backup
    4. About Oracle installation tasks for VCS
      1.  
        Installation tasks for $ORACLE_HOME on shared disks
      2.  
        Installation tasks for $ORACLE_HOME on local disks
      3.  
        Installation tasks for Oracle using ASM
    5. Installing ASM binaries for Oracle 11gR2 or 12c in a VCS environment
      1.  
        Configuring VCS to support Oracle Restart function
    6. Configuring Oracle ASM on the first node of the cluster
      1.  
        Enabling the clustering daemon for ASM-managed database
      2.  
        Enabling Oracle Cluster Synchronization Service daemon to start automatically
    7.  
      Configuring and starting up ASM on remaining nodes for 11gR2 or 12c
    8. Installing Oracle binaries on the first node of the cluster
      1.  
        Disabling the clustering daemon for Oracle 10g or later
    9.  
      Configuring the Oracle database
    10.  
      Copying the $ORACLE_BASE/admin/SID directory
    11.  
      Copying the Oracle ASM initialization parameter file
    12.  
      Verifying access to the Oracle database
  3. Installing and removing the agent for Oracle
    1.  
      Before you install or upgrade the agent for Oracle
    2.  
      Installing the VCS agent for Oracle software
    3. Upgrading the VCS agent for Oracle
      1.  
        Upgrading VCS agent for Oracle to use with VCS 7.3.1
    4.  
      Disabling the Cluster Server agent for Oracle
    5.  
      Removing the Cluster Server agent for Oracle
  4. Configuring VCS service groups for Oracle
    1.  
      About configuring a service group for Oracle
    2. Configuring Oracle instances in VCS
      1.  
        Configuring a single Oracle instance in VCS
      2.  
        Configuring multiple Oracle instances (single listener) in VCS
      3.  
        Configuring multiple Oracle instances (multiple listeners) in VCS
      4.  
        Configuring an Oracle instance with shared server support in VCS
    3. Before you configure the VCS service group for Oracle
      1.  
        Importing the type definition files for Cluster Server agent for Oracle
    4. Configuring the VCS service group for Oracle
      1.  
        Configuring the VCS service group for Oracle using Cluster Manager (Java console)
      2. Configuring the VCS service group for Oracle using the command-line
        1.  
          Encrypting Oracle database user and listener passwords
    5. Setting up detail monitoring for VCS agents for Oracle
      1. Setting up detail monitoring for Oracle
        1.  
          Enabling and disabling detail monitoring for Oracle resource
      2.  
        Setting up detail monitoring for Netlsnr
    6. Enabling and disabling intelligent resource monitoring for agents manually
      1.  
        Administering the AMF kernel driver
  5. Administering VCS service groups for Oracle
    1.  
      About administering VCS service groups
    2.  
      Bringing the service group online
    3.  
      Taking the service group offline
    4.  
      Switching the service group
    5.  
      Modifying the service group configuration
  6. Pluggable database (PDB) migration
    1.  
      Migrating Pluggable Databases (PDB) between Container Databases (CDB)
  7. Troubleshooting Cluster Server agent for Oracle
    1.  
      About troubleshooting Cluster Server agent for Oracle
    2.  
      Error messages common to the Oracle and Netlsnr agents
    3.  
      Error messages specific to the Oracle agent
    4.  
      Error messages specific to the Netlsnr agent
    5.  
      Error messages specific to the ASMInst agent
    6.  
      Error messages specific to the ASMDG agent
    7.  
      Troubleshooting issues specific to Oracle in a VCS environment
    8. Verifying the Oracle health check binaries and intentional offline for an instance of Oracle
      1.  
        Verifying the intentional offline behavior of the VCS Oracle agent
    9.  
      Disabling IMF for a PDB resource
  8. Appendix A. Resource type definitions
    1.  
      About the resource type and attribute definitions
    2. Resource type definition for the Oracle agent
      1.  
        Attribute definition for the Oracle agent
      2.  
        About the Sid attribute in a policy managed database
    3. Resource type definition for the Netlsnr agent
      1.  
        Attribute definition for the Netlsnr agent
    4. Resource type definition for the ASMInst agent
      1.  
        Attribute definition for the ASMInst agent
    5. Resource type definition for the ASMDG agent
      1.  
        Attribute definition for the ASMDG agent
  9. Appendix B. Sample configurations
    1.  
      About the sample configurations for Oracle enterprise agent
    2. Sample single Oracle instance configuration
      1.  
        Sample VCS configuration file for single Oracle instance
    3. Sample multiple Oracle instances (single listener) configuration
      1.  
        Sample VCS configuration file for multiple Oracle instances (single listener)
    4. Sample multiple instance (multiple listeners) configuration
      1.  
        Sample VCS configuration file for multiple Oracle instances (multiple listeners)
    5. Sample Oracle configuration with shared server support
      1.  
        Sample VCS configuration file for Oracle instance configured with shared server support
    6. Sample configuration for Oracle instances in Solaris zones
      1.  
        Zone root on local disk for single Oracle instance
      2.  
        Zone root on shared disk for single Oracle instance
      3.  
        Zone root on local disk for multiple Oracle instances
      4.  
        Zone root on shared disk for multiple Oracle instances
      5.  
        Zone root on local disk for Oracle instance with shared server support
      6.  
        Zone root on shared disk for Oracle instance with shared server support
      7.  
        Oracle instance in the context of project
      8.  
        Sample VCS configuration file for zone root on local disk or on shared disk
    7. Sample Oracle ASM configurations
      1. Sample configuration for ASM disks as raw disks
        1.  
          Sample VCS configuration file for ASM-managed Oracle instance
      2. Sample configuration for ASM disks as VxVM volumes
        1.  
          Sample VCS configuration file for ASM disks as VxVM disks
      3. Sample configuration for ASM disks as CVM volumes
        1.  
          Sample VCS configuration file for ASM that uses CVM volumes
    8.  
      Sample configuration of Oracle pluggable database (PDB) resource in main.cf
    9.  
      Sample configuration of migratable Oracle pluggable database (PDB) resource in main.cf
    10.  
      Sample Configuration of Oracle supported by systemD
    11.  
      Sample configuration of ASMInst supported by systemD
  10. Appendix C. Best practices
    1.  
      Best practices for multiple Oracle instance configurations in a VCS environment
  11. Appendix D. Using the SPFILE in a VCS cluster for Oracle
    1.  
      About the Oracle initialization parameter files
    2.  
      Starting an Oracle instance
    3.  
      Using the SPFILE in a VCS cluster
  12. Appendix E. OHASD in a single instance database environment
    1.  
      About OHASD in a single instance database environment
    2.  
      Configuring the Application agent to make OHASD highly available

Sample configuration of migratable Oracle pluggable database (PDB) resource in main.cf

Figure: Sample migratable Oracle CDB-PDB configuration

Sample migratable Oracle CDB-PDB configuration
include "types.cf"
include "OracleTypes.cf"

cluster vcs (
)

system SysA (
)

system SysB(
)

group ORA_CDB1_PROD_Group(
	SystemList = { SysA = 0, SysB = 1 }
	)

        DiskGroup cdb1_dg (
                DiskGroup = cdb_dg1
                )

	Volume cdb1_vol (
		Volume = cdbvol1
		DiskGroup = cdb_dg1
		)

	Mount cdb1_mnt (
		MountPoint = "/cdb1"
		BlockDevice = "/dev/vx/dsk/cdb_dg1/cdbvol1"
		FSType = vxfs
		FsckOpt = "-y"
			)

	DiskGroup pdb1_dg (
                DiskGroup = pdb_dg1
                )

        Volume pdb1_vol (
                Volume = pdbvol1
                DiskGroup = pdb_dg1
                )

        Mount pdb1_mnt (
                MountPoint = "/pdb1"
                BlockDevice = "/dev/vx/dsk/pdb_dg1/pdbvol1"
                FSType = vxfs
                FsckOpt = "-y"
                )
	
	DiskGroup pdb2_dg (
                DiskGroup = pdb_dg2
                )

        Volume pdb2_vol (
                Volume = pdbvol2
                DiskGroup = pdb_dg2
                )

        Mount pdb2_mnt (
                MountPoint = "/pdb2"
                BlockDevice = "/dev/vx/dsk/pdb_dg2/pdbvol2"
                FSType = vxfs
                FsckOpt = "-y"
                )
 
	IP IP_cdb1 (
                Device = hme0
                Address = "10.212.102.13"
                NetMask = "255.255.252.0"
                )
        
	NIC NIC_cdb1 (
                Device = hme0
                NetworkHosts = { "10.212.102.1" }
                )

	Netlsnr LSNR_cdb1 (
                Owner = oracle
                Home = "/u01/oraHome1"
                )
	
	Oracle ora_cdb1 (
		Sid = cdb1
		Owner = oracle
		Home = "/u01/oraHome1"
		StartUpOpt = STARTUP
		DBName = cdb1
		)

	Oracle ora_pdb1 (
		Sid = cdb1
		Owner = oracle
		Home = "/u01/oraHome1"
		PDBName = PDB1
		)

	Oracle ora_pdb2 (
		Critical = 0
		Sid = cdb1
		Owner = oracle
		Home = "/u01/oraHome1"
		PDBName = PDB2
		)

	IP_cdb1 requires NIC_cdb1
	LSNR_cdb1 requires IP_cdb1
	LSNR_cdb1 requires ora_cdb1
	cdb1_mnt requires cdb1_vol 
	cdb1_vol requires cdb1_dg 
	pdb1_mnt requires pdb1_vol
	pdb1_vol requires pdb1_dg
	pdb2_mnt requires pdb2_vol
	pdb2_vol requires pdb2_dg
	ora_cdb1 requires cdb1_mnt 
	ora_pdb1 requires ora_cdb1
	ora_pdb1 requires pdb1_mnt
	ora_pdb2 requires ora_cdb1
	ora_pdb2 requires pdb2_mnt

group ORA_CDB2_PROD_Group(
	SystemList = { SysA = 0, SysB = 1 }
	)

        DiskGroup cdb2_dg (
                DiskGroup = cdb_dg2
                )

	Volume cdb2_vol (
		Volume = cdbvol2
		DiskGroup = cdb_dg2
		)

	Mount cdb2_mnt (
		MountPoint = "/cdb2"
		BlockDevice = "/dev/vx/dsk/cdb_dg2/cdbvol2"
		FSType = vxfs
		FsckOpt = "-y"
		)

	DiskGroup pdb3_dg (
                DiskGroup = pdb_dg3
                )

        Volume pdb3_vol (
                Volume = pdbvol3
                DiskGroup = pdb_dg3
                )

        Mount pdb3_mnt (
                MountPoint = "/pdb3"
                BlockDevice = "/dev/vx/dsk/pdb_dg3/pdbvol3"
                FSType = vxfs
                FsckOpt = "-y"
                )
	
	DiskGroup pdb4_dg (
                DiskGroup = pdb_dg4
                )

        Volume pdb4_vol (
                Volume = pdbvol4
                DiskGroup = pdb_dg4
                )

        Mount pdb4_mnt (
                MountPoint = "/pdb4"
                BlockDevice = "/dev/vx/dsk/pdb_dg4/pdbvol4"
                FSType = vxfs
                FsckOpt = "-y"
                )
 
	IP IP_cdb2 (
                Device = hme0
                Address = "10.212.102.14"
                NetMask = "255.255.252.0"
                )
        
	NIC NIC_cdb2 (
                Device = hme0
                NetworkHosts = { "10.212.102.1" }
                )

	Netlsnr LSNR_cdb2 (
                Owner = oracle
                Home = "/u01/oraHome2"
                )
	
	Oracle ora_cdb2 (
		Sid = cdb2
		Owner = oracle
		Home = "/u01/oraHome2"
		StartUpOpt = STARTUP
		DBName = cdb2
		)

	Oracle ora_pdb3 (
		Sid = cdb2
		Owner = oracle
		Home = "/u01/oraHome2"
		PDBName = PDB3
		)

	Oracle ora_pdb4 (
		Sid = cdb2
		Owner = oracle
		Home = "/u01/oraHome2"
		PDBName = PDB4
		)

	IP_cdb2 requires NIC_cdb2
	LSNR_cdb2 requires IP_cdb2
	LSNR_cdb2 requires ora_cdb2
	cdb2_mnt requires cdb2_vol 
	cdb2_vol requires cdb2_dg 
	pdb3_mnt requires pdb3_vol
	pdb3_vol requires pdb3_dg
	pdb4_mnt requires pdb4_vol
	pdb4_vol requires pdb4_dg
	ora_cdb2 requires cdb2_mnt 
	ora_pdb3 requires ora_cdb2
	ora_pdb3 requires pdb3_mnt
	ora_pdb4 requires ora_cdb2
	ora_pdb4 requires pdb4_mnt