Installation Troubleshooting

Building issues

Under OS X, the build fails with:

...
[java] Caused by: java.lang.UnsupportedClassVersionError: Bad version number in .class file
    [java]     at java.lang.ClassLoader.defineClass1(Native Method)
    [java]     at java.lang.ClassLoader.defineClass(ClassLoader.java:675)
    [java]     at java.security.SecureClassLoader.defineClass(SecureClassLoader.java:124)
...

This problem is caused by running Java 1.5 on an OS X that has 1.6 installed and isn't uPortal specific. During the 1.6 upgrade, Apple added a scripting jar to the global Java library space that should have been 1.6-only. To fix the problem, try the following:

sudo mv /System/Library/Java/Extensions/AppleScriptEngine.jar /System/Library/Frameworks/JavaVM.framework/Versions/1.6.0/Home/lib/ext\

Database Issues

 MySql

Complains of missing tables despite the tables existing.

com.mysql.jdbc.exceptions.MySQLSyntaxErrorException: Table 'up26.up_layout_param' doesn't exist

Your mysql server is running in case-sensitive mode.  Edit your mysql server configuration and set:

lower_case_table_names=1

This config file is found under /etc/mysql/my.cnf on unix systems.  After setting this option, reboot your mysql server, drop the uPortal tables, and run the initportal task again.

Creating v3.2.x .war W/O Simultaneously Deploying

We are trying to build a set of the .war's which comprise those in the QuickStart so we can deploy them in our own TomCat environment. The documentation that I've been able to find all references using ant, but when run ant indicates mvn should be used instead. Looking at the mvn targets it would appear that "compile" and "package" should be the targets we need to use to accomplish our objective.

However, not being a maven expert I struggled trying to resolve missing dependencies. I finally managed to satisfy the "compile" dependencies by building a local repository to include the...

  • BookmarksPortlet,
  • FunctionalTestsPortlet,
  • jasig-widget-portlets,
  • RssPortlet and
  • WeatherPortlet

.wars. However, when I tried to do a "mvn package" I got a "A required class is missing: org/apache/maven/doxia/tools/SiteToolException". Following the dependency tree for the .jar in which SiteToolException is located I tried adding the following to my local repository: 

  • doxia-decoration-model-1.1.3.jar
  • doxia-module-xhtml-1.1.3.jar
  • doxia-sink-api-1.1.3.jar
  • doxia-site-renderer-1.1.3.jar
  • jetty-6.1.24.jar
  • maven-artifact-3.0-beta-1.jar
  • maven-artifact-manager-2.2.1.jar
  • maven-doxia-tools-1.0.1.jar
  • maven-doxia-tools-1.2.1.jar
  • maven-model-3.0-beta-1.jar
  • maven-plugin-api-3.0-beta-1.jar
  • maven-plugin-testing-harness-1.1.jar
  • maven-project-3.0-alpha-2.jar
  • maven-reporting-api-3.0.jar
  • maven-settings-3.0-beta-1.jar
  • plexus-archiver-1.0.jar
  • plexus-container-default-1.5.4.jar
  • plexus-i18n-1.0-beta-7.jar
  • plexus-utils-2.0.5.jar
  • wagon-provider-api-1.0-beta-6.jar
    but this had no effect on the missing class failure.

I'm sure the problems I'm having are because I don't really understand the correct procedures to follow.

Regardless, this all seems to complicated. Can someone either...

  • Tell me how to configure my project to look in the appropriate online maven repositories so the dependencies are met automatically, or
  • Tell me where the above .jars should go in my environment or how to set the classpath so that the classes are found during the build?

Thanks in advance for your assistance!

John