Changeset 813 for trunk/doc/osx.html

Timestamp:

Dec 4, 2009 5:12:29 PM (14 years ago)

Author:

toby

Message:

# on 2004/09/28 22:41:00, toby did:
major update; simply install

File:

• trunk/doc/osx.html (modified) (10 diffs, 3 props)

trunk/doc/osx.html

@@ -31 +31 @@
 
 This page contains information on installing and running GSAS & EXPGUI
-on Macintosh OS X computers. The software has been built using OS X 10.2.6 
+on Macintosh OS X computers. The software has been built using OS X 10.2.8 
 and has been installed successfully on 10.2 and 10.3 machines. 
 
 <h2>Installation</H2>
-The following summarizes the steps needed to load prerequisite software
-as well as the GSAS/EXPGUI distribution.
-I presume that most Mac users will probably have already installed X11 and 
-FINK on their computers. I have very limited experience with this, so please 
-do not contact me for help with steps 1-3. However, 
-most OS X books can provide more details beyond what is given here.
+<IMG SRC="new.gif" HEIGHT=13 WIDTH=36 alt="New!">
+Installation has been dramatically simplified. You may still want 
+to install the development environment (XCODE) and Fink, but these are no
+longer required to install and run GSAS and EXPGUI. GSAS & EXPGUI now contains
+a copy of the Tcl/Tk package (that includes BLT), so installation of this 
+package is also now optional. 
 
 <OL>
 <P><LI>Install X11
 <DL><DL><I>
