C.7 Installation and Upgrade Issues
Review these troubleshooting tips for common installation and upgrade issues when working with Oracle Key Vault.
- Oracle Key Vault Installation Failure
Oracle Key Vault installation is failing. - Oracle Key Vault Upgrade Failure
Oracle Key Vault upgrade fails with file descriptor (FD) open error. - Oracle Key Vault Management Console is Not Accessible After Installation
The Oracle Key Vault management console is not accessible after rebooting the Oracle Key Vault server as part of the installation on VMWare virtual machine. - Oracle Key Vault Upgrade Failure
Oracle Key Vault upgrade fails with an error. - Unable to boot after installation of Oracle Key Vault on VMWare VM
Unable to boot the Virtual Machine (VM) after Oracle Key Vault installation. - Operation Failed on Network Information Screen After Upgrade from 21.x to 21.5 and Later.
Network information screen is displaying Operation failed error. - Upgrade to Oracle Key Vault Failed During the upgrade_apex Step
When upgrading to Oracle Key Vault, theupgrade_apex
step results inODF-10001: Internal error: FAILED migration: upgrade_apex (as oracle)
error. - Upgrading Oracle Key Vault Fails When Rebuilding the Index with UTLRP.SQL
When attempting to upgrade to Oracle Key Vault, it fails while rebuilding the index by executingUTLRP.SQL
after settingmax_string_size
to extended.
Parent topic: Troubleshooting Oracle Key Vault
C.7.1 Oracle Key Vault Installation Failure
Oracle Key Vault installation is failing.
Probable Cause
Oracle Key Vault Installation may fail due to various reasons listed with solutions in the Solutions section.
Solution
- Check if the physical server has RAID enabled software.
Note:
Oracle Key Vault does not support the use of Software RAID. Ensure that RAID is configured only at the hardware level. - On the Oracle Key Vault server, check the network settings. Also check if there is a delay in copying the
iso
files from the NFS location to the disk. - Check system configuration including disk size, number of disks, disk configuration, RAM size, and number of CPU cores. Ensure that the server meets the minimum system configuration requirements of Oracle Key Vault.
- Verify if the checksum matches with the local
iso
file.- Copy the checksum of the
iso
from the specific location where you downloaded theiso
file. - Generate the checksum for the downloaded
iso
file. - Both the checksum values should be the same. If not,
download the correct
iso
file.sha256sum isoname.iso
- Check if the issue is resolved.
- Copy the checksum of the
Parent topic: Installation and Upgrade Issues
C.7.2 Oracle Key Vault Upgrade Failure
Oracle Key Vault upgrade fails with file descriptor (FD) open error.
Probable Cause 1
Oracle Key Vault upgrade version is not supported.
Solution
Verify that the Oracle Key Vault upgrade from the current release to the version you want to upgrade is supported. See, Release Notes
of specific Oracle Key Vault release for supported upgrade paths.
Probable Cause 2
Oracle Key Vault certificates have expired.
Solution
- Check if the Oracle Key Vault server or node certificates have expired.
- Log in to the Oracle Key Vault management console as a user who has the system administrator role.
- To check the server or node certificate expiration status, go to System, Status and check the Server or Node Certificate Expiration Date.
- Regenerate the server certificate if it has expired. Go to System, Status.
- Click Service Certificates and select Manage Server or Node Certificate to regenerate the new server certificate.
- Check if the Oracle Key Vault CA certificate has expired.
- Log in to the Oracle Key Vault management console as a system administrator.
- To check the CA certificate expiration status, navigate to System, Status and check the CA Certificate Expiration Date.
- If the CA certificate has expired, contact Oracle support.
- Verify if all the pre-upgrade steps are performed as described in the
Oracle Key Vault Installation and Upgrade guide
.Note:
For Oracle Key Vault 21.5 or higher, see the steps listed inManaging CA Certificate Rotation after it has expired, to rotate the expired CA certificate.
Considerations for Multi-Master Cluster Deployment
- Log in to each node's management console, and check if the replication lag or heartbeat lag is high in other nodes. If yes, then resolve this issue first. See,Heartbeat Lag or High Replication Lag in Multi-Master Cluster Environment.
- Based on the upgrade scenario, certain restrictions may apply when
upgrading nodes of a read/write pair. This includes the order in which the nodes are
disabled, upgraded, and then re-enabled after the upgrade. See,
Oracle Key Vault Installation and Upgrade guide
of the target version for specific instructions. - Verify if the node is not disabled beyond the maximum node disabled duration limit.
Considerations for Primary-Standby Environment
- Verify if the upgrade is performed first on standby and then on the primary. See,Upgrading a Pair of Primary-Standby Oracle Key Vault Servers .
- Retry the upgrade. If the issue persists, contact Oracle Support.
Parent topic: Installation and Upgrade Issues
C.7.3 Oracle Key Vault Management Console is Not Accessible After Installation
The Oracle Key Vault management console is not accessible after rebooting the Oracle Key Vault server as part of the installation on VMWare virtual machine.
Example
On the Oracle Key Vault server, the /var/log/messages
shows the
error,
OAV-46501: invalid IP Address.
java.sql.SQLException: OAV-46501: invalid IP Address.
Probable Cause
The HTTPd server daemon on the Oracle Key Vault server is not started. Oracle Key Vault faced issues in identifying the network adapter on VMware.
- Change the network adapter settings in VMware. Change the Virtual Machine from
VMXNET3
toe1000
. - Reboot the Oracle Key Vault server.
Parent topic: Installation and Upgrade Issues
C.7.4 Oracle Key Vault Upgrade Failure
Oracle Key Vault upgrade fails with an error.
Example
Oracle Key Vault upgrade fails with,
Open FDs on: Volume: lv_tmp, Process: sshd
[root@server ]# /usr/bin/ruby /images/upgrade.rb --confirm
Power loss during upgrade may cause data loss. Do not power
off during upgrade.
Verifying boot partition before upgrade
Verifying upgrade preconditions
The Oracle base has been set to /var/lib/oracle
The Oracle base has been set to /var/lib/oracle
The Oracle base has been set to /var/lib/oracle
The Oracle base has been set to /var/lib/oracle
The Oracle base has been set to /var/lib/oracle
The Oracle base has been set to /var/lib/oracle
The Oracle base has been set to /var/lib/oracle
The Oracle base has been set to /var/lib/oracle
The Oracle base has been set to /var/lib/oracle
The Oracle base has been set to /var/lib/oracle
The Oracle base has been set to /var/lib/oracle
AVDF::Installer::Upgrade::LVOpenFD
Open FDs on: Volume: lv_tmp, Process: sshd, File(s): /tmp/ssh-<xxxxxx>/agent.1662
Failed to apply update: Verifying pre-upgrade conditions failed.
Failed to apply update: /images/upgrade/lib/preconditions.rb:2189:in 'verify_all'
/images/upgrade.rb:203:in 'upgrade'
/images/upgrade.rb:282:in '<main>
Probable Cause
This error is due to a running SSH process.
Solution
- Verify if any SSH process is running on the Oracle Key Vault server:
$ ps -eaf | grep -i "ssh"
- Stop the running SSH process and retry the upgrade.
Parent topic: Installation and Upgrade Issues
C.7.5 Unable to boot after installation of Oracle Key Vault on VMWare VM
Unable to boot the Virtual Machine (VM) after Oracle Key Vault installation.
Example
After reboot, the following error message appears on VM console.
PXE-M0F: Exiting Intel PXE ROM
Operating system not Found
Probable Cause
The virtual disk is set to 2 TB and is not allowing the server to boot.
Solution
- Set the virtual disc size to 1.9 TB.
- In vSphere 5.5.x and 6.0.x, large capacity virtual disks have these
conditions and limitations:
- The maximum supported VMDK size on an VMFS-5 data store is increased to 62 TB. However, the maximum supported VMDK size on VMFS-3 is still 2 TB.
- The maximum supported size of a VMDK on NFS is the lesser of 62 TB and 1% less than the maximum file size supported by the NFS filesystem.
Parent topic: Installation and Upgrade Issues
C.7.6 Operation Failed on Network Information Screen After Upgrade from 21.x to 21.5 and Later.
Network information screen is displaying Operation failed error.
Example
The network information screen is displaying Operation failed error while fetching the network interfaces details.
Probable Cause
The network configuration file name is not changed to the supported naming convention on 21.5 or later.
Solution
- Go to
/etc/sysconfig/network-scripts/
. - List all the files and find if the
ifcfg*
files haved1
appended at the end. For example,/etc/sysconfig/network-scripts/ifcfg-bond0-eno3d1
. - Rename the files to the correct name,
mv ifcfg-bond0-eno3d1 ifcfg-bond0-eno3
. - Reboot the server.
Parent topic: Installation and Upgrade Issues
C.7.7 Upgrade to Oracle Key Vault Failed During the upgrade_apex
Step
When upgrading to Oracle Key Vault, the upgrade_apex
step results in ODF-10001: Internal error: FAILED migration: upgrade_apex (as oracle)
error.
Problem
/var/log/messages
contains ERROR - ODF-10001: Internal error: FAILED migration: upgrade_apex (as oracle) (applied change)
and /var/log/debug
contains upgrade_apex: error: cannot create /var/lib/oracle/dbfw/apex/images/computer.gif
upgrade_apex: Permission denied
upgrade_apex: error: cannot create /var/lib/oracle/dbfw/apex/images/phone_support.gif
upgrade_apex: Permission denied
root
user: /opt/avdf/bin/privmigutl –status
results in System state - recovery
Migration set 'AVS' - failed
Last migration 'Upgrading apex20' - failed
Solution
- Log in to the Oracle Key Vault Server through SSH and switch to the
root
user. - Run the following command:
chown -R oracle:oinstall /var/lib/oracle/dbfw/apex/images
- Switch to the
oracle
user.su - oracle
- Run the following script:
/opt/avdf/install/privileged_migration/upgrade_apex
- Run
echo $?
.If the result is 2, then the script has completed successfully.
- Log in to the Oracle Key Vault Server through SSH and switch to the
root
user. - Resume the upgrade process by running the following command:
/opt/avdf/bin/privmigutl --resume --confirm
Make sure the ssh connection to the Oracle Key Vault server is reliable and does not terminate while running this command.
- Check if the
$ORACLE_HOME/apex/images
folder and its contents haveoracle:oinstall
permission. If not, grant the permission.
Parent topic: Installation and Upgrade Issues
C.7.8 Upgrading Oracle Key Vault Fails When Rebuilding the Index with UTLRP.SQL
When attempting to upgrade to Oracle Key Vault, it fails while rebuilding the index by executing UTLRP.SQL
after setting max_string_size
to extended.
Problem
UTLRP.SQL
. You may receive the following error logged in /var/log/messages
:HOSTNAME su: (to oracle) root on none
HOSTNAME com.oracle.privilegedMigration.max_string_size_extended: Failed utlrp.sql to setup MAX_STRING_SIZE to extended.
HOSTNAME run-application-migrations[28910]: com.oracle.dbfw.privilegedMigration ERROR - ODF-10001: Internal error: FAILEDmigration: max_string_size_extended (as root) (applied change)
Cause
The upgrade fails while rebuilding the index by executing UTLRP.SQL
after setting max_string_size
to extended.
Solution
- Connect to Oracle Key Vault database as
sys -
sqlplus / as sysdba @/var/lib/oracle/dbfw/rdbms/admin/utlrp.sql DECLARE
The query fails with the following error:
ERROR at line 1: ORA-01502: index 'SYS.I_WRI$_OPTSTAT_HH_OBJ_ICOL_ST' or partition of such index is in unusable state Function created. PL/SQL procedure successfully completed. Function dropped. Warning: XDB now invalid PL/SQL procedure successfully completed.
- Rebuild the package to fix the issue by executing the following query:
alter index SYS.I_WRI$_OPTSTAT_HH_OBJ_ICOL_ST rebuild;
- Execute the script again:
@/var/lib/oracle/dbfw/rdbms/admin/utlrp.sql
- Run the following commands:
alter package objowner.object compile body; grant execute on DBMS_SQL to public;
- Check if any other invalid objects are present:
SELECT owner, object_type, object_name FROM dba_objects WHERE status !='VALID';
- Drop the trigger which failed:
drop trigger avsys.start_el_migration;
- Resume the upgrade:
/opt/avdf/bin/privmigutl --resume --confirm
Parent topic: Installation and Upgrade Issues