UPGRADE.txt 3.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586
  1. =====================================================================
  2. === Information for upgrading from Zaptel 1.2 or 1.4 to DAHDI 2.0 ===
  3. =====================================================================
  4. Upgrading from Zaptel to DAHDI is fairly straightforward; install this
  5. package using the installation instructions, and then reconfigure and
  6. rebuild Asterisk; Asterisk 1.4 releases later than 1.4.21, and all
  7. releases of Asterisk 1.6, will automatically use DAHDI in preference
  8. to Zaptel, even if Zaptel is still installed on the system.
  9. Important notes about upgrading:
  10. * The Zaptel package, which included both kernel modules and userspace
  11. tools for configuring and managing the modules, has been split into
  12. two packages:
  13. dahdi-linux: kernel modules
  14. dahdi-tools: userspace tools
  15. In addition, there is a dahdi-linux-complete package that contains both
  16. dahdi-linux and dahdi-tools for simplified installation.
  17. Note: The dahdi-linux and dahdi-tools packages have *separate*
  18. version numbers; they will not be released 'in sync', and it is
  19. perfectly acceptable to use (for example) dahdi-tools 2.0.6 with
  20. dahdi-linux 2.0.11. The dahdi-linux-complete package version number will
  21. always include *both* of these version numbers so that you will know
  22. what is included in it.
  23. Notes about the dahdi-linux package:
  24. * The primary kernel modules have changed names; the new names are:
  25. zaptel.ko -> dahdi.ko
  26. ztd-eth.ko -> dahdi_dynamic_eth.ko
  27. ztd-loc.ko -> dahdi_dynamic_loc.ko
  28. ztdummy.ko -> dahdi_dummy.ko
  29. ztdynamic.ko -> dahdi_dynamic.ko
  30. zttranscode.ko -> dahdi_transcode.ko
  31. * The kernel modules for card drivers have *not* changed names,
  32. although the wcusb and torisa drivers are no longer included.
  33. * This package no longer includes the 'menuselect' utility for
  34. choosing which modules to build; all modules that can be built are
  35. built automatically.
  36. * It is no longer possible to select a software echo canceler at
  37. compile time to build into dahdi.ko; all four included echo
  38. cancelers (MG2, KB1, SEC and SEC2) are built as loadable modules,
  39. and if the Digium HPEC binary object file has been placed into the
  40. proper directory the HPEC module will be built as well. Any or all
  41. of these modules can be loaded at the same time, and the echo
  42. canceler to be used on the system's channels can be configured using
  43. the dahdi_cfg tool from the dahdi-tools package.
  44. Note: It is *mandatory* to configure an echo canceler for the
  45. system's channels using dahdi_cfg unless the interface cards in use
  46. have echo canceler modules available and enabled. There is *no*
  47. default software echo canceler with DAHDI.
  48. Notes about the dahdi-tools package:
  49. * Many tool names have changed:
  50. ztcfg -> dahdi_cfg
  51. ztmonitor -> dahdi_monitor
  52. ztscan -> dahdi_scan
  53. ztspeed -> dahdi_speed
  54. zttest -> dahdi_test
  55. zttool -> dahdi_tool
  56. zapconf -> dahdi_genconf (deprecates genzaptelconf)
  57. * The system configuration file has moved from /etc/zaptel.conf to
  58. /etc/dahdi/system.conf.
  59. * The dahdi_cfg tool can now be used to select an echo canceler on a
  60. channel-by-channel basis in the system configuration file; see
  61. system.conf.sample for examples of how to do this.
  62. * The configuration for XPP init_card_* scripts is done now
  63. in /etc/dahdi/xpp.conf and uses a simple syntax (example included).
  64. For PRI modules, the 'pri_protocol' setting, determines how
  65. to configure it (E1/T1).
  66. * In Astribank PRI modules, the LED behaviour represents which ports
  67. are *CLOCK MASTER* (red color) and which are *CLOCK SLAVE* (green color).
  68. Usually (but not always), this corresponds to the NT/TE settings in Asterisk.