You're seeing this informational page, rather than the Mage, Prekin, or Probe ../downloads pages, because the use of these programs on the Mac OS X platform is new enough to us that we feel more discussion about their installation and use is warranted than on the more familiar platforms. Bear with us, please. We're still sorting through all the various flavors and combinations of how Mage & Prekin will run. Below is a flow chart which represents available combinations which will work - it represents our history with versions 10.0, 10.1, and 10.2. The current best install from both performance and ease of installation is the "golden path" below - OS 10.2 + Apple's X11 + MotifZone's openMotif libraries. If this is the path that applies to you, then installation is straightforward and is covered immediately below the flow chart. The other pages of this section are additional details on the use of Mage, Prekin, and Probe on the Mac OS X platform and are intended for troubleshooting or for those who have pre-10.2 (pre-jaguar) systems. The additional information is covered on three pages:
- OS Requirements (not there yet)
- Installation Procedures (not there yet)
- Usage & Hints (not there yet)
Installing Mage-Probe on Mac OSX 10.2 (or later)
- Download and install (update) Apple's X11 for Mac OS X. The download is delivered as a SIT compressed .dmg file, which, depending upon your browser setup may be uncompressed at download. Unconpress (or expand) if needed. Doubleclick on the .dmg file to mount it (if necessary) and then doubleclick the install bundle to start the actual installation.
- Do the same as above for the openMotif libraries.
- Download and expand the SIT compressed binaries for Mage, Prekin, and Probe. You will need to hand-install these programs in your Unix binary subdirectory of choice. We recommend that you use the subdirectory /usr/local/bin/ and the instructions below are written for that. If you use a different subdirectory, then make the necessary substitutions in what follow. You'll need a system terminal window for these steps, so either use an Xterm window from the X11 package, or use the Terminal application (located in the Utilities folder).
- Create the /usr/local/bin/ subdirectory, if it doesn't already exist.
- Try changing the working dir to the target: cd /usr/local/bin
- If the cd command works, determine the path via the pwd command and do a directory listing via ls -l.
- If the above indicates that /usr/local/bin/ doesn't exist, then create is via the mkdir command. You may need to preface the command with the sudo option depending upon the privileges set on the directories.
- Move or copy the uncompressed Mage, Prekin, and Probe binaries to /usr/local/bin/. You may want to keep the compressed download as source for further installs.
- Make the binaries executable and create a softlink to the common program name, if needed.
- Use the chmod command to change priveleges: chmod 755 mage.6.21 will mark the file mage.6.21 as an executable by the world and give write (delete) priveleges to the owner.
- The remote update facility of mage calls the probe and prekin programs passing arguments to them for the requested action. As such, it is easiest if the program names are the same as those used in the remote calls. So, if you want to name the executables something other than "probe" etc., then you'll need to map the non-canonical program names to the program call. A way of doing this linkage is the command: ln -s mage.exec mage
- Test the installation.