=========================================================
                   TMS INSTALLATION GUIDE
=========================================================

>>> STEP 1: EXTRACT FILES
---------------------------------------------------------
Extract the package to your desired location:
Example:
    /var/www/html

Inside the extracted folder, locate the `mailread` folder.
This is the Node.js application used by TMS.

>>> STEP 2: RELOCATE `mailread` FOLDER
---------------------------------------------------------
Move the `mailread` folder OUTSIDE the main `tms` directory:
    $ mv /var/www/html/tms/mailread /var/www/html/mailread

>>> STEP 3: SET PERMISSIONS
---------------------------------------------------------
Grant read/write permissions to both folders:
    $ chmod -R 777 /var/www/html/tms
    $ chmod -R 777 /var/www/html/mailread

>>> STEP 4: CREATE SYMBOLIC LINK
---------------------------------------------------------
Link `mail_json_file` from `mailread` to `tms`:
    $ cd /var/www/html/tms
    $ ln -s "/var/www/html/mailread/mail_json_file" mail_json_file

>>> STEP 5: VIRTUAL HOST SETUP (Apache)
---------------------------------------------------------
**CentOS/RedHat/Rocky Linux:**

Edit the Apache configuration:
    $ vi /etc/httpd/conf/httpd.conf

Add the following entry:
---------------------------------------------------------
<VirtualHost *:8080>
    ServerAdmin 192.168.1.243
    DocumentRoot /var/www/html/tms
    ServerName your-domain.com

    <Directory /var/www/html/tms>
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    # Uncomment to enable logging:
    # ErrorLog ${APACHE_LOG_DIR}/tms_error.log
    # CustomLog ${APACHE_LOG_DIR}/tms_access.log combined
</VirtualHost>
---------------------------------------------------------

Ensure the port is added (around line 47):
    Listen 8080

**Check & Open Port 8080 in Firewall:**
---------------------------------------------------------
Before proceeding, make sure port 8080 is free and open.

Check if port 8080 is free:
    $ sudo netstat -tuln | grep 8080
    # or if netstat is not available:
    $ sudo ss -tuln | grep 8080

If no output is shown, the port is free.

Open port 8080 in the firewall (CentOS/RHEL):
    $ sudo firewall-cmd --zone=public --add-port=8080/tcp --permanent
    $ sudo firewall-cmd --reload

Verify:
    $ sudo firewall-cmd --list-ports

Restart Apache:
    $ sudo systemctl restart httpd

>>> STEP 6: VERIFY PHP EXTENSIONS
---------------------------------------------------------
Run the command below to check required extensions:
    $ php -m | grep -E 'imap|mbstring|gd|openssl|mysqli'

Expected Output:
    gd
    imap
    mbstring
    openssl
    mysqli

If any are missing, install them:

**CentOS:**
    $ yum install php-imap php-mbstring php-gd php-openssl php-mysqli

**Ubuntu:**
    $ apt install php-imap php-mbstring php-gd php-openssl php-mysqli

Restart Apache after installation:
    $ systemctl restart httpd

>>> STEP 7: START INSTALLATION
---------------------------------------------------------
Visit:
    http://your-domain.com:8080
    or
    http://192.168.1.243:8080

Follow the on-screen instructions to complete installation.

>>> TROUBLESHOOTING
---------------------------------------------------------
1. INSTALLATION PAGE NOT LOADING?
   - Check: tms/assets/installation_flag.txt
   - Make sure the content is: TRUE

2. CUSTOM FOLDER NAMES?
   - Update paths in: tms/api/application/config/constant.php

Example Constants:
---------------------------------------------------------
define('NODE_APP_PATH',"/path/to/mailread/mail_json_file/");
define('AUTOLOAD_APP_PATH',"/path/to/mailread/mail_json_file/");
define('AUTOLOADCORRECT_APP_PATH',"/path/to/mailread/mail_json_file/");
define('AUTOLOADERROR_APP_PATH',"/path/to/mailread/mail_json_file/");
define('NODE_ENV_PATH',"/path/to/mailread/.env");
define('LINK_FOLDER_PATH',"/path/to/tms/mail_json_file/");
define('NODE_APP_LOG_PATH',"/path/to/mailread/logs/");
---------------------------------------------------------

>>> DEFAULT LOGIN CREDENTIALS
---------------------------------------------------------
Username: admin@sansoftwares.in
Password: Admin@1806

>>> CHECK FOR UPDATES
---------------------------------------------------------
Visit: https://update.sansoftwares.com  
Download the latest version from the folder with the highest version number.

=========================================================
                 END OF INSTALLATION GUIDE
=========================================================