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 comes with its own web-based installer making easy the installation process.
If you dont have the web-based installer check composer, git or manual instalation.

Pre-requisites

To install pHKapa, a web server is required, Apache with “`mod_rewrite` or similar” and must have PHP 5.6 (or better) and MariaDB or 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.

Web Installer

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 installer in your web browser.
You can invoke the installer by simply browsing the pHKapa URL e.g http://{your-url-for-pHKapa}/install


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, 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.

If you dont have Web Installer please goto Manual Installation.

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.

More details

  • 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]

Use Web Installer method or Manual Installation

GIT and Composer Installation

run this commands

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

cd [phkapa directory]

composer update

Use Web Installer method or Manual Installation

GIT

run this commands

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

cd [phkapa directory]

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

cd app/Plugin

git clone -b 2.2 http://github.com/cakephp/debug_kit.git DebugKit

git clone -b 1.1.0 http://github.com/ceeram/clear_cache.git ClearCache

Use Web Installer method or Manual Installation

Manual Installation

Install

  • Download the latest version from https://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`
  • `app/Config/bootstrap_phapp.php.install`, change the settings and save as `bootstrap_phapp.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
  • comment `CakePlugin::load('Install', array('bootstrap' ⇒ false, 'routes' ⇒ false));` line at app/Config/bootstrap_phapp.php
  • 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.

Update

WARNING

When you are using a customized version pHAlkaline strongly suggest the use of a diff software, like winmerge , melddiff or similar to see code and db schema changes.

Make a full backup.

Make app/Config directory contents backup.
Make app/files directory contents and database backup.

Download Last Version.

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 installer in your web browser.
You can invoke the installer by simply browsing the pHKapa URL e.g http://{your-url-for-pHKapa}/install


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, 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.

If you dont have Web Installer please goto Manual Installation.

Restore

After fresh install you need to restore app/Config directory files.
Take very special attention to core.php and core_phapp.php , update salt and cipherSeed with your previous values. ( app/Config directory Backup )
Take very special attention to database.php, email.php, bootstrap_phapp.php and email.php files, edit and with your previous values. ( app/Config directory Backup )
Take very special attention to database schema, also look at app/Config/Schema for schema updates.
Clear cache , delete all files at app/tmp/cache subdirectories except empty file.

restore your database
restore you app/files directory with backup

install.txt · Last modified: 14/08/2022 17:25 (external edit)

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki