File README.distro.enano of Package enano

Enano CMS is a web-based content management system (CMS) that strives to 
have "less bloat and more float" than other solutions. It includes 
powerful administrative capabilities and a variety of plugins to add 
portals, forums, blogs, and other functionalities.

Once this package is installed, you have two methods to set up Enano CMS.

Method 1:

Open a web browser to http://localhost/enano/install/install.php and 
follow the instructions given to you on the pages you see to set up the 
database tables and begin working on your new CMS!

Method 2:

Enano is unique in that it provides a commandline based installation 
script, in the event you do not have access to a significantly modern 
web browser.

However, there are a few configuration items which need to be performed 
before the CMS is usable.  First, you need to establish a username 
and password to connect to your MySQL database as, and make both 
MySQL and Enano CMS aware of this.  Let's start by creating 
the database and the username / password inside MySQL first:

  # mysql
  mysql> create database enano1;
  Query OK, 1 row affected (0.00 sec)

  mysql> grant all privileges on enano1.* to enano identified by 'enano';
  Query OK, 0 rows affected (0.00 sec)

  mysql> flush privileges;
  Query OK, 0 rows affected (0.00 sec)

  mysql> exit
  Bye
  #

Under certain curcumstances, you may need to run variations of the "grant"
command:
mysql> grant all privileges on enano1.* to enano@localhost identified by 'enano';
   OR
mysql> grant all privileges on enano1.* to enano@'%' identified by 'enano';

This has created an empty database called 'enano1', created a user named 
'enano' with a password of 'enano', and given the 'enano' user total 
permission over the 'enano1' database.  Obviously, you'll want to select a
different password, and you may want to choose different database and user
names depending on your installation.  The specific values you choose are
not constrained, they just need to be consistant with what you will 
eventually configure Enano CMS to use.

Now that the database information has been set up, it is time to input that
information into Enano's CLI installer.

Run the following command as root:

# php "/usr/share/enano/install/install-cli.php"

Running the command as is will bring you into an interactive 
installation process to set up Enano CMS. 

If you wish to pre-set some of the information prior to running the 
installation, the script has a series of commandline switches that you 
can use to fill some, if not all the information need to set up Enano.

Run the following command:

# php "/usr/share/enano/install/install-cli.php" --help

The command will give you a list of switches and a short description of 
the function of each switch. 

An example command is below:

# php "/usr/share/enano/install/install-cli.php" -b "mysql" -h 
"localhost" -o "3306" -u "enano" -p "enano" -d "enano1" 

However, the true benefit of 
the commandline based installation is the ability for the installation 
to be automated.

An example script to automate the installation is below:

Example script: enano-autoinstall.php

1:	<?php
2:
3:	// Enano CMS silent install
4:
5:	$silent = true;
6:	$driver = 'mysql';
7:	$dbhost = 'localhost';
8:	$dbport = '3306';
9:	$dbuser = 'enano';
10:	$dbpasswd = 'enano';
11:	$dbname = 'enano1';
12:	$db_prefix = 'enano_';
13:	$user = 'admin';
14:	$pass = 'enanoadmin';
15:	$email = 'admin@example.com';
16:	$sitename = "Example site";
17:	$sitedesc = "Example site autoinstalled from CLI";
18:	$copyright = "(C) You. All rights reserved.";
19:	$urlscheme = 'short';
20:	$lang_id = 'eng';
21:	$start_with = 'tutorial';
22:	$scriptpath = '/enano';
23:
24:	require('/usr/share/enano/install/includes/cli-core.php');
25:
26:	?>

End example script

In just twenty-six lines, you have all aspects of Enano CMS completely 
set up. This is useful in cases of setting up clusters that will use an 
identical database, you would be able to script the complete 
installation of Enano CMS without much if any user input.

A notice about setting up Enano: Enano CMS can use either MySQL or 
PostgreSQL. However, in most cases, MySQL is sufficient for using Enano.


Whichever method you choose to install, we hope you find Enano CMS to be 
as wonderful as we did when we developed it!

~Neal Gompa
QA, Package Maintainer
Enano CMS Project