Weblog 1.6

Installation Overview

Requirements

You should have at least Perl 5.006 installed. Weblog also requires a number of Perl modules that are all available on CPAN. For more information on cpan, visit http://www.cpan.org. The distribution also includes a script that will automatically install the modules from CPAN for you. Run install_modules.sh which is contained in the tools/ subdirectory. The required modules are:

CGI
CGI::Carp
XML::RSS
XML::Simple
HTML::Template
HTML::Entities

WAP Output Configuration

Your Web server must be configured to handle WML files. You need to add the following lines to your server's MIME types file:

application/vnd.wap.wmlc        wmlc
application/vnd.wap.wmlscriptc  wmlsc
text/vnd.wap.wml                wml
text/vnd.wap.wmlscript          wmls

Apache, for example, uses either /etc/mime.types or /etc/httpd/conf/mime.types typically. You can usually add MIME types to your server's configuration directly as well. If you do not have access to make this change, ask the server administrator for help. If you cannot get this change made, users will not be able to view the WML output for WAP phones.

You should also configure your Web server to look for an index.wml file in directories. In Apache, this configuration might look like the following:

DirectoryIndex index.html index.htm default.htm index.shtml index.cgi index.wml</para>

This line should already exist in your httpd.conf file, so you'll simply want to add index.wml to the end.

Manual Installation

Weblog will work in almost any *nix environment. It will also work in a shared Web environment, whether that's a user directory or virtual Web server. Root access is desirable but not necessary for installation. You should have a good knowledge of Unix and installing Web applications though. If you don't know what you're doing, you should get some help from a Unix guru or your systems administrator. If you do not have root access, you will need to follow the Alternate Installation later in the tutorial.