User Tools

Site Tools


faq:mac:install_fails

Installation Fails on Mac OS X

If the installation of GECAMed fails on Mac OS-X, the root user may not be activated on your system or you have the wrong Java version for the JBoss.

This is how to enable the root account on OS-X:

Enable the root user:

Here Apple describes for each Mac OS X version, how to enable the root user: http://support.apple.com/kb/ht1528

After enabling the root user, please do a clean uninstall (see Uninstall GECAMed on OS-X) and reinstall GECAMed from scratch.

Fix the Java version used by the JBoss

If you have Java version 1.6 or higher installed on your System (default on Mac OS-X 10.6), the JBoss might not be able to be installed and / or run correctly.
To enable the JBoss to use the right Java version (Java 1.5), you can download and use the script in this ZIP file: Java 1.5 for Mac
It includes a prepared version of the Java JDK 1.5 and a script to install it on your mac. If you have GECAMed 2.01.00 or higher installed, you already have this ZIP file, located at «GECAMed Folder»/java/java_1.5_Mac.zip.

To execute the script, login with a user that has root privileges (“Admin”), open the terminal, go to the folder, where you have unziped the file java_1.5_mac.zip and run the following command

sudo ./install_java_1.5.sh

You will be asked to enter your user password (you won't see that you type anything, but don't bother).

This script links all applications explicitly using java 1.5 (like the GECAMed JBoss server) to rely use a version of Java 1.5.
Be careful, because a Java update will reset the linking and you will have to execute the script again.

To make GECAMed reinstall Java 1.5 at start up if necessary, you can change the start script of the GECAMed server. To do so, download this zip: gecamed_start_script_mac.zip, unzip it and replace the current start script with the one in the ZIP-file, by copying the run.sh file, included in the downloaded zip-file, into the folder «GECAMed Install Dir»/jboss-4.0.5.GA/bin and choose to replace the existing run.sh file in this folder (you need a user with root privileges to do that). By default the «GECAMed Install Dir» is /Applications/GECAMed/.
To make this start up script update your java correctly, you need to have the file java_1.5._mac.zip unzipped in the folder «GECAMed Install Dir»/java.

If you do so, you don't need to manually reinstall Java 1.5 for GECAMed. The GECAMed server will check Java before starting and install it, if necessary.
This script is included in the GECAMed installer since version 1.5.00 (but not in the updater).

Installation Fails on Mac OS-X Server

After installing GECAMed on any Mac OS X Server version, GECAMed might not start. That is because the whole JBoss folder, which should be directly in the GECAMed folder, is missing.

A workaround is to install GECAMed on another system (it can be Mac, Windows or Linux, but it must be the same version of GECAMed) and copy the JBoss folder (located in the GECAMed install dir) from this system, into the GECAMed folder on the system, where the GECAMed installation failed.
Afterwards you'll need to configure the JBoss for the new system.

To do so, copy and replace the following files («GECAMedDir» has to be replaced by the GECAMed install dir. By default this is /Applications/GECAMed):

From To
«GECAMedDir»/install/config/GECAMed-ds.xml «GECAMedDir»/jboss-4.0.5.GA/server/default/deploy/
«GECAMedDir»/install/config/log4j.xml «GECAMedDir»/jboss-4.0.5.GA/server/default/conf/
«GECAMedDir»/install/config/gecamed_server.properties «GECAMedDir»/jboss-4.0.5.GA/server/default/conf/
«GECAMedDir»/install/autostart/lu.tudor.santec.gecamed_server.plist /Library/LaunchDaemons/

If you haven't copied the JBoss folder from another Mac OS X system, you will also have to copy and replace the following files …

From To
«GECAMedDir»/install/jboss/run.sh «GECAMedDir»/jboss-4.0.5.GA/bin/
«GECAMedDir»/install/autostart/jboss_ctl.sh «GECAMedDir»/jboss-4.0.5.GA/bin/
«GECAMedDir»/install/config/jmx-console-users.properties «GECAMedDir»/jboss-4.0.5.GA/server/default/conf/props/

