File: README

package info (click to toggle)
ecaccess 4.0.1-1
  • links: PTS
  • area: main
  • in suites: bullseye, buster, jessie, jessie-kfreebsd, sid, stretch
  • size: 11,208 kB
  • ctags: 1,084
  • sloc: perl: 2,046; makefile: 962
file content (325 lines) | stat: -rw-r--r-- 9,729 bytes parent folder | download
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
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
======================================================================
ECMWF-ECaccess version 4.0.1
======================================================================

This package provide Perl scripts for the management of files, file
transfers, jobs, ectrans associations and events at ECMWF. They can
be run by any user and on any Member State host. They use the perl
library ECMWF::ECaccess which give access to the ECMWF ECaccess Web
Services (or ECaccess API).

Running these commands requires a valid certificate. Certificates can
be created with the "ecaccess-certificate-create" command from an ECMWF
user identifier and a PASSCODE (using a security token), it generates a
certificate in ".eccert.crt" in the user's home directory.

You need to ensure the following environment variables are set with
the correct values:

http_ecaccess=gateway.meteo.ms:9080
https_ecaccess=gateway.meteo.ms:9443

(e.g. if your local ECaccess Gateway name is "gateway.meteo.ms" and
you are using the default ECaccess http/s ports 9080/9443)

If you don't define these variables then the default behaviour is to
use the ecaccess.ecmwf.int server at ECMWF.

1) INSTALLATION ON UNIX OR MAC-OS-X
2) INSTALLATION ON WINDOWS
3) TEST FAILURE
4) WHAT YOU GET
5) CREATE PACKAGE FOR DISTRIBUTION
6) IMPORTANT NOTE
7) COPYRIGHT AND LICENCE

======================================================================
1) INSTALLATION ON UNIX OR MAC-OS-X
======================================================================

A) IF YOU DON'T HAVE ROOT ACCESS
--------------------------------

First load the latest release of the local-lib package which can be
found at the following place:

http://search.cpan.org/dist/local-lib

Save the archive in one directory and then from this directory issue
the following commands:

   gunzip local-lib-<VERSION>.tar.gz
   tar -xf local-lib-<VERSION>.tar
   cd local-lib-<VERSION>
   perl Makefile.PL --bootstrap

If you have questions that you don't understand just press the Enter
key to accept the default values.

   make
   make test
   make install

Now you can run the following command:

   perl -I$HOME/perl5/lib/perl5 -Mlocal::lib

This will give you a list of environment parameters to configure in
your startupt script (e.g. ~/.bashrc or ~/.cshrc). Logout and login
again to get your new environment parameters.

Then do the following:

   perl -MCPAN -eshell
   cpan[1]> o conf init connect_to_internet_ok urllist
   cpan[1]> o conf commit
   cpan[1]> quit

Answer yes if prompted the following:

"If no urllist has been chosen yet, would you prefer CPAN.pm to connect
to the built-in default sites without asking? (yes/no)?"

Then answer to the best of your knowledge.

You can now skip the following paragraph and go directly to C).

B) IF YOU HAVE ROOT ACCESS
--------------------------

Login as <root> and go to C).

C) INSTALLATION
---------------

Please before starting the installation make sure you have OpenSSL or
SSLeay installed. If you don't have one or the other you can get OpenSSL
from the following place:

   http://www.openssl.org

(On Debian systems, you will need to install the libssl-dev package, at
least for the duration of the build. It may be removed afterwards)

To start the installation of the Webtoolkit, type the following commands
to make sure the required Perl Modules are installed (Can't locate object
method "install" errors while running these commands should be ignored):

   perl -MCPAN -e "install Class::Inspector"
   perl -MCPAN -e "install Getopt::Long"
   perl -MCPAN -e "install Pod::Usage"
   perl -MCPAN -e "install Net::HTTP"
   perl -MCPAN -e "install URI::Escape"
   perl -MCPAN -e "install Term::ReadKey"
   perl -MCPAN -e "install Term::ProgressBar"
   perl -MCPAN -e "install Term::Prompt"
   perl -MCPAN -e "install Number::Bytes::Human"
   perl -MCPAN -e "install MIME::Base64"
   perl -MCPAN -e "install Crypt::SSLeay"
   perl -MCPAN -e "install IO::Socket::INET6"
   perl -MCPAN -e "install IO::Socket::SSL"
   perl -MCPAN -e "install SOAP::Lite"

Then in order to install the ECMWF::ECaccess module, go to the
ECMWF-ECaccess directory and type the following:

   perl Makefile.PL
   make
   make test
   make install

======================================================================
2) INSTALLATION ON WINDOWS
======================================================================

Install either the StrawberryPerl or the ActivePerl software from the
following place:

http://strawberryperl.com
http://www.activestate.com

