Installing XpertMart on Macintosh OS X


Chapter Topics
Installing XpertMart on Macintosh OS X
Activating the HASP Key
Running XpertMart
Changing the Java Version
Uninstalling & Reinstalling Firebird

Installing XpertMart
Follow these five steps:

1) Download the XpertMartInstall.dmg from http://xpertmart.com/demo/download/demomaclicense.html

This file is a compressed disk image that contains the XpertMart installation software. Wait until the download is complete. If your web browser and system are properly configured, Disk Copy will launch to open the downloaded disk image. If so, skip to step 2.

If Disk Copy doesn't automatically open when your download completes, find the XpertMartInstall.dmg file you just downloaded. It will usually be saved to your desktop. Double-click this image file to open it in Mac OS X's Disk Copy application, which will mount it as a virtual disk and open a new Finder showing its contents.

2) Copy the main directory to the root of your Macintosh HD

From the first step a Finder window will appear containing a folder icon named main. Simply drag this folder icon to your Macintosh HD to install. Do not install the main folder into the Applications folder or XpertMart will not work properly.

3) Install the FirebirdDBMS.pkg

The Finder window also contains a file named FirebirdDBMS.pkg. Double click this file to install the Firebird DBMS. Simply follow the instructions on screen.

Warning: make sure you only install the Firebird DBMS once. Even if at a later time you download a new version of XpertMart you should not reinstall the Firebird DBMS if it is installed already.

4) Remove unneeded files

Once XpertMart is installed, you can safely "Eject" the XpertMartInstall virtual disk and dispose of the XpertMartInstall.dmg file you downloaded, they'll be cluttering up your desktop and you don't need them any more. You can drag them to the Trash icon.

5) Restart your Mac.

Your Mac has to be restarted before you use XpertMart for the first time.

Activating the HASP Key
The HASP key is used to restrict unauthorized access to XpertMart and must be activated before you can begin using the system. Run this process before you plug the HASP key into the USB port of your computer. To activate the HASP, double-click the "HDD-Unified-Installer.sit.hqx" file. This will unpack a folder with a file called "aksusb Installer" in it.



By double-clicking on the "aksusb Installer" file a window will open up so you can install the HASP drivers. Click on <Continue> and follow the instructions.



Your HASP key is now activated. You do not need to restart the computer. You can now plug the HASP key into the USB port and enter XpertMart by double-clicking on the "XpertMart.jar" file in the /Main directory, or by using the desktop shortcut you created.


Running XpertMart
To begin using XpertMart you have to double-click the XpertMart.jar icon that is located in the /main directory in your Macintosh HD.

To make it easier to access XpertMart you can create an alias to it. For example drag the XpertMart.jar icon to your Dock for easy access or press the Command and Option keys while you drag the icon to another folder or the desktop.


Changing the Java Version
For XpertMart to run under optimal conditions it needs to run under version 1.3.1 of the Java Runtime Environment (JRE). Since Mac OS X runs JRE version 1.4 by default, generally you should first switch to version 1.3.1.

However, when you first install XpertMart from a .dmg file it is ok to keep a different verion of Java as the default because the .dmg file contains instructions on which Java version is to be used to run XpertMart. So you would only really need to switch Java version if you were trying to run XpertMart straight from the XpertMart.jar file. (For example, once you downloaded the .dmg you then decided to copy over the files to another computer).

To change the Java version, open the Terminal screen or shell:  The Terminal can be found in Applications>Utilities>Terminal. Once the Terminal screen is open, enter the following instructions:

    a) Login as the system administrator by entering this command:
	shell> sudo su root
    b) Enter your password

    c) Change directories to the directory where version 1.3.1 is located:
	shell> cd /System/Library/Frameworks/JavaVM.framework/Versions
    d) Erase the CurrentJDK link:
	shell> rm CurrentJDK
    e) Create a new link that points to the 1.3.1 directory: 
	shell> ln –s 1.3.1 CurrentJDK
    f) Logout of the session as administrator:
	shell> exit

Uninstalling & Reinstalling Firebird
If for any reason your installation of Firebird on OS X is not installed correctly or working properly then you need to uninstall the current Firebird in order to successfully do a new install. Reinstalling Firebird on top of a working Firebird will cause it to stop functioning!

To uninstall Firebird, open the Terminal screen or shell: The Terminal can be found in Applications>Utilities>Terminal. Once the Terminal screen is open, enter the following instructions:

 a) Login as the system administrator by entering this command:
	shell> sudo su root
b) Enter your password

c) Change directories to the directory where Firebird is located:
	shell> cd /Library/Frameworks
d) Erase the Firebird directory: (Note: This is a very powerful command with no "undo" so type it exactly as written here.)
	shell> rm -fr Firebird.framework
e) Logout of the session as administrator:
	shell> exit

You can then proceed to reinstall Firebird.


Copyright
 2003 Dinari Systems LLC

* Return to Table of Contents *