-
Notifications
You must be signed in to change notification settings - Fork 4
/
INSTALL.TXT
123 lines (86 loc) · 4.5 KB
/
INSTALL.TXT
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
Both pre-compiled binaries as well as the source code may be
contained in the GMMPS distribution package. Installation
instructions for both are given below.
The GMMPS users manual is available online at
https://gmmps-documentation.readthedocs.io/en/latest/index.html
1. Dependencies
=============================================================
Running GMMPS requires a standard unix-like X11 environment.
MacOS users should install XQuartz (https://www.xquartz.org/).
Users of recent Ubuntu releases should start a Xorg session.
Compiling GMMPS from sources requires a C/C++ compiler, make,
and X11 development libraries. MacOS users will need
to download Xcode from the Mac App Store and run it at least
once to install the command line tools.
GMMPS now comes with all the packages required to compile it
including Tcl/Tk and Skycat. They are installed into the
bin and lib directories of GMMPS to keep them isolated from
any other versions on your system.
The Gemini IRAF package (http://www.gemini.edu/node/11823) is
also needed to create the input object tables and, if necessary,
pseudo-images.
2. Source Code Installation Instructions
=============================================================
Unless there are known compilation issues for your operating
system you should first try to compile GMMPS from source. This
helps ensure compatibility with your system and avoids Gatekeeper
problems on macOS 10.15 (Catalina). There are known problems with
compiling GMMPS on Ubuntu 17/18, and Fedora 28. Please use the
compatible binary releases on these operating systems (see below).
Run:
tar xvfz gmmps-<version>.tgz
cd gmmps-<version>
./install.sh
Finally, put /some_path/gmmps-<version>/bin/gmmps in your path.
3. Configuring pre-compiled binaries
=============================================================
Pre-compiled versions of GMMPS are available for macOS and
a few standard flavors of Linux. The compatibility list is not
exhaustive, it only lists systems that have been tested.
======================== =============== =========================
File Compiled on Compatible With
======================== =============== =========================
gmmps-1.5.1_rh5_32.tgz CentOS 5
gmmps-1.5.1_rh6_64.tgz CentOS 6
gmmps-1.5.1_rh7_64.tgz CentOS 7 Ubuntu 17/18, Fedora 28
gmmps-1.5.1_ub16_64.tgz Ubuntu 16.04 Ubuntu 17/18
gmmps-1.5.1_macos.tgz macOS 10.13.6 macOS 10.14/10.15
======================== =============== =========================
Untar the distribution file and then run
cd /some_path/gmmps-<version>
./gmmps_config.sh
to configure the paths in the GMMPS startup script.
If you install the pre-compiled Mac binaries on macOS 10.15 (Catalina)
then the first time that you run it you will need to give each
executable component permission to run. You can do this by opening
System Preferences and selecting Security & Privacy -> General and
click on Open Anyway. Finally, click Open in the next dialog. This
has to be done multiple times. All this can be avoided by compiling
from source (see above).
If you are not able to compile or run GMMPS on a machine, then one
alternative is to run it in a compatible operating system within a
virtual machine. Gemini has one Linux virtual machine available for
running GMMPS when a local installation is not possible. Please
submit a helpdesk ticket from
https://www.gemini.edu/sciops/helpdesk/submit-general-helpdesk-request
to request a temporary account on this machine.
4. Launching GMMPS
=============================================================
Launch GMMPS directly from its installation directory:
gmmps-<version>/bin/gmmps
More conveniently, add gmmps-<version>/bin to your PATH variable:
For 'bash' add this line your .bashrc:
export PATH=$PATH:<PATH-TO-GMMPS>/gmmps-<version>/bin
For 'csh' add this line to your .cshrc:
setenv PATH ${PATH}:<PATH-TO-GMMPS>/gmmps-<version>/bin
Open a new terminal and type:
gmmps &
5. Earlier versions of GMMPS
=============================================================
Earlier version of GMMPS on your system must be renamed, or
removed from the PATH variable.
To ensure maximum compatibility and the best mask design,
Gemini Observatory will NOT accept masks that have been
designed with earlier versions of GMMPS.
GMMPS performs a version check upon startup, and will
notify you if a new version of GMMPS has become available.