Then from a Windows Console (Cmd) issue the following
commands:

   perl -MCPAN -e "install Class::Inspector"
   perl -MCPAN -e "install Getopt::Long"
   perl -MCPAN -e "install Pod::Usage"
   perl -MCPAN -e "install Net::HTTP"
   perl -MCPAN -e "install URI::Escape"
   perl -MCPAN -e "install Term::ReadKey"
   perl -MCPAN -e "install Term::Prompt"
   perl -MCPAN -e "install Number::Bytes::Human"
   perl -MCPAN -e "install MIME::Base64"
   perl -MCPAN -e "install Crypt::SSLeay"
   perl -MCPAN -e "install IO::Socket::INET6"
   perl -MCPAN -e "install IO::Socket::SSL"
   perl -MCPAN -e "install SOAP::Lite"

Then from the ECMWF install directory:

   perl Makefile.PL
   dmake
   dmake test
   dmake install

Please note the "Term::ProgressBar" Module is not available on Windows,
therefore the "-progress" option of the ecaccess-file-get/mget and
ecaccess-file-put/mput commands can not be used.

======================================================================
4) TEST FAILURE
======================================================================

Please note that if your module fails some of its tests you can get more output
from the test routines by running:

   make TEST_VERBOSE=1 test

(for Windows replace make by dmake)

If you have any problem installing the ECMWF::ECaccess Module then please check 
the ECaccess pages at the following place:

   http://www.ecmwf.int/services/ecaccess/download

Or contact us either at calldesk@ecmwf.int or ecaccess@ecmwf.int.

======================================================================
5) WHAT YOU GET
======================================================================

After installation the following commands are available:

Certificate Management:

 - ecaccess-certificate-create
 - ecaccess-certificate-list

General Information:

 - ecaccess-cosinfo

Gateway Management:

 - ecaccess-gateway-connected
 - ecaccess-gateway-list
 - ecaccess-gateway-name

Association Management:

 - ecaccess-association-delete
 - ecaccess-association-get
 - ecaccess-association-list
 - ecaccess-association-protocol
 - ecaccess-association-put

ECtrans Management:

 - ecaccess-ectrans-delete
 - ecaccess-ectrans-list
 - ecaccess-ectrans-request
 - ecaccess-ectrans-restart

Event Management:

 - ecaccess-event-clear
 - ecaccess-event-create
 - ecaccess-event-delete
 - ecaccess-event-grant
 - ecaccess-event-list
 - ecaccess-event-send

File Management:

 - ecaccess-file-chmod
 - ecaccess-file-copy
 - ecaccess-file-delete
 - ecaccess-file-dir
 - ecaccess-file-get
 - ecaccess-file-mdelete
 - ecaccess-file-mget
 - ecaccess-file-mkdir
 - ecaccess-file-modtime
 - ecaccess-file-move
 - ecaccess-file-mput
 - ecaccess-file-put
 - ecaccess-file-rmdir
 - ecaccess-file-size

Job Management:

 - ecaccess-job-delete
 - ecaccess-job-get
 - ecaccess-job-list
 - ecaccess-job-restart
 - ecaccess-job-submit

Queue Management:

 - ecaccess-queue-list

For each command the "-help" option will give you a brief help message and
the "-man" option will give you the full documentation. In case of problem
you can also use the "-debug" option which will force a dump of the protocol
exchanges with your ECaccess Gateway.

======================================================================
5) CREATE PACKAGE FOR DISTRIBUTION
======================================================================

If you want to create a binary package of your distribution (e.g. for
ease of deployement) then you can use the "Makedistrib" script.

The required libraries to run this script are the following:

   perl -MCPAN -e "install PAR"
   perl -MCPAN -e "install PAR::Packer"
   perl -MCPAN -e "install Archive::Tar"

This will create a compressed file which can be distributed to your
users:

  ecaccess-webtoolkit-bin-4.0.0-<OS>.tar.gz

======================================================================
6) IMPORTANT NOTE
======================================================================

Only read this paragraph if you are using SOAP::Lite version 0.715. If
you don't know which version of SOAP::Lite you are using then you can
run the following command to find out:

	perl -MSOAP::Lite -e 'print "$SOAP::Lite::VERSION\n"'

SOAP::Lite version 0.715 has a bug which prevent the ECMWF library
from connecting to the ECMWF server. In order to fix this problem you
have to edit the following file (in your perl installation directory):

	SOAP/Lite.pm

And change the line 1993 from:

	die "Incorrect parameter" unless $itself =~/^\d$/;
To:

	die "Incorrect parameter" unless $itself =~ /^\d*$/;

(just adding the missing '*')

By default the file is in read only mode, so you will have to set the
permissions in order to be able to do the change:

	chmod u+w Lite.pm
	vi Lite.pm (do the update)
	chmod u-w Lite.pm

======================================================================
7) COPYRIGHT AND LICENCE
======================================================================

Copyright (C) 2011 by ECMWF (Laurent.Gougeon@ecmwf.int)

This library is free software; you can redistribute it and/or modify
it under the same terms as Perl itself, either Perl version 5.8.8 or,
at your option, any later version of Perl 5 you may have available.