Troubleshooting

It's highly recommended to double check if all the Appskull files are uploaded into the web sever and you've followed all the Appskull installation steps correctly. and also it's highly recommended to read this whole troubleshooting chapter before you attempt to fix errors.

Identify errors using log files

The easiest way that you can diagnose errors in Appskull is simply look into the logs directory that located in Appskull root directory. If there are any logs files exists, Then you can open them and try to identify errors and diagnose them.

Logs directory Log file Recorded errors
Identify errors by showing them

For security reasons Appskull won't show any errors by default. Instead it will throw a blank page. Because throwing errors can reveal sensitive information about your server environment and Appskull installation. That is really bad for the security. Now you know that why you get a blank page in Appskull when having an error. This behavior may good for security. But this behavior make it hard to diagnose errors.

But you can easily change this default behavior by following bellow steps:

  1. Open index.php file in the Appskull root directory.

    index php file
  2. Change application environment to development from production.

    Change application environment to development from production
  3. Save the index.php file and re-upload to the server.

  4. Now you can reload the Appskull on your web browser and see if any PHP errors throw.

The following errors can occur due to wrong server/Appskull configurations. But these errors can be easily diagnosed and fixed.

PHP errors

Due to old application servers

Some PHP errors can occur due to old PHP versions that running on your webserver. So make sure you got all the Appskull minimum server requirements. You can find those information in the installation chapter.

If you are not sure about how to check what PHP and other application server versions are running on your web server, you can run a simple phpinfo() diagnose. The phpinfo() function can be used to output a large amount of information about your PHP installation and can be used to identify installation and configuration problems. To run the function, just create a new file called phpinfo.php and place it into the root directory of your web server. Now open the file in a text editor and add the following content:

                        
                            <?php

                            phpinfo();
                        
                    

After saving the file, just point your web browser at it to view its result (i.e., open http://[server host]/phpinfo.php). You should see something like the following output. This information can also be useful for identify application server versions and other important information.

phpinfo page
Due to lack of file system permissions

Some PHP errors can occur due to lack of read write permissions for Appskull system folders. So make sure to grant appropriate file system permissions for Appskull system folders. Specially make sure logs and views directories have write permissions.

You can go to your Appskull root directory and execute sudo chmod -R 755 * or sudo chmod -R 777 * terminal command in order to grant all file system permissions to Appskull directories.

HTTP errors

Error 500 internal server error due to lack of mod rewrite support in you apache web server
Error 500 due to lack of apache mod rewrite support

In order to fix this error you can enable mod rewrite module in your apache web server or follow bellow steps:

  1. Delete .htaccess file in your Appskull root directory.

  2. Set $config['index_page'] = ''; configuration item in config.php file that located under [app_root]/app/config directory as $config['index_page'] = 'index.php';.

  3. Save index.php file and re-upload that file into the server.

HTTP ERROR 500 due to wrong database configuration values
Error 500 due to wrong database configurations values

In order to fix this error, you have to review database related configuration values in [app_root]/app/config/database.php file and make them correct.

Wrong database configuration values
Error 404 (Not found error)

Error 404 on Apache web server.

Error 404 on Apache web server

Error 404 on Nginx web server.

Error 404 on Nginx web server

This error can occur in both Apache and Nginx web servers due to incorrect $config['base_url'] configuration in [app_root]/app/config/config.php file. So be sure to review that configuration value and correct it in-order to fix this error.

Even though $config['base_url'] configuration correct, this error can occur in Nginx web server due to lack of Appskull Nginx directive rules in nginx.conf file or incorrect Appskull Nginx directive rules in nginx.conf file. In order to fix this error, you have to add or correct those Appskull Nginx directive rules in nginx.conf file. You can get more information about these Appskull Nginx directive rules from installation chapter.

Copyright © Nudasoft.