home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / perl502b.zip / ext / DPI / DPID20 / README < prev   
Text File  |  1995-09-26  |  5KB  |  98 lines
  1. /*********************************************************************/
  2. /*                                                                   */
  3. /* SNMP-DPI API - SNMP Distributed Protocol Interface                */
  4. /*                Application Programming Interface                  */
  5. /*                                                                   */
  6. /* Sep 26, 1995 - Version 0.01                                       */
  7. /*                                                                   */
  8. /* Copyright    - (C) International Business Machines Corp. 1994     */
  9. /*                                                                   */
  10. /*   Permission to use, copy, modify, and distribute this software   */
  11. /*   and its documentation for any lawful purpose and without fee is */
  12. /*   hereby granted, provided that this notice be retained unaltered,*/
  13. /*   and that the names of IBM and all other contributors shall not  */
  14. /*   be used in advertising or publicity pertaining to distribution  */
  15. /*   of the software without specific written prior permission.      */
  16. /*   No contributor makes any representations about the suitability  */
  17. /*   of this software for any purpose.  It is provided "as is"       */
  18. /*   without express or implied warranty.                            */
  19. /*                                                                   */
  20. /*   IBM AND ALL OTHER CONTRIBUTORS DISCLAIM ALL WARRANTIES WITH     */
  21. /*   REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF    */
  22. /*   MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, TITLE,    */
  23. /*   AND NON-INFRINGEMENT.                                           */
  24. /*                                                                   */
  25. /*   IN NO EVENT SHALL IBM OR ANY OTHER CONTRIBUTOR BE LIABLE FOR    */
  26. /*   ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES, WHETHER IN      */
  27. /*   CONTRACT, TORT, OR OTHER FORM OF ACTION, ARISING OUT OF OR IN   */
  28. /*   CONNECTION WITH, THE USE OR PERFORMANCE OF THIS SOFTWARE.       */
  29. /*                                                                   */
  30. /*********************************************************************/
  31.  
  32. This DPI to SMUX converter proxy agent source code is provided as an example
  33. to:
  34.   * convert the DPI version 2 protocol to SMUX protocol. That is.... it
  35.     can be used, but the mapping is not complete. This can be used as a
  36.     stopgap till we possibly get native DPI 2.0 support in the SNMP agent 
  37.     on AIX.  (this is not a commitment that this will actually happen)
  38.   * illustrate a SMUX peer, and
  39.   * illustrate how to force a program to fork and separate from the tty
  40.     so that it runs in the background forever.
  41.  
  42. The DPI to SMUX proxy agent, dpid2, converts the DPI version 2 protocol to 
  43. the SMUX protocol.  When the dpidi2 daemon is running, DPI peers, or subagents,
  44. communicate with dpid2 via the DPI protocol.  The dpid daemon converts the
  45. information into the SMUX protocol and interfaces with snmpd.  Thus, snmpd
  46. only knows about the dpid SMUX peer.  snmpd does not know about the DPI
  47. peers that are communicating with dpid.
  48.  
  49. The dpid2 executable must be compiled as only the source code is provided.
  50. A Makefile has been provided and is ready to use "as is".   This Makefile is
  51. shipped in the file, /usr/lpp/snmpd/dpi/dpid2/Makefile.  To compile the dpid2
  52. DPI to SMUX protocol converter executable, at the shell prompt enter:
  53.   make
  54.  
  55. The dpid SMUX peer must run as root user.  It may be easiest to have it
  56. set-uid root:
  57.   su
  58.   Password:
  59.   chown root dpid2
  60.   chmod u+s dpid2
  61.         
  62. Before you execute the dpid2 daemon, you will need to update the 
  63. /etc/snmpd.peers files by adding the following entry for dpid:
  64. "dpid2"       1.3.6.1.4.1.2.3.1.2.2.1.1.2       "dpid_password"
  65.  
  66. You will also need to update the /etc/snmpd.conf file by adding a smux entry 
  67. for dpid:
  68. smux        1.3.6.1.4.1.2.3.1.2.2.1.1.2     dpid_password     #dpid
  69.  
  70. Refresh snmpd so that it will reread the /etc/snmpd.conf file:
  71.   refresh -s snmpd
  72.  
  73. Start the dpid SMUX peer:
  74.   dpid
  75.  
  76. Using snmpinfo, walk the smux MIB tree to see that dpid has registered
  77. successfully.  The dump should also show that the dpiSMUXport subtree has
  78. been registered successfully.
  79.   /usr/sbin/snmpinfo -v -md smux
  80.  
  81. The dpid2 object id as defined above is "1.3.6.1.4.1.2.3.1.2.2.1.1.2".  
  82. The breakdown of the dotted notation is:
  83.   1  iso
  84.   3  org
  85.   6  dod
  86.   1  internet
  87.   4  private
  88.   1  enterprises
  89.   2  ibm
  90.   3  ibmAgents
  91.   1  aix
  92.   2  aixRISC6000
  93.   2  risc6000private
  94.   1  risc6000samples
  95.   1  risc6000sampleAgents
  96.   2  dpid
  97.  
  98.