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