User Tools

Site Tools





This article provides some tips and hints to install an Alfresco system on openSUSE with following components:

  • OS: openSUSE 10.3
  • Alfresco 2.9B
  • Java 1.6
  • JBoss 4.2.2 GA
  • MySQL

All steps are done as user root.

  1. Install openSUSE with Java, MySQL, OpenOffice and ImageMagick
  2. Check and/or correct the JAVA_HOME environment setting
    # echo $JAVA_HOME
    # $JAVA_HOME/bin/java -version
    java version "1.6.0_05"
    Java(TM) SE Runtime Environment (build 1.6.0_05-b13)
    Java HotSpot(TM) Client VM (build 10.0-b19, mixed mode)
  3. Just to have some files and a glance in Alfrescos way to do it I've installed a out-of-the-box Alfresco system to /usr/share/alfresco. I used the file AlfrescoCommunity-2.9.0B-Linux-x86-Install.
  4. Setup MySQL as a demon (with YaST - Runlevel Editor or the chkconfig command)
  5. Setup MySQL Databases using the scripts served by Alfresco. Relating to step 3. you'll find these files in /usr/share/alfresco/extras/databases/mysql
    # cd /usr/share/alfresco/extras/databases/mysql
    # mysql -u root -p < db_setup.sql
  6. Install JBoss. My JBoss home directory is /usr/share/jboss-4.2.2.GA but thats no matter. This destination folder is called JBOSS_HOME from now on.
  7. Install the MySQL JDBC connector for JBoss (it's provided by MySQL)
    • get the driver from MySQL
    • extract it and copy the contained .jar file to JBOSS_HOME/server/default/lib
  8. Deploy Alfresco
    • get alfresco-community-war-2.9.0B from Alfresco download area
    • extract it and thereafter extract the contained alfresco.war as a folder called JBOSS_HOME/server/default/deploy/alfresco.war.
  9. Refer to
  10. Create/manage start/stop scripts for JBoss and OOo in /usr/share/alfresco (the default scripts delivered by Alfresco dont work because of a hard link to openoffice and a nonresolved variable @@ALFRESCO@@ - it took me days to research in the internet what kind of syntax that is… obviously it is a special Alfresco thing that should be replaced by the install routine but it didn't)
    • create a script in /usr/share/alfresco with
      # ---------------------------------------------------------------------------
      # Start script for the OpenOffice transform service
      # ---------------------------------------------------------------------------
      echo "Starting OpenOffice service..."
      soffice "-accept=socket,host=localhost,port=8100;urp;StarOffice.ServiceManager" "-env:UserInstallation=file:///usr/share/alfresco/oouser" -nologo -headless -nofirststartwizard &
    • create a script in /usr/share/alfresco with
      # Start or stop Alfresco server
      # Set the following to where Tomcat is installed
      if [ "$1" = "start" ]; then
        /usr/share/jboss-4.2.2.GA/bin/ start
      elif [ "$1" = "stop" ]; then
        /usr/share/jboss-4.2.2.GA/bin/ stop
        killall soffice.bin
  • modify the script in /usr/share/jboss-4.2.2.GA/bin/ with
    # JBoss Control Script
    # To use this script
    # run it as root - it will switch to the specified user
    # It loses all console output - use the log.
    # Here is a little (and extremely primitive)
    # startup/shutdown script for SuSE systems. It assumes
    # that JBoss lives in /usr/local/jboss, it's run by user
    # 'jboss' and JDK binaries are in /usr/local/jdk/bin. All
    # this can be changed in the script itself.
    # Either amend this script for your requirements
    # or just ensure that the following variables are set correctly
    # before calling the script.
    # Provides: jboss
    # Default-Start: 3 5
    # Default-Stop: 0 1 2 6
    # Description: Start the JBoss application server.
    #define where jboss is - this is the directory containing directories log, bin, conf etc
    #make java is on your path
    #define the classpath for the shutdown class
    #define the script to use to start jboss
    JBOSSSH=${JBOSSSH:-"$JBOSS_HOME/bin/ -b -c default"}
    # Shell functions sourced from /etc/rc.status:
    #      rc_check         check and set local and overall rc status
    #      rc_status        check and set local and overall rc status
    #      rc_status -v     ditto but be verbose in local rc status
    #      rc_status -v -r  ditto and clear the local rc status
    #      rc_failed        set local and overall rc status to failed
    #      rc_reset         clear local rc status (overall remains)
    #      rc_exit          exit appropriate to overall rc status
    . /etc/rc.status
    # First reset status of this service
    # Return values acc. to LSB for all commands but status:
    # 0 - success
    # 1 - misc error
    # 2 - invalid or excess args
    # 3 - unimplemented feature (e.g. reload)
    # 4 - insufficient privilege
    # 5 - program not installed
    # 6 - program not configured
    # Note that starting an already running service, stopping
    # or restarting a not-running service as well as the restart
    # with force-reload (in case signalling is not supported) are
    # considered a success.
    if [ -n "$JBOSS_CONSOLE" -a ! -d "$JBOSS_CONSOLE" ]; then
      # ensure the file exists
      touch $JBOSS_CONSOLE
    if [ -n "$JBOSS_CONSOLE" -a ! -f "$JBOSS_CONSOLE" ]; then
      echo "WARNING: location for saving console log invalid: $JBOSS_CONSOLE"
      echo "WARNING: ignoring it and using /dev/null"
    #define what will be done with the console log
    #define the user under which jboss will run, or use RUNASIS to run as the current user
    CMD_STOP="java -classpath $JBOSSCP org.jboss.Shutdown --shutdown"
    if [ "$JBOSSUS" = "RUNASIS" ]; then
      SUBIT="su - $JBOSSUS -c "
    if [ -z "`echo $PATH | grep $JAVAPTH`" ]; then
      export PATH=$PATH:$JAVAPTH
    if [ ! -d "$JBOSS_HOME" ]; then
      echo JBOSS_HOME does not exist as a valid directory : $JBOSS_HOME
      exit 1
    case "$1" in
        echo -n "Starting JBoss application server: "
        cd $JBOSS_HOME/bin
        if [ -z "$SUBIT" ]; then
            eval $CMD_START >${JBOSS_CONSOLE} 2>&1 &
            $SUBIT "$CMD_START >${JBOSS_CONSOLE} 2>&1 &"
        # Remember status and be verbose
        rc_status -v
        echo -n "Shutting down JBoss application server: "
        if [ -z "$SUBIT" ]; then
            $SUBIT "$CMD_STOP"
        # Remember status and be verbose
        rc_status -v
        $0 stop
        $0 start
        # Remember status and be quiet
        echo "usage: $0 (start|stop|restart|help)"

—- FIXME For a production environment there should:

  • an init script instead of manual start and stop procedure
  • run the system in runlevel 3 (text console only)
  • run the system under user account instead of root
  • be printed all messages on the console (currently I tail -f /var/log/jboss.log)
  • alternatively have a ServiceControl to start/stop/Status etc. the system as well as displaying the messages
  • alternatively use Eclipse with JBoss Tools as Service Monitor and also as an easy way to check/change the config files.

Andreas Hartmann 16.05.2008 15:43


Enter your comment. Wiki syntax is allowed:
forum/alfresco/installation.txt · Last modified: 2023/11/19 22:46 (external edit)