The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Miril::Example - How to install and run the sample website provided with Miril.

ABOUT

Miril comes bundled with a sample website so that you can quickly test what it can do for you. It also provides a nice starting point for you to cusomize instead of starting from scratch. The website is located in the "example" folder in the Miril distribution.

INSTALLATION

Create the output directory

First you need to decide where Miril will put the files it creates. Let us put create a directory called "miril_example" in the document root of your webserver, so that your website will be accessible at "http://localhost/miril_example". Copy all the files from the "examples/www" directory into the newly-created "miril_example" directory.

Adjust the settings

Next, you need to decide where Miril's configuration settings and other files that Miril uses internally will be stored. Create another directory, called "miril_settings" in a location that is not under the document root of your webserver, so that they are not accessible to prying eyes. Copy all the files and folders from "examples/settings" into this new directory.

Now open the file "miril_settings/cfg/config.xml" and make sure all paths correspond to your setup. Consult Miril::Manual if necessary. Also, make sure to the change the "secret" setting to something other than the default.

Install the cgi script

Copy the file "examples/cgi-bin/miril.pl" into the cgi-bin directory of your webserver. Change the shebang line to match the path to perl on your system, and change the "cfg_file" parameter to match the path to your "config.xml" file.

Run

You are now ready to run Miril. Open your browser and point to http://localhost/cgi-bin/miril.pl. You should see a welcome screen with a login prompt. The default username is "admin" and the password is "123456". Needless to say, you need to change this password as soon as possible if you are going to use Miril in a production environment.

SEE ALSO

Miril::Manual