… and change in the file «GECAMedDir»/jboss-4.0.5.GA/server/default/conf/gecamed_server.properties the value of DB_BACKUP_SCRIPT from […]/scripts/gecamed_db_backup.bat to […]/scripts/gecamed_db_backup_OSX.sh.

After you copied all these files, open the terminal and execute the following commands:

  • sudo chmod +x «GECAMedDir»/jboss-4.0.5.GA/bin/jboss_ctl.sh
  • sudo chmod 644 /Library/LaunchDaemons/lu.tudor.santec.gecamed_server.plist
  • sudo chown root /Library/LaunchDaemons/lu.tudor.santec.gecamed_server.plist
  • sudo launchctl load /Library/LaunchDaemons/lu.tudor.santec.gecamed_server.plist

This will install and start the GECAMed server daemon, which will start the GECAMed service now and on system startup.

Verify Installation on Mac OS-X

On Mac OS-X installations tend to be more complex then on Windows. If GECAMed is obviously not running after the initial installation, or an upgrade, try the following:

  1. If there is no icon to start the GECAMed client it can be started manually by typing the following URL in Safari (on the same computer where GECAMed was installed): http://localhost:8080/gecamed
  2. if this does not work, chances are that the main server component of GECAMed, the JBoss application server, is not running. To check whether JBoss is running or not type the following URL in Safari (on the same computer where GECAMed was installed): http://localhost:8080
    If it works you'll see a welcome screen from the JBoss, otherwise you will see an “URL not found” error.
  3. another way to test the availability of the JBoss server is by issuing the following command in a terminal session: sudo ps ax | grep jboss. You should get a list of 2 processes (one for the grep command, you just executed and one for the jboss)
  4. If the JBoss isn't running, first try to reboot the computer. If this doesn't help, try to start the JBoss manually, using the run.sh command.

following the example below:

--------------------------------------------------------
Script started on Wed Oct 13 13:52:26 2010
MyComputer$ pwd
/Users/santec

MyComputer$ cd /Applications
MyComputer$ ls
Address Book.app        GECAMed                 Sherlock.app
AppleScript             Image Capture.app       Stickies.app
Automator.app           Internet Connect.app    System Preferences.app
Calculator.app          Mail.app                TextEdit.app
Chess.app               Optimage                Utilities
DVD Player.app          PostgreSQL 8.3          iCal.app
Dashboard.app           Preview.app             iChat.app
Dictionary.app          QuickTime Player.app    iSync.app
Font Book.app           Safari.app              iTunes.app

MyComputer$ cd GECAMed

MyComputer$ ls
Uninstaller     install         jboss-4.0.5.GA  uninstall.ico
icon.ico        java            scripts
MyComputer$ cd jboss-4.0.5.GA/

MyComputer$  ls
Uninstaller     client          lib             server
bin             docs            scripts

MyComputer$ cd bin

MyComputer$ ls
classpath.sh            run.bat                 shutdown.sh
jboss_init_hpux.sh      run.conf                twiddle.bat
jboss_init_redhat.sh    run.jar                 twiddle.jar
jboss_init_suse.sh      run.sh                  twiddle.sh
probe.bat               shutdown.bat            wstools.bat
probe.sh                shutdown.jar            wstools.sh

MyComputer$ ./run.sh
=========================================================================

  JBoss Bootstrap Environment

  JBOSS_HOME: /applications/GECAMed/jboss-4.0.5.GA

  JAVA: java

  JAVA_OPTS: -Dprogram.name=run.sh -Xms128m -Xmx512m
-Dsun.rmi.dgc.client.gcInterval=3600000
-Dsun.rmi.dgc.server.gcInterval=3600000


CLASSPATH: /applications/GECAMed/jboss-4.0.5.GA/bin/run.jar:/lib/tools.jar

=========================================================================
faq/mac/install_fails.txt · Last modified: 2015/01/16 09:48 by ferringj