-This can be done from your OS (Jaguar or Panther) CD-ROM or can be
-downloaded from 
-<a href="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
+Before you can run the GSAS package (or, for that matter, 
+a large number of other Unix-derived graphics applications), 
+you need to load the X Windows system (X11) onto your computer. </I>
+<P>
+For 10.2 (Jaguar), this is a bit complex to explain, 
+so you will need to do some searching on the web, find a guru or 
+consult one of the many Mac OS X books that cover this subject.
+<P>
+For 10.3 (Panther), Apple bundles a version of X11 with the OS 
+and installing can be
+very simple. It can be installed directly from CD-ROM #3 of the OS X 
+distribution CD disks. To install X11, insert CDROM #3, then click on the 
+Packages folder and within that folder, click on X11User.pkg. Read the 
+installation screens, click on the "next" button a few times, and 
+X11 is installed. 
+<P>
+X11 for 10.3 can also be downloaded 
+from Apple
+(<a href="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
 http://www.apple.com/macosx/features/x11/download/"
->http://www.apple.com/macosx/features/x11/download/
-</A>. </I>
-</DL></DL>
-
-<P><LI>Install FINK
-<DL><DL><I>
-To do this, you will need to install the Development Tools, 
-which are distributed with OS X as well as the FINK package, 
-which can be downloaded from 
-<a href="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
-http://fink.sourceforge.net/"
->http://fink.sourceforge.net/
-</A>. Download the package and then double-click on it.
-</I>
-</DL></DL>
-
-
-<P><LI>Download and install required packages.
-<DL><DL><I>
-GSAS requires the "Portable Network Graphics" (libpng3) library.
-EXPGUI requires the X11 (not Aqua) version of Tcl/Tk package;  
-installation of the BLT add-on for Tcl/Tk is needed for plotting 
-from EXPGUI (for example, <A Href="liveplot.html">LIVEPLOT</A>). 
-There are many ways to install this software. 
-One way is to type in <a href="#FinkAptGet">Fink (apt-get) commands, as 
-described below.</a>
-A more "Mac-appropriate" approach is to avoid use of the command line
-completely and with a user-friendly front-end, 
-<a href="#FinkCommander">FinkCommander, also described below.</a></I>
+>http://www.apple.com/macosx/features/x11/download/</A>). 
+<P>
+If you have a PowerBook that shipped with 10.3, you may have your 
+OS X distribution on two DVDs, so you don't have CDROM #3.
+While Apple technical support does not appear to know this 
+(or at least they did not, when I called), 
+you can find the X11 package in a folder hidden on the DVD. 
+Use the finder Go/"Go to folder" (shift-command-G) menu item to open 
+hidden folder <tt>/Volumes/PowerBook Software/System</tt>
+on the first Powerbook software DVD; 
+then double-click on the <tt>Installation</tt> folder
+to open it and then open the <tt>Packages</tt> folder.
+(Yes, you could have typed 
+<tt>/Volumes/PowerBook Software/System/Installation/Packages</tt>,
+but why buy a Mac if you like to type long names?).
+Finally, double-click on the X11User.pkg file and X11 is installed.
+Just like that!
 </DL></DL>
 
@@ -84 +88 @@
 <I>Download this file from the NIST website:</I>
 <BR>
-<a href="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/osx_gsaskit.dmg">
-ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/osx_gsaskit.dmg</a> (~7 Mb)
+<a href="ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/osx_gsasexpgui.dmg">
+ftp://ftp.ncnr.nist.gov/pub/cryst/gsas/osx_gsasexpgui.dmg</a> (~13 Mb)
 <BR>
 <I>These files can also be downloaded from the CCP14 mirrors:</I>
 [(<a href="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
-http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/briantoby/pub/cryst/gsas/osx_gsaskit.dmg"
+http://www.ccp14.ac.uk/ccp/ccp14/ftp-mirror/briantoby/pub/cryst/gsas/osx_gsasexpgui.dmg"
 >UK</a>),   
 (<a href="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
-http://ccp14.sims.nrc.ca/ccp/ccp14/ftp-mirror/briantoby/pub/cryst/gsas/osx_gsaskit.dmg"
+http://ccp14.sims.nrc.ca/ccp/ccp14/ftp-mirror/briantoby/pub/cryst/gsas/osx_gsasexpgui.dmg"
 >Canada</a>), 
 (<a href="http://www.nist.gov/cgi-bin/exit_nist.cgi?
-url=http://ccp14.semo.edu/ccp/ccp14/ftp-mirror/briantoby/pub/cryst/gsas/osx_gsaskit.dmg"
+url=http://ccp14.semo.edu/ccp/ccp14/ftp-mirror/briantoby/pub/cryst/gsas/osx_gsasexpgui.dmg"
 >US</a>) or 
 (<a href="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
-http://ccp14.minerals.csiro.au/ccp/ccp14/ftp-mirror/briantoby/pub/cryst/gsas/osx_gsaskit.dmg"
+http://ccp14.minerals.csiro.au/ccp/ccp14/ftp-mirror/briantoby/pub/cryst/gsas/osx_gsasexpgui.dmg"
 >Australia</a>)].
 <P>
 
-<I>What happens when you download this file depends on your method for 
-downloading. Some browsers will automatically perform the next step for 
-you:</I>
-<P>
 Mount this file by double-clicking on it. This should create a new volume in 
 your top-level ("Computer") called "GSASvol"; clicking on this device will open
 a finder window with a single folder ("gsas") present. 
-<P>
+(<I>Note that some browsers will automatically perform this step for 
+you.</I>)
+<P>
+
 <I>While you can run GSAS & EXPGUI from this location, you are strongly 
 suggested to instead copy the entire package to your computer by dragging the 
 gsas folder icon to another finder window, or by clicking on it and using 
 Copy and Paste.</I>
-<P>
-At this point you are able to run EXPGUI using the full command name 
-from inside an X11 window -- by typing a command such as this:
-<PRE>
-     /MyApps/gsas/expgui/expgui
-</PRE>
-or
-<PRE>
-     /sw/bin/wish /MyApps/gsas/expgui/expgui
-</PRE>
-
-
-but this gets old fast -- see the following section for a better way. 
 </DL></DL>
 
 <LI>Install a "shortcut" to launch EXPGUI
 <DL><DL>
-<I>The following 
-instructions describe ways that the EXPGUI program can be integrated 
-into the Mac environment.
-</I><P>
 <IMG SRC="expgui_osx.jpg" ALT="EXPGUI AppleScript icon" ALIGN="RIGHT">
-The OSX version of GSAS & EXPGUI has an EXPGUI AppleScript application 
-in the "gsas" folder with the icon shown 
+The OS X version of GSAS & EXPGUI has an EXPGUI AppleScript application 
+named <tt>expgui.app</tt> in the gsas folder with the icon shown 
 to the right. This AppleScript will start X11, 
 if needed and then lauch EXPGUI. (If you have ideas for improving the script, 
@@ -154 +140 @@
 </UL>
 <P>
-You may find it convenient to drag the EXPGUI icon to the dock, 
+If you will use GSAS a fair amount, you will likely 
+find it convenient to drag the EXPGUI icon to the dock
 for easy access.
+<P>
 Note, that this <B><U>EXPGUI app will not 
-work correctly if copied or moved to another folder</U></B> -- instead 
-create an alias (for example using the Finder Command-L key). An alias 
-can be moved where desired -- for example, to 
+work correctly if copied or moved to another folder</U></B> it must be located 
+in the gsas folder along with all the other files and 
+subdirectories needed by GSAS & EXPGUI -- you can instead 
+create an alias (by highlighting the AppleScript icon in the Finder 
+and using the File/"Make alias" menu item or the Command-L shortcut). An alias 
+created in this fashion can be moved wherever desired -- for example, to 
 the desktop or to the Application folder.
 </DL></DL>
 
-<LI>Make a command-line "shortcut" to run EXPGUI
+<LI>For Unix power users: Make a command line shortcut (optional)
 <DL><DL>
-<I>
-If you are a "Unix enthusiast," you might be interested in setting up 
-command line short-cuts to the gsas script and the EXPGUI program; however,
-my presumption is that most people buy Mac's to avoid using the command line. 
-Those people who wish to define a command line short-cut should 
-see section 2.2 in the 
-<A Href="expgui_Unix_readme.html">Unix installation notes</A>.
-</I>
+<I>People who have not become completely enlighted to the Mac may wish to 
+set up a way to type something (gasp!) in a terminal window that will allow
+them to start EXPGUI. There are a number of ways this can be done,
+(see section 2.2 in the 
+<A Href="expgui_Unix_readme.html">Unix installation notes</A>.)
+Also, on the Mac it is possible to add applications to the X11 Applications 
+menu, by using the Applications/Customize menu option. 
+Note that the command used to start Tcl/Tk and EXPGUI will vary depending 
+on where you installed the package. I install the package in ~/Applications
+so the command string to start EXPGUI using:</I> 
+<PRE>
+          ~/Applications/gsas/ncnrpack-osx  ~/Applications/gsas/expgui/expgui
+</PRE>
 </DL></DL>
 
@@ -182 +178 @@
 EXPGUI will automatically designate the EXPGUI AppleScript 
 as the "open with" application for every GSAS experiment (.EXP) file 
-that is read or written by EXPGUI, provided that the Development Tools program 
-Rez is found in /Developer/Tools. 
-At the same, EXPGUI will also designate an icon for the .EXP file. 
-After this is done, EXPGUI can be invoked by simply double-clicking on 
-a GSAS experiment file.
+that is read or written by EXPGUI. This is done with the 
+Development Tools program Rez, found in /Developer/Tools or in the gsas folder.
+At the same time, EXPGUI will also set an icon for the .EXP file. 
+After this has been done, EXPGUI can be invoked by simply double-clicking on 
+a GSAS experiment file (.EXP file) icon.
 <P>
 If for some reason you would prefer this not be done 
@@ -204 +200 @@
 
 <HR noshade><HR noshade>
-<a name="FinkAptGet"></a><h4>Installing software from the command line</H4>
-With FINK installed, it is possible to download and install binary
-versions of the required programs by entering the following command 
-in a terminal or xterm window:</I>
-<PRE>
-     sudo apt-get install tcltk blt libpng3-shlibs
-</PRE>
-
-<HR noshade><HR noshade>
-
-<a name="FinkCommander"></a><h4>Installing software using FinkCommander</H4>
-  <p><em>A second method, which is recommended for everyone other than UNIX
-        gurus, is to use instead the &quot;FinkCommander&quot; application,
-        which is provided in a separate directory
-    (of the same name: see picture below). After installing the fink package
-        (&quot;Fink... Installer.pkg&quot;),
-     launch &quot;FinkCommander&quot;. &quot;FinkCommander&quot; 
-     which is a 
-     GUI interface for fink (that allows you to avoid having to 
-     remember these ugly-, long-, obsure and esoteric
-     UNIX-styled commands)</em>
-  <p>
-    In &quot;FinkCommander&quot;, with your computer connected to the
-    internet, simply use &quot;Update-all&quot; 
-    (in the &quot;Source&quot; menu) 
-    the first time you run &quot;FinkCommander&quot;, 
-    then be patient while Fink tabulates a list of the latest versions of 
-    all available OS X software packages.
-
-  <p>Then, in the "binary" menu, select
-      the &quot;blt&quot; package and ask to install it 
-      (from a binary distribution) using the "install" command,
-      as shown in the picture below. 
-      Since FinkCommander will automatically load the packages required by 
-      blt (dependencies), this will also cause Tcl/Tk to be loaded or
-      updated.
-      <P>
-      Repeat this step to install the &quot;libpng3&quot; library.
-      <P>
-  <table width="75%" border="1">
-    <tr>
-      <td width="55%">
-      <a href="FinKComImage2.jpg" target="_blank">
-      <img src="FinKComImage2.jpg" width="400" height="300" border="0">
-      </a></td>
-      <td width="45%"><p>The &quot;FinkCommander&quot; folder on
-            the desktop (back window) and application (front window) showing
-         the installation of the binary
-            &quot;blt&quot; package.
-        <p>(click to enlarge)</p></td>
-    </tr>
-  </table>
-  <dt></dt>
-  <p><em>Depending on which version of OS X you have, and the 
-         versions of the available binary distributions, it is possible that 
-         the above may not work. If this occurs, 
-          simply repeat the process, but this time use the install command
-          from the source menu. 
-        The will achieve the same result, but will take much longer 
-        (say 15-45 minutes) as Fink will download and compile the source codes
-        for the various packages.</em>
-
+<h4>The Tcl/Tk Starkit</H4>
+<P>
+The GSAS-EXPGUI distribution now includes a single file version of the 
+entire Tcl/Tk package, as well as a graphics package for Tcl/Tk, called
+BLT, that is used extensively within EXPGUI. The inclusion of this file
+within the package simplifies installation considerably. 
+This single 3 Mb file, 
+<tt>gsas/ncnrpack_osx</tt>, contains many other Tcl/Tk packages (that are 
+not used within EXPGUI) and may be of value for use with other applications.
+Note that the EXPGUI AppleScript will look for Tcl/Tk first as the
+<tt>ncnrpack_osx</tt> file in the same folder as where the <tt>expgui.app</tt> 
+script is located. If this <tt>ncnrpack_osx</tt> 
+file is deleted, renamed or moved, 
+then the script will look for the standard Tcl/Tk program (<tt>wish</tt>) in the
+<tt>/sw/bin</tt> directory.
 <HR noshade><HR noshade>
 
@@ -272 +221 @@
 you may have a setup problem with X-windows (X11). 
 One common reason for this is that X11 must be restarted any time 
-your computer's IP address changes. This can happen when you connect your 
-Mac to a network directly or with a modem. Your IP address can change even 
-while your computer is wired into a network. 
+your computer's hostname changes, which may be caused by starting/stopping 
+networking, dialing in for e-mail or even by a change in 
+IP address initiated by the network DHCP server, if you are hardwired into 
+a network. 
 
 If exiting and restarting X11 does not address your problem, 
@@ -282 +232 @@
 One possible problem is the definition for the X11 display (shell
 environment variable DISPLAY). 
-On my machine, this variable is set correctly in an X11 xterm window, but 
-is not set by default within an Aqua terminal window.
-<P>
-A quick test for this is to type xclock at the shell prompt:
+On my machine, this variable seems to be set correctly in X11 xterm windows, 
+but is not set by default within an Aqua terminal window unless
+you make changes to your shell startup. 
+<P>
+A quick test for X11 problems is to type xclock at the shell prompt:
 
 <PRE>
      bash-2.05a$ xclock
 </PRE>
-If you get a clock display -- great. If you get the following error message
+If you get a clock display -- great, X windows is working!
+<P>
+If you get the following error message
 the DISPLAY variable is not set: 
 <PRE>
@@ -297 +250 @@
 </PRE>
 
-If on the other hand, you get this error message, there is a problem 
-with Xwindows:
+If on the other hand, you get this error message, there is a 
+security problem with X windows:
 <PRE>
      bash-2.05a$ xclock
      Error: Can't open display: localhost:0.0
 </PRE>
-
+This will most likely be solved by exiting and restarting X11 (see above).
+<P>
 You can set the DISPLAY variable in bash/zsh, etc. using:
 <PRE>
@@ -314 +268 @@
      [d120234:~] toby% setenv DISPLAY localhost:0.0
 </PRE>
+(For info on how to do this automatically, see step 2 in 
+<a href="http://www.nist.gov/cgi-bin/exit_nist.cgi?url=
+http://www.chemistry.ucsc.edu/~wgscott/xtal/page1.html"
+>http://www.chemistry.ucsc.edu/~wgscott/xtal/page1.html</A>).
 <P><LI>
 A second possible problem relates to the installation of the 
-Tcl/Tk and BLT packages. 
-You can test if Tcl/Tk and the BLT package are installed correctly using the 
+Tcl/Tk and BLT packages. This problem seems unlikely, now that 
+the Tcl/Tk package is included in the distribution, but if you have 
+removed the ncnrpack_osx file from the gsas folder, the expgui.app AppleScript
+will try to use wish installed in /sw/bin. If you are choosing to do this,
+you can test if Tcl/Tk and the BLT package are installed correctly using the 
 following commands:
 <PRE>
@@ -338 +299 @@
   and help with this documentation was provided by 
   Francois Farges -- many thanks!
+<P>Thanks to Paul Kienzle of the 
+<a href="http://www.ncnr.nist.gov/dave/">
+NCNR DAVE project</A> for providing the "all in one file" (starkit) 
+version of Tcl/Tk for OS X.
 
 <P>GSAS is Copyright, 1984-2000, by