This is how you install w3mir on a Unix system. Please see the file
INSTALL.w32 for install instructions for win32 systems.
INSTALLING PREREQUISITES:
The prerequisites are the perl packages libwww-perl, and MIME-Base64.
The w3mir install procedure will check for their presence and complain
if they are not there, so if you are unsure what you have you might
skip this part for now.
- Get libwww-perl from CPAN
(http://www.perl.com/CPAN/modules/by-module/WWW/). W3mir now works
with LWP 5.40 and later versions, but any version after 5.08 should
be ok (though perhaps buggy).
- Unpack it:
gzip -dc libwww-perl-*.tar.gz | tar xvBf -
- Install it. W3mir does not require the whole libwww-perl package and
all the packages that goes with it to work so you may follow these
install instructions instead of the libwww-perl install instructions
to get an easier install which will work with w3mir.
cd libwww-perl-*
Are you going to install it in the standard perl place (you need to
be the system administrator to do this)? If so:
perl Makefile.PL
If not (if you are a user):
perl Makefile.PL PREFIX=/some/dir
/some/dir could be ~ (as in your home directory).
IF you are installing an old LWP just for w3mir you can install both
the old LWP, the Base64 module and w3mir in a special PREFIX
separate from your usual install PREFIX. This ensures that w3mir will
access the older version of LWP and that other software will access
the newer version. If you do this make sure you install all of LWP,
Base64 and w3mir with the same PREFIX.
This step might produce some complaints; A standard perl
installation will typically get messages about missing these
modules: IO::Socket, NET::FTP and MD5. None of these need be
installed to run w3mir and so any error messages about these may
safely be ignored.
make
make test (robot/ua and local/http might fail, that's OK)
make install
Now libwww-perl should be installed and working.
- If you installed libwww-perl 5.40 or later you also need the URI
package (http://www.perl.com/CPAN-local/modules/by-module/URI/)
- Unpack it:
gzip -dc URI-*.tar.gz | tar xvBf -
- Install it:
cd URI-*
Then as above, either
perl Makefile.PL
or
perl Makefile.PL PREFIX=/some/dir
and then
make
make test
make install
Now URI should be installed and working.
- You also have to get the MIME-Base64 package
(http://www.perl.com/CPAN/modules/by-module/MIME/)
- Unpack it:
gzip -dc MIME-Base64-*.tar.gz | tar xvBf -
- Install it:
cd MIME-Base64-*
Then, as above, either
perl Makefile.PL
or
perl Makefile.PL PREFIX=/some/dir
Continue:
make
make test (it should print 'All tests successful.')
make install
Now MIME-Base64 should be installed and working.
INSTALLING W3MIR:
- Get w3mir (http://www.math.uio.no/~janl/w3mir/ or from CPAN)
- Unpack it:
gzip -dc w3mir-*.tar.gz | tar xvBf -
- Install it:
cd w3mir-*
Are you going to install it in the standard perl place? (You
probably need to be the system administrator to do this.) If so:
perl Makefile.PL
If not (if you're a user):
perl Makefile.PL PREFIX=/some/dir
/some/dir could be ~ (as in your home directory).
then
make
make install
w3mir should now be installed correctly. And if it's installed in
your path you can even run it. If you use csh or tcsh you want to run
'rehash' before the shell will find it.
2000/01/15 - Nicolai Langfeldt