This section discusses upgrade failure cases.
Case I:
If the upgrade has failed:
Check the Upgrade.log
file in the temporary directory where the upgrade installer is triggered, and the %AGILIANCE_HOME%\toolbox\bin\upgradedb.log
file for more details about the causes for error(s).
If the upgrade cannot be completed:
A command prompt window will open to run the rollback process. To rollback to your pre-upgrade state, use your backup files.
- Click 'y,' when prompted.
- MySQL – The rollback will be performed seamlessly without any manual intervention.
- Oracle – Once the rollback is complete, the database administrator must manually restore the database to the previous state.
Case II:
If the RiskVision Server upgrade has failed on an Oracle database due to the omission of the System User connection, and the upgradedb.log
file does not show any errors, the database has stopped abruptly. To resolve this error, you must run the oracle_jasper_manual.bat
and upgradedatabaseschema
scripts.
To restore all reportuser grants:
- Open command prompt and navigate to the
%AGILIANCE_HOME%\install\
directory. - Enter
oracle_jasper_manual.bat
on the command line and press Enter. - Follow the instructions that appear on the command line to successfully execute the script.
To restore the database to its original state:
- Open command prompt window and navigate to the
%AGILIANCE_HOME%\install\toolbox\bin\
directory. - Enter
upgradedatabaseschema.cmd
on the command line and press Enter to successfully execute the script.
Case III
There have been cases in which the RiskVision Server upgrade appears to have worked successfully, but Tomcat displays the following error:
********************************************************
The server is expecting the database version [Expected Version No.]. But the current database version is [Current Version No.]
********************************************************05-07 00:49:11.385|I|localhost-startStop-1|57089024|?|VersionCheckUtil - See the Administrator's Guide for instructions on how to upgrade the database.
In this case, the problem is that there is not enough memory being allocated to Tomcat on the user's environment and the memory space must be increased.
To increase the memory space:
Close all RiskVision and Tomcat services.
Navigate to the C:\Server\install\toolbox\bin folder.
Open the ajava.cmd file.
Increase the
spaceSize
using the following code:echo this is 64 bit JVM
"%JAVA%" -Xms1024M -Xmx4096M -XX:MaxMetaspaceSize=512m -Djava.util.Arrays.useLegacyMergeSort=true %*
) else (
echo this is not 64 bit JVM
"%JAVA%" -Xms256M -Xmx1536M -XX:MaxMetaspaceSize=512m -Djava.util.Arrays.useLegacyMergeSort=true %* )
-Xmx4096M, -Xmx1536M by 8 or 6 times
Restart RiskVision.
Run the upgradedatabaseschema.cmd file in the C:\Server\install\toolbox\bin folder.