AWI Administration Perspective Only Lists Packs

Document ID : KB000107702
Last Modified Date : 25/07/2018
Show Technical Document Details
Issue:
Administration perspective only lists Packs (no Agent/Automation Engine/etc sections are available).
Environment:
Release: 12.1.1 OS: Oracle Linux 6.8

Investigation:

1) Help -> About from the AWI shows an error:

Object Common Sheet Plugin 12.1.1.GA02-dev-feature-12.1.1-GA02-68435 (stopped - see log for details).

2) Errors noted in Tomcat/AWI logs:

java.lang.NoClassDefFoundError 
java.lang.ClassNotFoundException 

Class 'com.uc4.ecc.ae.commons.content.uc4objectview.ToBeRemovedCompatibilityEvents' was not found because bundle com.uc4.ecc-plugins-usermanagement [59] does not import 'com.uc4.ecc.ae.commons.content.uc4objectview' even though buncle com.uc4.ecc-ae-commons [4] does export it. To resolve this issue, add an import for 'com.uc4.ecc.ae.commons.content.uc4objectview' to bundle com.uc4.ecc-plugins-usermanagement [59] 

Package 'com-uc4.ecc.ae.commons.content.uc4objectview' is imported by bundle com.uc4.ecc-ae-commons [4] from bundle com.uc4.ecc-ae-commons [4], but the exported package from bundle com.uc4.ecc-ae-commons [4] does not contain the requested class 'com.uc4.ecc.ae.commons.content.uc4objectview.ToBeRemovedCompatibilityEvents'. Please verify that the class name is correct in the importing bundle com.uc4.ecc-ae-commons [4] and.or that the exported package is correctly bundled in com.uc4.ecc-ae-commons [4].

Steps taken:

3) Replace the .war file in use with one from the Automation Engine image and re-start Tomcat.
4) Obtain the .jar file directly from the download center and replace. 

5) Check the setenv.sh file for Tomcat - there may not be enough memory allocated. Example:

export CATALINA_OPTS="-Xmx4096m" 
export JAVA_HOME=/opt/java/jdk1.8.0_144 
export CATALINA_OPTS="-Dcom.uc4.ecc.config.dir=/opt/automic/tomcat/apache-tomcat-8.5.20/conf/automic -Dcom.uc4.ecc.autoinstall.dir=/opt/automic/tomcat/apache-tomcat-8.5.20/conf/automic/plugins" 
Cause:
Tomcat is not being started with enough memory.
Resolution:
Commenting out the third line (reference: see below) in the setenv.sh file for Tomcat folder and cycling Tomcat resolved the issue:

export CATALINA_OPTS="-Xmx4096m"
export JAVA_HOME=/opt/java/jdk1.8.0_144
export CATALINA_OPTS="-Dcom.uc4.ecc.config.dir=/opt/automic/tomcat/apache-tomcat-8.5.20/conf/automic -Dcom.uc4.ecc.autoinstall.dir=/opt/automic/tomcat/apache-tomcat-8.5.20/conf/automic/plugins"

The first line sets Tomcat memory, but the third replaces it. This means Tomcat will start with 256M memory. This was causing Tomcat to error, and it didn't have enough memory to display even the basic views.