Return to documentation index

Title: Janox runtime installation

Content:

- Preamble

- Installation under WEB server

- Installing as a GTK executable

- PHP settings

Preamble

Janox package doesn't require any particular installation: all is needed is a working PHP5.x runtime.

Just place Janox Runtime folder in a place of your choice and refer to its path in Janox applications options. For referring Janox Runtime path in developed applications without using Janox Graphical Interface change main applications file:

<janox_root>/jxrnt/htdocs/<app_name>.php

to include janox.php file from its right path. For runtime configuration edit file <janox_root>/jxrnt/janox.ini.

Installation under WEB server

For installing under a WEB server first of all you need to enable PHP5 capabilities for the WEB server.

Place Janox Runtime folder where you prefer, then create a WEB server path (virtual host or virtual folder or what else your WEB server use) to have http://<somehost>/janox to lead to physical folder <janox_root>/jxrnt/htdocs/ (note that "/janox/" host can be changed to what you prefer).

Start or restart WEB server, open a WEB browser and surf to http://<somehost>/janox/index.html to verify installation and access Janox Runtime functionalities.

Installing as GTK executable

Procure to have a working PHP5-GTK installation. If you have other PHP (no GTK) installations make sure to not have misleading informations in your system PATH environment variable. Just open a command shell (CMD for Windows) and type:

<path_to_PHP-GTK>/php.exe <app_root>/htdocs/<app_name>.php

to execute application.

PHP settings

Changes to PHP settings are made by editing php.ini file. From default PHP settings only a few things need to be changed in order to make Janox correctly work but many others can be useful for matching particular needs: please refer to PHP manual for further informations.

First of all make sure to have the correct extensions path (folder where are stored PHP extensions dlls):

    extension_dir = "/bin/php5/ext/"

Needed by Janox:

    session.use_trans_sid = 1

In order to enable databases access you need to load specific PHP extensions for required database engines; SQLite engine is used by Janox as internal database, so it's always needed:

    extension = php_pdo.dll
    extension = php_sqlite.dll
    extension = php_mysql.dll (for MySql)
    extension = php_pgsql.dll (for PostgreSql)
    extension = php_mssql.dll (for MSSQL)
    ...

Next lines are optional, but can be changed for better performance:

    magic_quotes_gpc               = Off
    session.use_cookies            = 0
    allow_call_time_pass_reference = Off
    register_long_arrays           = Off
    auto_globals_jit               = Off

Other useful informations:

    upload_max_filesize = 2M
    max_execution_time  = 30
    max_input_time      = 60
    memory_limit        = 128M

Return to documentation index