This section describes troubleshooting steps that you can apply to resolve errors that you might face while upgrading AuthMinder.
The upgrade tool fails with the following error:
Error Occured: IO exception while parsing, %ARCOT_HOME%\tools\common\upgrade\xml\arcot-common-upgrade-meta-data.xml
The upgrade tool was not able to find the arcot-common-upgrade-meta-data.xml file.
Check if the arcot-common-upgrade-meta-data.xml file exists in %ARCOT_HOME%\tools\common\upgrade\xml. This error can commonly occur when the arcot-common-db-upgrade.zip file is not extracted using the Extract To Here option.
The upgrade tool fails with the following error:
Internal Error: Could not initialize upgrade tool. Error:: Cannot load JDBC driver class 'oracle.jdbc.driver.OracleDriver' Error Occured: Upgrade Initialization Error:oracle.jdbc.driver.OracleDriver
The upgrade tool could not find the JDBC library to connect to the database.
Check whether the JDBC library is copied to the %ARCOT_HOME%\tools\common\upgrade\lib directory.
If the JDBC library is already copied, then check whether the name of the JDBC jar file is correctly specified, as described in procedure to migrate the database to release 6.0 for Arcot common components. Also, check if the JDBC jar file corresponds to the database configured in the arcotcommon.ini file against the DbType parameter.
The upgrade tool fails with the following error:
FATAL: ARCOT_HOME Environment Variable Not Set
%ARCOT_HOME% is not set.
Set the %ARCOT_HOME% environment variable and run the upgrade tool.
The upgrade tool fails with the following error:
Error Occured: Upgrade Initialization Error:Could not create DBService instance"
Check if the user name and password are configured correctly in the arcotcommon.ini and securestore.enc files, respectively.
The upgrade tool fails with the following error:
Error Occured: Upgrade Initialization Error:Io exception: The Network Adapter could not establish the connection"
Check if the JDBC URL is correct and points to the correct database. Ensure that the database is up and running.
The upgrade tool fails with the following error:
javax.crypto.BadPaddingException: Given final block not properly padded
The key label used to encrypt the data is not the same as the key used for decryption.
Ensure that the master key label used to encrypt data in the database is the same as the key label used by the upgrade tool to decrypt data. The master key label is stored in the securestore.enc file in the %ARCOT_HOME%\conf folder.
The upgrade tool fails with the following or similar error:
"java.sql.SQLException: ORA-20010: -1031-ORA-01031: insufficient privileges"
The database user configured in the arcotcommon.ini file does not have sufficient database privileges to carry out the database upgrade.
Ensure that the administrator performing the upgrade has the required database privileges. Installation time privileges are applicable to upgrade also.
The upgrade tool fails with the following or similar error:
"ORA-01536: space quota exceeded for tablespace"
The database user configured in the arcotcommon.ini file has exhausted the space quota in the tablespace.
The DBA must increase the quota for the user. You must restart the upgrade tool after you reimport the pre-upgrade data.
After the upgrade process, the Administration Console fails to start and returns the following error:
ERROR : taglib.tiles.InsertTag : ServletException in '/WEB-INF/jsp/dynamic/navbar_GA.jsp': File "/WEB-INF/jsp/dynamic/navbar_GA.jsp"
The Work folder of the application server where the Administration Console is deployed still contains the cache of the earlier Administration Console version.
Clear the Work folder of the application server where the Administration Console is deployed and restart the application server.
After the upgrade process, an administrator belonging to the LDAP repository can no longer log in to the Administration Console.
The administrator might be disabled in LDAP.
Ensure that the administrator is not disabled in LDAP. Disabled administrators are not allowed to log in to the Administration Console.
After the upgrade process, for the IBM DB2 database the AuthMinder Server-specific reports fail to generate with the following error:
DB2 SQL Error: SQLCODE=-1585, SQLSTATE=54048, SQLERRMC=null
The SYSTEM TEMPORARY tablespace page size might be set to the default value of 4K, which is not sufficient for report queries that involve columns exceeding 4K size.
Set the SYSTEM TEMPORARY tablespace page size to a minimum of 16K. Refer to database vendor documentation for more information.
|
Copyright © 2013 CA.
All rights reserved.
|
|