As you might be aware, OTRS is written in Perl. One of the benefits of Perl is the lively ecosystem that is called CPAN. On CPAN people can upload modules to achieve common functions, e.g. talking to a database using the great DBI module or using Twitter (Net::Twitter) or by using any of the many, many other modules.
The current module that OTRS uses for it’s SOAP interface is SOAP::Lite. It has one particularly nasty issue in the latest few releases, where the HTTP transport does not work if run under mod_perl. It just happens to be that most OTRS (and Bugzilla, for that matter) systems are deployed using mod_perl and SOAP::Lite. This means that if you use the latest SOAP::Lite version, the SOAP interface for OTRS is not usable. The second issue is that many of the current Linux distributions (Debian Squeeze, RHEL 6, Ubuntu 10.04 LTS) are now shipping with this broken version of SOAP::Lite.
Downgrading the module is also not the best option, because versions that don’t have this bug actually don’t work well with the latest perl. So there’s no nice way to solve the issue. There IS a patch available, which is really simple, but there is no good way to actually get it installed on your OTRS instance. That is, until now. I used the OPM format to create a patched package that you can install on your OTRS 2.4.x or 3.0.x server. Now you have an easy way to get a working SOAP interface on your OTRS system, just install the package, and you’re good. And in case the module author decides to release a fixed version of the module on CPAN, or if your distribution decides to bundle the patch, you can also easily remove the package from OTRS.
UPDATE: Since August 2011 there IS a new release of SOAP::Lite available on CPAN. Unfortunately, some Linux distributions (Debian, Ubuntu) still have not incorporated a patch in their systems, they still have broken versions, so you might still want to install the .opm package below. Fedora (and thus also Red Hat and CentOS) are supposed to ship the old SOAP::Lite version but with the fix inside. Obviously, the version number is still the same, so the OTRS CheckModules script would still complain, but the issue is gone, and that’s what counts.
Download the package here:
http://users.otrs.com/~mb/SOAP-Lite-0.714.opm
If you’re interested, here’s the bug report in RT: 58538. And if you are not trying to fix OTRS but for instance Bugzilla, you can also fetch theĀ .tar.gz of the module from CPAN, and install using ‘perl Makefile.PL, make, make test, make install’, or just install the latest version from CPAN with your favorite CPAN client.