Installation: Difference between revisions

Installation (view source)

Revision as of 09:48, 3 May 2023

297 bytes added , 3 May 2023

→‎macOS: explain Intel Mac versus Silicon Mac

Kay

Bureaucrats

2,684

edits

@@ Line 81: / Line 81: @@
 == macOS ==
-Become familiar with the concept and ways to run commands as "root" (administrator) - google "mac osx become root". All the installation tasks that are run in a Terminal window require root privileges, since some of the programs and their links are written to /usr/local/bin. (As an alternative that does not require root for installation, one may create a directory $HOME/bin and use that for the programs and links. That would also require modification of the $PATH, by a one-time
+Become familiar with the concept and ways to run commands as "root" (administrator) - google "mac osx become root". All the installation tasks that are run in a Terminal window require root privileges, since some of the programs and their links are written to /usr/local/bin.
+Therefore, if /usr/local/bin does not yet exist, prepare the following steps by opening the Terminal window, and then
+ sudo mkdir /usr/local/bin
+As an alternative that does not require root for installation, one may create a directory $HOME/bin and use that for the programs and links. Also, this requires modification of the $PATH, by a one-time
+ mkdir $HOME/bin
   echo 'export PATH=$PATH:$HOME/bin' >> ~/.profile
   echo 'export PATH=$PATH:$HOME/bin' >> ~/.zprofile</code>
-)
-If /usr/local/bin does not yet exist, prepare the following steps by opening the Terminal window, and then
+=== [[XDS]] package for Intel Macs ===
- sudo mkdir /usr/local/bin
-=== [[XDS]] package ===
 If you are an academic user,
@@ Line 99: / Line 101: @@
   # release root permissions:
   exit
+(If you don't have root permissions, only the curl and ln commands have to be run in $HOME/bin)
 Starting with macOS Catalina, you may also need
   sudo xattr -dr XDS-OSX_64/*
 if you get a security error popup (google "xattr com.apple.quarantine catalina").
-Then make sure that the binaries are in the search path for executables, as explained in https://xds.mr.mpg.de/html_doc/downloading.html .
+Then make sure that the binaries are in the search path for executables, as also explained in https://xds.mr.mpg.de/html_doc/downloading.html .
 If you want to process .h5 files written by Eiger detectors on a Mac with Intel CPU, use the [https://{{SERVERNAME}}/pub/mac_bin/durin-plugin.so Durin plugin for Intel Mac processors] (source code [https://github.com/DiamondLightSource/durin available]) or the [https://{{SERVERNAME}}/pub/mac_bin/dectris-neggia.so Dectris-Neggia plugin for Intel Mac processors] (source code [https://github.com/dectris/neggia available]). The latter may be faster, but does not work on data collected at Diamond Light Source. The former should in principle work for all HDF5 data. See [[Installation#other_programs:_XDS-viewer,_XDSSTAT,_XDSCC12,_XDSGUI,_XSCALE_ISOCLUSTER,_generate_XDS.INP|below]] for installation of these .so files.
@@ Line 112: / Line 114: @@
 See [[Installation#other_programs:_XDS-viewer,_XDSSTAT,_XDSCC12,_XDSGUI,_XSCALE_ISOCLUSTER,_generate_XDS.INP|below]] for installation of these .so files.
-==== considerations for a macOS machine with Apple M1 or M2 processor ====
+==== XDS package for Macs with Apple M processors ====
+The Intel Mac XDS programs also work on the Apple Silicon machines, but the libraries for e.g. reading data from Eiger detectors don't, and the native binaries are faster.
-Change the above <code>curl</code> and <code>ln</code> commands to
+Thus, change the above <code>curl</code> and <code>ln</code> commands to
   # become root (it will ask for your password):
   sudo su