forked from ESGF/esgf-node-manager
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathHOWTO
155 lines (99 loc) · 4.93 KB
/
HOWTO
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
Hello,
The following describes how to get started with installing the ESGF
Data Node. The installation scripts may be in flux, as we
continuously improve the process. Please provide us with your input
regarding your installation experience.
The bootstrap script can be fetched from our website at:
http://rainbow.llnl.gov/dist/esgf-installer/esg-bootstrap
Follow the instructions below describing how to run the bootstrap script.
The bootstrap and install scripts is written in bash and is intended to
be run on CentOS/RedHat Linux distributions as *root* or a root
effective user via "sudo -s" (IMPORTANT: Do not run scripts directly
with sudo. Straight sudo filters out needed environment variables!).
I suggest taking all the defaults presented and reading and following
the script's suggestions.
To help manage your expectations of the installation process, the
following should give you a ballpark idea:
The entire process takes approximately, a bit under, an hour. There
are about a 20 prompts for user input - almost all of which have
resonable defaults (you can just hit enter - recommended). The lion's
share of the time is spent building the various tools and executibles
(heads up: globus and python take a relatively long time to build :-\).
We have worked hard to make the installation of the Data Node rather
painless.
Thank you for your participation!
*************
Instructions:
*************
- Before you do any installation REGISTER (get an account) at the
idp node you intend to connect to:
(ESGF-PCMDI-9) http://pcmdi9.llnl.gov/esgf-web-fe/createAccount
- Be sure the machine you are installing on is a CentOS/Redhat linux
family distribution.
- Be sure the machine has a fully qualified hostname and responds to
hostname -s, hostname --domain and hostname --fqdn.
- The machine must have all development headers installed.
- The installation user must have root (or sudo) privileges.
0) We recommend creating a separate installation user account (Ex:
esg-user) and give that user the ability to use sudo (i.e. create
an appropriate entry in /etc/sudoers).
1) LOGIN as the installation user
2) From the installation user become root or root equiv....
% sudo -s
(use -s : do not run the script directly from sudo because sudo filters env vars)
3) Download the "bootstrap" script to /usr/local/bin on the target machine
% cd /usr/local/bin
% wget -O esg-bootstrap http://198.128.245.140/dist/esgf-installer/esg-bootstrap
4) MAKE SURE YOU MANUALLY CHECK THE MD5 CHECKSUM!
(We don't want to run just any ol' script as root!!! :-)
% diff <(md5sum esg-bootstrap | tr -s " " | cut -d " " -f 1) <(curl -s http://198.128.245.140/dist/esgf-installer/esg-bootstrap.md5 | tr -s " " | cut -d " " -f 1)
(there should be NO difference! i.e. the command returns you back to your prompt)
Besides the manual check the script is "self verifying".
If the script has been tampered with in any way, it will indicate
this and NOT RUN. At which point you must fetch the file from the
distribution site again. - step 3
5) % chmod 555 esg-bootstrap
You only need to run esg-bootstrap initially to get the supporting
install scripts. You may also run it in the future to subsequently
to get the latest revisions of install scripts.
6) Fetch the latest node installation script
(MD5 verification is done within the scripts from now on, so make
sure it always says "[VERIFIED]" after a file is fetched)
% esg-bootstrap node
7) Run the installation script (read prompts and instructions carefully...)
Note on prompts...
[y/N] means "N" is the default, you may just hit return
Default values appear in "[]" brackets, hitting return uses them.
% esg-node --install (--verify)
With the --verify flag verification tests are run throughout the
installation procedure. Also the last verification step of the
installation will perform a test publish to the chosen index node.
(default: ESGF-PCMDI-9)
After the initial installation you may subsequently perform test
publications independently by using the --test-pub flag.
% esg-node --test-pub
8) Join the appropriate mailing list...
End Users : [email protected]
Developers: [email protected]
Send an email to [email protected] with the BODY:
subscribe <list-name>
Ex:
subscribe esgf-user
and/or
subscribe esgf-devel
9) Subscribe to the ESGF Blog
Keep in the loop with the ESGF.org effort!
RSS: http://esgf.wordpress.com/feed/
:-)
********
Note:
Errant key strokes are picked up, so please be careful.
As mentioned the script is in bash, so if you are so inclined, feel
free to read it! However, do not modify the script, that would void
the support contract :-).
If you have any questions... contact me - Gavin ([email protected]), or Bob
or Dean. Also post to the appropriate mailing list.
My number is +1-925-422-7436.
Enjoy!
-ESGF Data Node Team
;-)