Miril::Example - How to install and run the sample website provided with Miril.
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.
"example"
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.
"miril_example"
"http://localhost/miril_example"
"examples/www"
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.
"examples/settings"
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.
"miril_settings/cfg/config.xml"
Miril::Manual
"secret"
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.
"examples/cgi-bin/miril.pl"
cgi-bin
perl
"cfg_file"
"config.xml"
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.
To install Miril, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Miril
CPAN shell
perl -MCPAN -e shell install Miril
For more information on module installation, please visit the detailed CPAN module installation guide.