From bb1801ddb1ac3ccdf37b51f80eadf0a653bc4488 Mon Sep 17 00:00:00 2001 From: Jeff Hill Date: Thu, 21 Mar 2002 23:13:04 +0000 Subject: [PATCH] document port config --- src/ca/CAref.html | 117 +++++++++++++++++++++++++++++++--------------- 1 file changed, 79 insertions(+), 38 deletions(-) diff --git a/src/ca/CAref.html b/src/ca/CAref.html index c2acf657a..5b9f78d54 100644 --- a/src/ca/CAref.html +++ b/src/ca/CAref.html @@ -60,8 +60,8 @@ height="31" width="88">

  • CA and Wide Area Networks
  • IP Network Administration Background Information
    • +
  • IP port numbers
  • WAN Environment
    • -
  • IP port numbers
  • Disconnect Time Out Interval / Server Beacon Period
  • Configuring the Time Zone
    • @@ -189,7 +189,7 @@ files is used.

    EPICS_CA_ADDR_LIST - {N.N.N.N N.N.N.N ...} + {N.N.N.N N.N.N.N:P ...} <none> @@ -319,6 +319,44 @@ standardized facilities such as mail or file transfer. Port number between 1024 and 5000 are typically reserved for ephemeral port number assignments.

    +

    IP port numbers

    + +

    The two IP port numbers used by Channel Access may be configured. This +might occur when a site decides to set up two or more completely independent +control systems that will share the same network. For instance, a site might +set up an operational control system and a test control system on the same +network. In this situation it is desirable for the test system and the +operational system to use identical PV names without fear of collision. +Usually the best choice is to assign new port numbers to the operational +system and allow the test system to use the default CA port numbers. A site +might also configure the CA port numbers because some other facility has +already reserved the defaults.

    + + + + + + + + + + + + + + + + + + + +
    PurposeDefaultEnvironment Variable
    CA Server5064EPICS_CA_SERVER_PORT
    CA Beacons (sent to CA repeater daemon)5065EPICS_CA_REPEATER_PORT
    + +

    If a client needs to communicate with two servers that are residing at +different port numbers then an extended syntax may be used with the +EPICS_CA_ADDRESS_LIST environment variable. See WAN +Environment below.

    +

    WAN Environment

    Typically vxWorks hosts boot with routes configured for the host's subnet. @@ -388,35 +426,18 @@ broadcast addresses, but this will often be the most convenient choice.

    -

    IP port numbers

    +

    If a client needs to communicate with two servers that are residing at +different port numbers then an extended syntax may be used with the +EPICS_CA_ADDRESS_LIST environment variable. Each host name or IP address in +the EPICS_CA_ADDR_LIST may be immediately followed by a colon and an IP port +number without intervening whitespace. Entries that do not specify a port +number will default to EPICS_CA_SERVER_PORT.

    -

    The two IP port numbers used by Channel Access may be configured. This -might occur when a site decides to set up two or more completely independent -control systems that will share the same network. For instance, a site might -set up an operational control system and a test control system on the same -network. In this situation it is desirable for the test system and the -operational system to use identical PV names without fear of collision. -Usually the best choice is to assign new port numbers to the operational -system and allow the test system to use the default CA port numbers. A site -might also configure the CA port numbers because some other facility has -already reserved the defaults.

    - - - +
    + - - - - - - - - - - - - - + +
    PurposeDefaultEnvironment Variable
    CA Server5064EPICS_CA_SERVER_PORT
    CA Beacons (sent to CA repeater daemon)5065EPICS_CA_REPEATER_PORTC shellsetenv EPICS_CA_ADDR_LIST "1.2.3.255 8.9.10.255:10000"
    @@ -533,7 +554,7 @@ request transportation of large arrays.

    EPICS_CAS_BEACON_ADDR_LIST - {N.N.N.NN.N.N.N...} + {N.N.N.NN.N.N.N:P...} @@ -544,13 +565,31 @@ request transportation of large arrays.

    -

    The server must build a list of addresses to send beacons to. If -EPICS_CA_AUTO_ADDR_LIST has the value "YES" then the beacon address list will -contain at least the broadcast address of all LAN interfaces found in the -host and the destination address of all point-to-point interfaces found in -the host. If EPICS_CAS_BEACON_ADDR_LIST is defined then its contents will be -used to augment this list. Otherwise, if EPICS_CA_ADDR_LIST is define its -contents will be used to augment this list.

    +

    Readers Note: The CA server configurationn documentation is +incomplete. Also, the configuration feature set is more advanced in the new +server than in the original server which is still employed in +iocCore.

    + +

    The server configures its UDP port number from the EPICS_CAS_SERVER_PORT +environment variable if it is specified. Otherwise the EPICS_CA_SERVER_PORT +environemnt variable determines the server's UDP port number. If two servers +share the same UDP port number on the same host then both of them may not, +depending on the local IP kernel, be reachable with IP unicast (an IP address +specifying only one recipient in the client's EPICS_CA_ADDR_LIST). If +available, the server will use the same TCP port number as its UDP port +number. Otherwise, it will use an ephemeral TCP port number assigned by the +opertaing system, and clients will discover this port number via the UDP +search response. The server must build a list of addresses to send beacons +to. If EPICS_CA_AUTO_ADDR_LIST has the value "YES" then the beacon address +list will contain at least the broadcast address of all LAN interfaces found +in the host and the destination address of all point-to-point interfaces +found in the host. If EPICS_CAS_BEACON_ADDR_LIST is defined then its contents +will be used to augment this list. Individual entries in +EPICS_CAS_BEACON_ADDR_LIST may override the repeater's port number if a colun +follows the host name or IP address there. Otherwise, if EPICS_CA_ADDR_LIST +is defined, its contents will be used to augment this list, but its +individual entries will not be allowed to override the repeater's port +number.

    Function Call Interface General Guidelines

    @@ -2422,6 +2461,8 @@ and then output to the console.

    write access denied
    
-
    CVS Revision $Id$
    
+
+
    CVS Revision $Id: CAref.html,v 1.16 2001/11/20 23:33:05 jhill Exp
+$