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
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.
10
12
Supported network interfaces
11
13
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
13
15
SRV_CONN_MODE -- to specify which one of the now available network
14
16
interfaces should be used.
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)
24
Resources for WWW, FIREWALL and STATELESS interfaces
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
42
Resources for SERVICE, WWW, FIREWALL and STATELESS interfaces
25
43
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
27
45
SRV_ENGINE_****: to compose URL of the NCBI HTTP-based dispatcher
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]
50
SRV_ENGINE_URL: [default = /Service/dispd.cgi]
51
NOTE: For old dispatcher default was /Service/nph-dispd.cgi
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:
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
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"