Mainframe TWiki
This page covers installation on IBM mainframes using OS/390 or z/OS, using Unix System Services - if you have Linux running on VM, see TWikiOnLinux instead.
Related pages: TWikiOnUnix,
TWikiOnLinux,
TWikiOn
Believe it or not, TWiki works just fine running on an IBM 9672 R66 CMOS machine under OS/390 Unix System Services. The biggest problem was getting the file upload function to work (actually turned out to be modifications to
CGI.pm) I like the fact that it can run under OS/390 and that it's self contained, nothing else required. I still have some tuning issues to be worked out but I consider the performance quite acceptable.
DanaMitchell
- TWiki version: 01 SEP 2001
- Web server: IBM HTTP Server V5R2M0
- Server OS: IBM OS/390 2.9
- Web browser: MSIE 5
- Client OS: NT
--
DanaMitchell - 16 Nov 2001
copied from MainframeTWiki [ MattWilkie 18 Nov 2001 ]
Interesting to hear about this - I used to be a sysadmin for Unix on a mainframe (actually Amdahl's UTS), but have never used IBM's Unix APIs (Unix System Services) for OS/390 or VM Open Edition. Of course, you could just run Linux but that's a bit more work
--
RichardDonkin - 19 Nov 2001
OliverEichhorn also has TWiki working on OS/390, using
TWikiRelease01Feb2003 with
InternationalisationEnhancements enabled on IBM HTTP Server
V5R3 (5.3). See
RewritingUrlsWithEscapedCharsUnderOs390 for the details - there's a small code fix required due to some URL encoding problems. The current patch is tested with IE,
OperaBrowser and Lynx, but
MozillaBrowser will probably have issues when used with
I18N in this environment. In fact, Oliver had this working already using the Sept 2001 release - a case of
BeAwareOfQuietAdopters?
Users of Linux on IBM mainframes can just use
TWikiOnLinux, which is ASCII based like other Linuxes.
--
RichardDonkin - 03 Sep 2003
If anybody would like to install
TWikiRelease01Feb2003 on an IBM Mainframe, here is a little how-to-install:
I assume that
Unix System Services and the
IBM HTTPD server are installed and running.
You need to download the following Open Source Packages from the
IBM FTP-Server
and install them according the documentation that can be found at
Tools and toys page for z/OS Unix System Services
Unzip the TWiki distribution in a directory of your choice e.g.
/u/projects/twiki
.
Convert the text sources from ISO-8859-1 to IBM-1047 using
iconv
.
Modify
twiki/lib/TWiki.cfg
to reflect your installation.
Add the
PASS
and
EXEC
statements to
/etc/httpd.conf
of your webserver.
In our intranet, I use an SAF-Logon to map RACF-USERID to
WikiNames so i have a
PROTECT
entry for TWiki in
/etc/httpd.conf
.
Apply both patches listed on
RewritingUrlsWithEscapedCharsUnderOs390 (
ebcdic.patch
and the Edit URL patch) - something like
patch -i ebcdic.patch
should work (you'll need to convert the patch files to IBM-1047 using
iconv
).
There's one known issue with attachment uploads - apparently
DanaMitchell's fixes are not yet in the
CGI.pm
(
CPAN:CGI) distribution.
Finished and ready to use ....
--
OliverEichhorn - 04 Sep 2003
--
RichardDonkin - 10 Sep 2003
To any
TWikiOnMainframe users - there's a new
TWikiBetaRelease that should let users of Mozilla-based browsers work with mainframe TWiki sites that use
I18N (through
EncodeURLsWithUTF8), and avoids the user having to reconfigure the browser (for IE and Opera). Also, it would be helpful to have some mainframe people test this release since I don't have access to mainframes.
--
RichardDonkin - 23 Feb 2004
According to the change log on
CPAN:CGI version 3.02 at
http://stein.cshl.org/WWW/software/CGI/, attachment uploads should now work on EBCDIC mainframes.
--
RichardDonkin - 03 Jan 2005