ONA has a simple set of requirements to run. I will describe them each briefly here.
You will need a web server to service the page. Apache was the web server used to do the development and testing.
You will need a database to store the data. MySQL was the database used to develop and test with. We use the ADODB
PHP database abstraction layer so using Postgres or Oracle should not be an issue although we have not tested with those backends.
You will need a
PHP interpreter. ONA was written in the
PHP language. Currently
PHP version 4 or newer is required.
In addition to
PHP, you will need at least one
PHP database module that may or may not be part of your distributions main install. You can check that they exist by issuing the command
php -m |grep mysql
You will see a list of the installed modules and something like “mysql” should be in the list.
You will also need the php mbstring module. Check php -m for its existence. usually an install of the “php-mbstring” package is all that is needed.
While we are using the database abstraction system ADODB, the database creation scripts are all based off of MySQL . So for the time being, MySQL is the only truly supported database.
Although it is not a requirement, you can use an accelerator such as
eAccelerator
Apparently there were some recent changes as of mysql 5.5 that use the word ENGINE instead of TYPE in the
SQL syntax of defining a new table. I have yet to fix the installer to deal with this but in the mean time, you can do the following to fix up the xml definition:
sed "s/TYPE=/ENGINE=/g" /opt/ona/install/ona-table_schema.xml > /tmp/ona-table_schema.xml; cp /tmp/ona-table_schema.xml /opt/ona/install/ona-table_schema.xml
-
Issue the command ”tar -C /opt -zxvf ona-vX.X.X.tar.gz” to extract the archive into the /opt directory. You can leave off, or change, the ”-C /opt” part if you wish to extract it elsewhere.
Add a symlink in your web server root that points ona → /opt/ona/www. An example would be:
ln -s /opt/ona/www /var/www/ona assuming your apache root is /var/www. An alternative to a symlink could be to add something like the following to your apache configuration:
Alias /ona "/opt/ona/www/"
<Directory "/opt/ona/www/">
Options Indexes MultiViews FollowSymLinks
AllowOverride All
Order allow,deny
allow from all
</Directory>
touch /var/log/ona.log. This is the default location for the ONA system log.
chown www-data /opt/ona/www/local/config /var/log/ona.log (or whatever your web server user is)
Point your broswer to
http://localhost/ona (replace localhost with your server name if needed) and follow the install steps
Upgrades should automatically be detected and performed. As usual MAKE A BACKUP FIRST! Its likely that I screwed something up and your data will be ground into a fine dust. Currently the autoupgrade of database elements only works when using a MySQL database.
Quick steps for upgrade:
tar -C /opt -zxvf ona-vX.X.X.tar.gz Or change -C /opt to wherever your installed it to on your system
chown www-data /opt/ona/www/local/config (or whatever your web server user is)
-
After the license info you will be informed that an upgrade will occur. Select ok to the upgrade (after your backups n stuff)
If there is any new database updates they should be applied and you should see a note about the upgrade_index being updated as well as version numbers.
Once in, should see the latest version number displayed on the dashboard.
There are a hand full of configuration options. A user with the 'advanced' level of security can adjust these values via the 'Manage system config' option in the Admin menu.
Depending on the plugins you have installed, you may find other options available in this menu for those options.
Proceed to the Getting Started section
