Pre-Requisite

To install Apprain, the below arrangement is required.

  • A web server, preferably Apache
  • PHP latest version
  • A database, preferably MySQL, with the below information
    • Host Name
    • Database name
    • Database user name
    • Data User Password
    • Database port

Installation process

Follow the below steps to complete the installation process.

  • Download the latest version of Apprain (download).
  • Extract files in the root or any subdirectory of the web server.
  • Browse the extracted directory through any web browser.
  • Now follow the steps:
    • Step 1: Check the requirements and click next.
    • Step 2: Check the environment and add write permission if required, then click next.
    • Step 3: Enter database information and click next.
    • Step 4: Check the message and click next.
    • Step 5: Enter basic information and click continue.
  • Done

Click here to see the detailed step-by-step process.

Configure Manually

Database configuration is one of the first things the system searches for when it boots up. If more than one domain is linked to a single installation, the boot request may be domain-specific or it may be a generic request for a single system. The database is the main component of the setup that needs to be addressed first.

Apprain keeps most of its configuration in the below location.

development/definition

The database.xml file is always present in installations that already exist; if not, make a new file with the same name and open it in a text editor. Although this file may have more than one connection, we will now only be concentrating on the primary connection.

See the XML file below, which has the default database "primary" inside the node. To finish the setting, enter all required information.

<?xml version="1.0" encoding="utf-8"?> <database> <base> <date><![CDATA[17/02/2024]]></date> </base> <connections> <connection> <cname>primary</cname> <driver><![CDATA[pdo]]></driver> <port><![CDATA[3306]]></port> <type><![CDATA[mysql]]></type> <charset><![CDATA[utf8]]></charset> <prefix><![CDATA[app_]]></prefix> <host><![CDATA[localhost]]></host> <dbname><![CDATA[test_database]]></dbname> <username><![CDATA[test_db_user]]></username> <password><![CDATA[test_db_password]]></password> <active>1</active> </connection> </connections> </database>

For a standard installation change below information

TagDescription
port Enter the database port.
type Enter database type.
prefix Database table prefix.
host Database host name or IP address.
dbname Database name.
username Database user name.
password Database user password.
active Set 1 to activate the connection and 0 to disable it.

Once the modification is made, the system will be accessible by browsing the specified location within the web server directory.

Note: There are significant customizations available in databases connection creation and developing drivers to support any type of database which will be discussed in later sections.