-
Notifications
You must be signed in to change notification settings - Fork 11
/
README.install
180 lines (125 loc) · 8.26 KB
/
README.install
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
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
###### INSTALLATION NOTES #########
##### EDM Version 1-10-1zd ###########################################
The Makefile has been modified to be more native for EPICS R3.14 builds.
The modifications have been made for Linux only.
### EDM Version 1-7-0c ############################
#### Installing on Solaris 8/9/10 *********************
1. Additional software packages required:
1a. You need "zlib" for libpng (we use version 1.1.3)
-- http://www.gzip.org/zlib/
1b. You need "libpng" (we use version 1.0.9)
-- http://www.libpng.org/pub/png/libpng.html
1c. You need "giflib" (we use version 4.1.0)
-- http://prtr-13.ucsc.edu/~badger/software/libungif/giflib.shtml
note: you may have trouble getting giflib because of licensing issues
so a src distribution will be placed on the SNS FTP site
(ftp://snsftp.sns.ornl.gov/UPLOAD/controls/edm) for your convenience.
I think we should use libpng from now on.
2. Configuration for compiling
-- To build edm as an EPICS Extensions unzip/untar the distribution in
the following location: $EPICS_EXTENSIONS/src
-- We are building as an EPICS extension; so modify the files in
"$EPICS_EXTENSIONS/configure" appropriately for your site
-- Note we are using gcc-2.95.2 and GNU make version 3.79.1
-- Now go for the gusto and compile
3. Run Time Configuration/Setup
a. Define the following environment variables:
The $EPICS_EXTENSIONS/src/edm/setup directory contains an example color table, font table
and calc.list file. This directory also contains a setup.sh for Bourne shell users.
The setup.sh files sets up required environment variables and creates an initial
edmObjects and edmPvObjects file.
EDMPVOBJECTS "This is the location of a file that describes the path to EPICS
PV shared libraries"
EDMOBJECTS "This is the location of a file that describes the path to the
various EDM shared libraries"
EDMHELPFILES " Location of EDM "HELP system"
EDMFILES " Location of colors.list, fonts.list, and default.scheme files"
EDMDATAFILES " Default search path for edm screens (analogous to $EPICS_DISPLAY_PATH)
As an example here is what we set at the SNS:
-- EDMPVOBJECTS=$EPICS_EXTENSIONS/ext_pref/edm
-- EDMOBJECTS=$EPICS_EXTENSIONS/ext_pref/edm
-- EDMHELPFILES=$EPICS_EXTENSIONS/src/edm/helpFiles
-- EDMFILES=$EPICS_EXTENSIONS/ext_pref/edm
-- EDMDATAFILES=./:$IOCTOP/<system1>/opi/edl:$IOCTOP/<system2>/opi/edl
Also, we will make available the $EPICS_EXTENSIONS/ext_pref/edm as an example.
This will be tarred up as ext_pref-edm.tar on our ftp site: (ftp://snsftp.sns.ornl.gov/UPLOAD/controls/edm)
Some of the configuration steps may be discussed in the edm documentation located
in the following: $EPICS_EXTENSIONS/src/edm/doc
b. You do not need to modify LD_LIBRARY_PATH to run edm but make sure you do not
rename the $EPICS_EXTESIONS/lib/$HOST_ARCH directory. This full path name is
recorded in the build output executables and libraries and is added to the
library search directories used by the runtime linker.
#### Installing on Red Hat Linux 7.0/7.1/7.2 *********************
1. Additional software packages required:
1a. You need "Motif" (we use openMotif version 2.1.30-6 on RH 7.1)
(we use openMotif version 2.1.30-8 on RH 7.1/7.2)
-- http://www.opengroup.org/openmotif/
2a. Giflib, zlib, and libpng is part of the general Linux distribution in most cases
2. Configuration for compiling
-- To build edm as an EPICS Extensions unzip/untar the distribution in
the following location: $EPICS_EXTENSIONS/src
-- We are building as an EPICS extension; so modify the files in
"$EPICS_EXTENSIONS/configure" appropriately for your site
-- Note we are using gcc-2.96 (Linux native compiler) and GNU make version 3.79.1
-- Need to make the following softlinks in /usr/include so edm can find motif headers:
"ln -s ../X11R6/include/Xm Xm".
"ln -s ../X11R6/include/X11 X11".
Note there is already a softlink for X11
-- Now go for the gusto and compile
3. Run Time Configuration/Setup
a. Define the following environment variables:
EDMPVOBJECTS "This is the location of a file that describes the path to EPICS
PV shared libraries"
EDMOBJECTS "This is the location of a file that describes the path to the
various EDM shared libraries"
EDMHELPFILES " Location of EDM "HELP system"
EDMFILES " Location of colors.list, fonts.list, and default.scheme files"
EDMDATAFILES " Default search path for edm screens (analogous to $EPICS_DISPLAY_PATH)
As an example here is what we set at the SNS:
-- EDMPVOBJECTS=$EPICS_EXTENSIONS/ext_pref/edm
-- EDMOBJECTS=$EPICS_EXTENSIONS/ext_pref/edm
-- EDMHELPFILES=$EPICS_EXTENSIONS/src/edm/helpFiles
-- EDMFILES=$EPICS_EXTENSIONS/ext_pref/edm
-- EDMDATAFILES=./:$IOCTOP/<system1>/opi/edl:$IOCTOP/<system2>/opi/edl
Also, we will make available the $EPICS_EXTENSIONS/ext_pref/edm as an example.
This will be tarred up as ext_pref-edm.tar on our ftp site: (ftp://snsftp.sns.ornl.gov/UPLOAD/controls/edm)
Some of the configuration steps may be discussed in the edm documentation located
in the following: $EPICS_EXTENSIONS/src/edm/doc
b. Make sure you define LD_LIBRARY_PATH to include $EPICS_EXTESIONS/lib/$HOST_ARCH
#### Installing on Mac OS X 10.4.5 PowerPC *********************
1. Additional software packages required:
1a. Install Apple's developer tools including the optional X11 SDK
2a. Make sure you install X11 (Apple provides X11 as an optional installation for Mac OS X and the developer tools)
3a. You need to download and install darwin ports for other items
-- http://darwinports.opendarwin.org/
4a. Using darwin ports, install openmotif, libungif and libpng
-- sudo port install openmotif
-- sudo port install libungif
-- sudo port install libpng
2. Configuration for compiling
-- To build edm as an EPICS Extensions unzip/untar the distribution in the following location: $EPICS_EXTENSIONS/src
-- Make sure your environment variables are setup for EPICS (EPICS base, extensions, EDM, etc).
-- We are building as an EPICS extension; so modify the files in
"$EPICS_EXTENSIONS/configure" appropriately for your site (for example, you must specify EPICS_BASE_RELEASE explicitly)
-- Note we are using gcc-4.0.1 (Apple's version of the Mac OS X native compiler) and GNU make version 3.80
-- EPICS 3.14.8 is recommended. If you are using EPICS 3.14.7, you must make sure that "-Ddarwin" flag is passed to the compiler. Typically you do this by modifying the configuration file: <base>/configure/os/CONFIG.Common.darwin-ppc to append the darwin flag as such: OP_SYS_CPPFLAGS += -Ddarwin
-- Open the Terminal application and change directory to the EDM source and type "make" to build EDM
3. Run Time Configuration/Setup
a. Define the following environment variables:
EDMPVOBJECTS "This is the location of a file that describes the path to EPICS
PV shared libraries"
EDMOBJECTS "This is the location of a file that describes the path to the
various EDM shared libraries"
EDMHELPFILES " Location of EDM "HELP system"
EDMFILES " Location of colors.list, fonts.list, and default.scheme files"
EDMDATAFILES " Default search path for edm screens (analogous to $EPICS_DISPLAY_PATH)
As an example here is what we set at the SNS:
-- EDMPVOBJECTS=$EPICS_EXTENSIONS/ext_pref/edm
-- EDMOBJECTS=$EPICS_EXTENSIONS/ext_pref/edm
-- EDMHELPFILES=$EPICS_EXTENSIONS/src/edm/helpFiles
-- EDMFILES=$EPICS_EXTENSIONS/ext_pref/edm
-- EDMDATAFILES=./:$IOCTOP/<system1>/opi/edl:$IOCTOP/<system2>/opi/edl
Note: Documentation is still under construction. If you find any problems with this install
note, please send e-mail ([email protected]). I will update the README.install
Please take a look at the HTML-based edm documentation as well.
Note: Also, edm works with Red Hat 7.3