User Tools

Site Tools


install

Installation

This guide provides a step by step installation process, it's important and helpful to have general knowledge about Web servers, PHP and MySQL.
For those who have no technical knowledge, a new system can be a task full of complex issues. To this end, we offer specialized services and all the necessary knowledge to quickly put this software at your service, contact pHAlkaline for more details on this.
pHKapa FULL PACK comes with its own web-based installer making easy the installation process.
If you dont have the FULL PACK please goto Manual Installation.

Pre-requisites

To install pHKapa, a web server is required, Apache with “`mod_rewrite` or similar” and must have PHP 5.3 (or better) and MySQL 5.1 (or better) installed.
If you are unsure whether your server meets these requirements, please check with your host or webmaster before proceeding with the installation.
You will need one MySQL database with (`utf8_general_ci` collation) , a valid user, password and hostname handy during installation.
MySQL user must have FULL privileges on the database. If you are unsure whether you have these details or if the user has sufficient permissions, please consult your host or database admin before proceeding.

pHKapa FULL PACK Web Based Installer

To use Web Based Installer you should have downloaded the latest pHKapa FULL PACK.
If you dont have the FULL PACK please goto Manual Installation.
Uncompress and upload files and directories to a directory of your choice on your server or upload the content zip to your server, and extract the archive.
pHKapa installer needs to be able to write and modify the app/Config , app/files and app/tmp directories .

Once all of the above steps are complete, you are ready to run install in a web browser.
You can invoke the installer by simply browsing the pHKapa URL e.g http://{your-url-for-pHKapa}/install
If you dont have the FULL PACK install Plugin is not available, goto Manual Installation.

pHKapa installation script will attempt to auto-detect paths and any permission issues.
Please follow the instructions to finish up the installation process.

If the script spots any configuration errors then it will not allow you to continue until the errors are corrected.
If everything checks out, you will be presented with a form to fill in the information that pHKapa now requires.
If any errors occurs, go back and check the data entered.
On valid data the script will create and populate the database and write a configuration file.
If the setup script has finished running with no errors, then congratulations pHKapa is installed.

Important

After sucessfull instalation restore default values ( chmod 755) for app/Config directory and ( chmod 644 ) for files in app/Config directory.
app/files and app/tmp directories must remain writable.
Comment `CakePlugin::load('Install', array('bootstrap' ⇒ false, 'routes' ⇒ false));` line at app/Config/bootstrap_phapp.php.
at app/Controllers alter InstallController.php to safe name InstallController.php.savename.

Resuming

  • Upload the content to your server, Extract the archive.
  • Set app/tmp, app/files, app/Config directories and app/Config/core.php file to writable.
  • Create a new MySQL database (`utf8_general_ci` collation)
  • Goto http://{your-url-for-pHKapa}/install
  • At step 4 you set a new password to admin user.
  • restore default permition values, ( chmod 755) for app/Config directory and ( chmod 644 ) for core.php file in app/Config directory
  • app/tmp and app/files directories remains writable
  • comment `CakePlugin::load('Install', array('bootstrap' ⇒ false, 'routes' ⇒ false));` line at app/Config/bootstrap_phapp.php
  • at app/Controllers alter InstallController.php to safe name InstallController.php.savename.

Note that the installer only performs basic configuration required to get pHKapa up and running.
Check here More Settings

Composer Installation

You can install pHKapa using [Composer](https://getcomposer.org/)

Run:

php composer.phar create-project -s dev phalkaline/phkapa [phkapa_directory]

If Composer is installed globally, run:

composer create-project -s dev phalkaline/phkapa [phkapa_directory]

and Read Manual Installation

GIT and Composer Installation

run this commands

git clone https://github.com/pHAlkaline/phkapa.git

cd [phkapa directory]

composer update

and Read Manual Installation

GIT

run this commands

git clone https://github.com/pHAlkaline/phkapa.git

cd [phkapa directory]

git clone -b 2.7.3 http://github.com/cakephp/cakephp.git vendor/cakephp/cakephp

and Read Manual Installation

Manual Installation

Install

  • Download the latest version from http://phkapa.net , or using composer or git , see above.
  • Upload the content to your server, Extract the archive.
    • Set app/tmp, app/files directories to writable.
    • Create a new MySQL database (`utf8_general_ci` collation), and run these two SQL dump files in given order ( Some are translations , check the suffix in the file name ):
      • `app/Config/Schema/sql/phkapa_structure.sql`
      • `app/Config/Schema/sql/phkapa_demo_data.sql` run this only if you want demonstration data loaded
        • this file loads some users to database. For all users, the password equals username.

Edit

  • `app/Config/database.php.install`, change the details for your database connection and save as `database.php`

Secure

  • set app/tmp directory to writable
  • set app/Config/core.php file to writable
  • Comment `CakePlugin::load('Install', array('bootstrap' ⇒ false, 'routes' ⇒ false));` line at app/Config/bootstrap_phapp.php ( if not already )
  • at app/Controllers restore InstallController.php.savename to InstallController.php ( if not already )
  • run http://{your-url-for-pHKapa}/install/secure
  • restore default permition values, ( chmod 755) for app/Config directory and ( chmod 644 ) for core.php file in app/Config directory
  • app/tmp directory remains writable
  • at app/Controllers alter InstallController.php back to safe name InstallController.php.savename.
  • you admin access is username: admin , password: admin , please enter pHKapa goto profile and change admin password

After Installation

Your next step should be to fully configure your new pHKapa system for use.

install.txt · Last modified: 27/05/2018 22:10 by phalkaline