~ubuntu-branches/ubuntu/precise/ncbi-tools6/precise

« back to all changes in this revision

Viewing changes to network/nsclilib/readme

  • Committer: Bazaar Package Importer
  • Author(s): Aaron M. Ucko
  • Date: 2005-03-27 12:00:15 UTC
  • mfrom: (2.1.2 hoary)
  • Revision ID: james.westby@ubuntu.com-20050327120015-embhesp32nj73p9r
Tags: 6.1.20041020-3
* Fix FTBFS under GCC 4.0 caused by inconsistent use of "static" on
  functions.  (Closes: #295110.)
* Add a watch file, now that we can.  (Upstream's layout needs version=3.)

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
  Summary on the new configuration resources for NCBI network clients
2
2
  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
3
3
      By Denis V. Vakatov NCBI/NLM/NIH (vakatov@ncbi.nlm.nih.gov)
 
4
  Modified by Anton Lavrentiev (lavr@ncbi.nlm.nih.gov) on Sep 5, 2002
4
5
 
5
6
 
6
7
Due to the recent works on the old NCBI dispatcher replacement
7
 
I introduced some new resources which affect the new NCBI network
 
8
we introduced some new resources which affect the new NCBI network
8
9
client functionality.
9
10
 
 
11
 
10
12
Supported network interfaces
11
13
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
12
14
 
13
15
SRV_CONN_MODE -- to specify which one of the now available network
14
16
                 interfaces should be used.
15
17
Value:
16
 
   DISPATCHER -- old NCBI dispatcher
17
 
   WWW        -- Web-based dispatcher in the stateful connection mode [default]
 
18
   DISPATCHER -- old NCBI dispatcher -- OBSOLETE and NO LONGER AVAILABLE!
 
19
   SERVICE    -- New NCBI service dispatcher                          [default]
 
20
   WWW        -- Web-based dispatcher in the stateful connection mode
18
21
   FIREWALL   -- just like "WWW" but the data connection goes through the NCBI
19
22
                 firewall daemon that listens at one of well-known hosts/ports
20
23
   STATELESS  -- Web-based dispatcher in the stateless connection mode
21
24
   DEBUG      -- direct client-to-server connection(bypass dispatchers)
22
25
 
23
26
 
24
 
Resources for WWW, FIREWALL and STATELESS interfaces
 
27
NOTE! NOTE! NOTE!
 
28
~~~~~~~~~~~~~~~~~
 
29
 
 
30
Default dispatcher has been changed to SERVICE. Although, this fact should
 
31
not affect most users (as dispatching is done transparently and all services
 
32
have been transferred into the new configuration), please keep in mind
 
33
that you might need to use SRV_CONN_MODE to get back to your favorite
 
34
dispatcher should you encounter a problem with the new one. New dispatcher
 
35
is fully backward compatible in the sense of "SRV*" environment variables
 
36
described below. In addition, it can be controlled by its own environment
 
37
variables, which start with prefix "CONN_". More detailed discussion on
 
38
the new dispatcher can be found at:
 
39
http://www.ncbi.nlm.nih.gov/IEB/ToolBox/CPP_DOC/tools/dispatcher/DISPD.html
 
40
 
 
41
 
 
42
Resources for SERVICE, WWW, FIREWALL and STATELESS interfaces
25
43
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
26
44
 
27
45
SRV_ENGINE_****:  to compose URL of the NCBI HTTP-based dispatcher
29
47
 
30
48
SRV_ENGINE_HOST:  [default = www.ncbi.nlm.nih.gov]
31
49
SRV_ENGINE_PORT:  [default = 80]
32
 
SRV_ENGINE_URL:   [default = /Service/nph-dispd.cgi]
33
 
 
 
50
SRV_ENGINE_URL:   [default = /Service/dispd.cgi]
 
51
                   NOTE: For old dispatcher default was /Service/nph-dispd.cgi
34
52
 
35
53
SRV_HTTP_PROXY_HOST:    [default = n/a]
36
54
SRV_HTTP_PROXY_PORT:    [default = 80]
63
81
| on your proxy firewall server to those of NCBI
64
82
| (see in http://www.ncbi.nlm.nih.gov/cpp/network/firewall.html).
65
83
| Thus the mapping on your non-transparent firewall server
66
 
| shoul look like this:
 
84
| should look like this:
67
85
68
 
| SRV_PROXY_HOST:5853    -->    130.14.22.1:5853
69
 
| SRV_PROXY_HOST:5859    -->    130.14.22.2:5859
70
 
| SRV_PROXY_HOST:5840    -->    130.14.22.8:5840
71
 
| SRV_PROXY_HOST:5810    -->    130.14.22.30:5810
72
 
| SRV_PROXY_HOST:5812    -->    130.14.22.31:5812
73
 
| SRV_PROXY_HOST:5811    -->    130.14.22.32:5811
 
86
| SRV_PROXY_HOST:5853       --> 130.14.22.1:5853  RETIRED  -- DO NOT USE!
 
87
| SRV_PROXY_HOST:5859       --> 130.14.22.2:5859  RETIRED  -- DO NOT USE!
 
88
| SRV_PROXY_HOST:5840       --> 130.14.22.8:5840  RETIRED  -- DO NOT USE!
 
89
| SRV_PROXY_HOST:5810       --> 130.14.22.30:5810 RETIRED  -- DO NOT USE!
 
90
| SRV_PROXY_HOST:5812       --> 130.14.22.31:5812 RETIRED  -- DO NOT USE!
 
91
| SRV_PROXY_HOST:5811       --> 130.14.22.32:5811 RETIRED  -- DO NOT USE!
 
92
| SRV_PROXY_HOST:5845       --> 130.14.22.12:5845 INTERNAL
 
93
| SRV_PROXY_HOST:5850..5860 --> 130.14.29.112:5850..5860
74
94
75
95
| NOTE:  It's pretty rare (if ever) when you have to use
76
96
|        "SRV_PROXY_HOST" as most of firewalls are "transparent"
169
189
a) belongs to one of NCBI subnets and
170
190
b) has "lbdaemon"(load-balance daemon) application running on it.
171
191
 
172
 
$Date: 2001/02/20 20:15:52 $
 
192
$Date: 2004/01/16 19:03:45 $