OS Specific Issues

While an AppFuse app can be run on any system that supports the Java requirements there are occasionally issues that effect only certain operating systems. Because these are not "bugs" in AppFuse they are not entered into the issue tracker. Instead they are listed below for reference.

Ubuntu 7.10

• Many of the directories in /var/lib/tomcat5.5 are symlinks and in some conditions I haven't quite figured out the owner of these directories or files within are changed. This causes Tomcat to fail to start. To fix this you can run the following command as root:
  chown -R tomcat55:nogroup /var/lib/tomcat5.5
• Java security is enabled by default in Tomcat. Which makes sense for a production server, but can be quite a pain when developing. To disable Java security in Tomcat edit the following property in /etc/default/tomcat5.5:
  TOMCAT5_SECURITY=no
• XML parsing is configured incorrectly in a fresh installation of Tomcat on Ubuntu 7.10. So if you are having a hard time parsing those XML config files, remove the following symlink:
  /usr/share/tomcat5.5/common/endorsed/xml-apis.jar
  Thanks to CODESPIN for this one, I forgot about it until finding his blog on the issue. http://codespin.blogspot.com/2008/01/fixing-common-tomcat-55-problems-on.html
• The packaged Tomcat 5.5 that comes with Ubuntu 7.10 does not have a catalina.out pipe or other console output. The way to get around this problem is to modify the src/main/resources/log4j.xml by replacing the "CONSOLE" appender with a "FILE" appender.

      <!-- Commented out because we are using a file appender instead -->
      <!--
      <appender name="CONSOLE" class="org.apache.log4j.ConsoleAppender">
          <layout class="org.apache.log4j.PatternLayout">
              <param name="ConversionPattern"
                  value="[myapp] %p [%t] %c{1}.%M(%L) | %m%n"/>
          </layout>
      </appender>
      -->
      <appender name="FILE" class="org.apache.log4j.RollingFileAppender">
          <param name="File" value="/var/log/tomcat5.5/cbeyond.log"/>
          <param name="Append" value="true"/>
          <param name="MaxFileSize" value="1000KB"/>
          <param name="maxBackupIndex" value="5"/> 
          <layout class="org.apache.log4j.PatternLayout">
              <param name="ConversionPattern"
                  value="[myapp] %p [%t] %c{1}.%M(%L) | %m%n"/>
          </layout>
      </appender>
      ....
      <root>
          <level value="WARN"/>
          <appender-ref ref="FILE"/>
      </root>