Kajona

Quick Install Guide

This document describes the installation of a new Kajona-system in a few steps.

Download

If not already done, the installation of Kajona starts with downloading the system from www.kajona.de. Therefore, you have two possibilities:

On the one hand, you can download the „all-in-one.zip“, including all necessary modules and elements needed to set up a basic-system. When choosing this way, extract the downloaded zip-archive and proceed with the step „Upload“.

On the other hand, you have the possibility to choose the modules you want to download. In this case, just download the modules and elements you want to use. After downloading those files, proceed with the step „Copying files into correct folders“.

Copying files into correct folders

This step is just needed, if the modules and elements were downloaded as single files. If you had downloaded the „all-in-one“-package, proceed with the step „Upload“.

After extracting all files, there should be a few more folders, e.g. „modul_system“, „modul_pages“ or „element_formular“.

In every folder should be the structure of a Kajona-system. Those subfolders should be copied into a common folder. Therefore, open each of the folders named above and copy all files into a common folder created before. While copying the files, your file manager may ask you whether you want to replace folders or not. You can ignore those warnings, there are just folders to be overwritten, and not files.

After finishing the copying of the elements and modules into a common folder, you should have a file structure like:

/
admin (folder)
installer (folder)

lang (folder)
portal (folder)
system (folder)
templates (folder)
.htaccess
download.php
favicon.ico
image.php
index.php
xml.php

Depending on the modules and elements you've downloaded before this structure can vary.

Now proceed with the step „Upload“.

Upload

The system is now ready to be uploaded to the webserver. In most cases, this is done by FTP or SSH. If you're going to install Kajona in your local test environment you may just use your file manager to copy the files into your webserver's document root. When all files are available through your webserver, proceed with „Setting up file-permissions“.

Setting up file-permissions

In order to complete the installation successfully, you have to set up a few file- and folder permissions. Rather the webserver needs write-permissions on the following files and folders:

• /system/config/config.php
• /portal/pics/cache
• /portal/pics/upload
• /portal/downloads
• /system/debug
• /system/dbdumps

The permissions can be set using nearly any FTP/SSH-client (hint: chmod 0777). If all permissions are set up, proceed with „Create database“.

Create database

The database to be used by Kajona has to be set up in advance. Kajona doesn't need its own database, it can be installed along with other applications into an existing database. You should note the database name, user and password.

New database often can be created by using phpMyAdmin or your webhoster's admin-panel.

Go on with „Loading the installer“.

Loading the installer

To load the installer, open >>http://www.my-domain.xy<< in your webbrowser.
If the Kajona is located in a subfolder, the path has to be extended, e.g.: >>http://www.my-domain.xy/my_subfolder<<.

At first the installer checks the correct file-permissions as described in the step „Setting up file-permissions“. In addition, the availability of some php-modules is checked.

Now you have to provide the database name, user and password as noted before.

After clicking on „write to config“, another form is being shown. Using this form, you can set up the username and password of the admin user-account of your system.

Proceed with installing the modules you want to use and in a second step install all related page elements.

As a last step, you are able to install some sample contents.

If all modules and page elements are installed, your installation of Kajona is complete.

Out of security-reasons you now should delete the /installer-folder and all including files. Go on with „The portal comes alive“.

The portal comes alive

After the installation, make a first test: Load the portal by opening the root folder of the installation in your webbrowser, e.g.

www.my-domain.xy/
or
www.my-domain.xy/my_installation/.

If you installed the module „samplecontent“, a welcome-page should be loaded. Otherwise you should at least get an error, complaining about a missing index-site.

Congratulations – Kajona was installed successfully. To change the contents of your portal, go on and „Log in at the administration“.

Log in at the administration

To log in at the administration, attach the folder „/admin“ to your portal-url:

www.my-domain.xy/admin/
or
www.my-domain.xy/my_installation/admin/.

You should now see a login-form. Provide the username and password you've chosen during the installation and log in.

Have fun using Kajona! ;-)