Installing XpertMart on Macintosh OS X


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


Installing XpertMart
Follow these five steps:

1)  Insert the Installation CD.
Inside you will find a file called XpertMart_OSXInstall.dmg. If you are installing the demo version, you can 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. 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) 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.


3) Activate the Hasp key
If you are installing the demo version of XpertMart you may skip this step.

Along with the XpertMart™ Install CD you should also have a Hasp key. The Hasp is a hardware device that plugs into your Mac’s USB port and is part of XpertMart™’s security system. The Hasp key guards against unauthorized use of the program and against piracy. The Hasp also tells the computer what kind of workstation it is: a Single Store, a Main, a Remote, an Infostation, a Single Store Workstation, and so on.

The Hasp keys you received should be labeled. Insert the Hasp key you want to use into a USB port. If you are using an iMac, you should use the low-speed USB port on the keyboard and leave the other two high-speed ports available for peripherals.



The Finder window contains also contains a file named aksusb Installer. Double click this file to install the Hasp software. Simply follow the instructions on screen. When you are done, a light on the tip of the Hasp key should come on, indicating that the computer now detects the Hasp key.

(Note: you might occasionally see other pkg and auto-install files in the Finder window. If you do see such a file, it is because it contains drivers to peripheral devices you may be using. Double-click on the file and follow the instructions on the screen.)


4) Copy the main directory to the root of your Macintosh HD
Inside the Finder window you will also see 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.




5) Restart your Mac.
Your Mac has to be restarted before you use XpertMart for the first time. XpertMart will not work if you do not first restart!

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.


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.

To change the Java version, open the Terminal screen (also known as 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:
	sudo su root
    b) Enter your password

    c) Change directories to the directory where version 1.3.1 is located:
	cd /System/Library/Frameworks/JavaVM.framework/Versions
    d) Erase the CurrentJDK link:
	rm CurrentJDK
    e) Create a new link that points to the 1.3.1 directory: 
	ln –s 1.3.1 CurrentJDK
    f) Logout of the session as administrator:
	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:
	sudo su root
b) Enter your password

c) Change directories to the directory where Firebird is located:
	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.)
	rm -fr Firebird.framework
e) Logout of the session as administrator:
	exit

You can then proceed to reinstall Firebird.


If you are having trouble Installing XpertMart click here for help.


Copyright
© 2005 Dinari Systems LLC

* Return to Table of Contents *