Managing the APPS password

This topic outlines how to manage the APPS password on a virtual EBS instance.

The Delphix Engine requires a virtual EBS instance's APPS password in order to manage its dbTechStack and appsTier. This password is encrypted when stored within the Delphix Engine and is exposed as an environment variable to RapidClone tools.

When a virtual EBS instance is being provisioned, the Delphix Engine's copy of the APPS password should match the source EBS instance's APPS password during its time of the snapshot. After provisioning, you can change the APPS password of the virtual instance in both EBS and the Delphix Engine.

Changing the APPS password

1. Provision a virtual EBS instance.

2. Change the APPS password in the virtual EBS instance. You can perform the password change using Oracle's FNDCPASS utility.

3. Stop the virtual appsTier manually using adstpall. You cannot stop the virtual appsTier through the Delphix Engine, because the APPS password being stored is now out of sync.

4. Disable the entire virtual EBS instance. For an outline of this process, see Enabling and Disabling a Virtual EBS Instance.

5. Change the APPS password on the dbTechStack.

   1. Select the dbTechStack vFiles hosting your virtual EBS database.

   2. On the back of the card, click the Custom tab.

   3. Edit the APPS Password field.

6. Change the APPS password in any hook operations defined on the EBS virtual database.

   1. Select the VDB utilized by your EBS instance.

   2. On the back of the card, click the Hooks tab.

   3. Edit the relevant hook operations. Typically, you will need to edit the Pre-Snapshot hook operation running adpreclone.

7. Change the APPS password on the appsTier.

   1. Select the appsTier vFiles hosting your virtual EBS database.

   2. On the back of the card, click the Custom tab.

   3. Edit the APPS Password field.

8. Enable the entire virtual EBS instance. For an outline of this process, see Enabling and Disabling a Virtual EBS Instance.

Refreshing or rewinding

The APPS password stored across individual snapshots of a virtual EBS instance will not be consistent after a password change. Old snapshots of EBS data will refer to a different APPS password than new snapshots of EBS data. To perform a refresh or rewind, you must explicitly manipulate the Delphix Engine's copy of the APPS password to ensure that the virtual EBS instance is being accessed with the correct APPS password at every step.

Recipe Not Needed If Password Not Changed

These steps are only necessary if the virtual EBS instance has a different APPS password than the snapshots being targeted by the refresh or rewind.

If the APPS password has not been changed, follow the instructions in Refreshing a Virtual EBS Instance or Rewinding a Virtual EBS Instance.

1. Before refreshing or rewinding the virtual EBS instance, disable the entire virtual EBS instance. For an outline of this process, see Enabling and Disabling a Virtual EBS Instance.

2. Identify the APPS password for the snapshots being targeted by the refresh or rewind. Modify the virtual EBS instance to refer to this password.

   1. Change the APPS password on the dbTechStack.

      1. Select the dbTechStack vFiles hosting your virtual EBS database.

      2. On the back of the card, click the Custom tab.

      3. Edit the APPS Password field.

   2. Change the APPS password in any hook operations defined on the EBS virtual database.

      1. Select the VDB utilized by your EBS instance.

      2. Select the Configuration tab, then select the Hooks tab.

      3. Edit the relevant hook operations. Typically, you will need to edit the Pre-Snapshot hook operation running adpreclone and the Configure Clone operation running adcfgclone.

   3. Change the APPS password on the appsTier.

      1. Select the appsTier vFiles hosting your virtual EBS database.

      2.  Click the Custom tab.

      3. Edit the APPS Password field.

3. Perform the refresh or rewind while the EBS instance is disabled. See Refreshing a Virtual EBS Instance or Rewinding a Virtual EBS Instance for an outline of these processes.