Troubleshooting
Learn how to solve common problems.
- 1. Problems during installation of a website
- 2. Problems after installation of a website
- 3. Problems with web server
- 4. Problems with mail server
- 5. Problems with extensions
Problems during installation of a website
The following error messages can happen:
Datenstrom Yellow requires PHP 7.0 or higher
Install the current PHP version on your web server. You need PHP 7.0 or higher. On Linux it's best to use the package management of your Linux distribution, for Mac there is MAMP, for Windows there is XAMPP. It's recommended to use the latest PHP version. As soon as the website finds the required PHP version, the problem should be resolved.
Datenstrom Yellow requires PHP xxx extension
Install the missing PHP extension on your web server. You need curl gd mbstring zip. Please keep in mind that the web server and the command line may use different PHP versions. It's recommended to use the same PHP version. As soon as the website finds the required PHP extensions, the problem should be resolved.
Datenstrom Yellow requires rewrite rules
Check the configuration of your web server. The web server requires additional URL rewrite rules, but this depends very much on the web server and operating system you use. It's best to contact your web hosting provider. As soon as the web server forwards HTTP requests to the yellow.php, the problem should be resolved.
Datenstrom Yellow requires write access
Execute the command chmod -R a+rw * in the installation folder. You can also use your FTP application to give write permissions to all files. It's recommended to give write permissions to all files and folders in the installation folder. As soon as the website has sufficient write access in the system folder, the problem should be resolved.
Datenstrom Yellow requires htaccess file
Copy the supplied .htaccess file into the installation folder. Check if your FTP application has a setting to show all files. It sometimes happens that the .htaccess file was overlooked during installation. As soon as the missing configuration file has been copied into the installation folder, the problem should be resolved.
Datenstrom Yellow requires complete upload
Copy again all of the supplied files into the installation folder. Check if your FTP application shows an error message during upload. It sometimes happens that the data transfer was interrupted during upload. After all files have been copied into the installation folder, the problem should be resolved.
Problems after installation of a website
The following error messages can happen:
Datenstrom Yellow stopped with fatal error
The software has crashed. Activate the debug mode for more information. Contact the webmaster if this error message is displayed continuously. Very likely an extension is not working properly or is not up to date. As soon as the relevant extension has been updated or removed, the problem should be resolved.
Can't connect to the update server
The software update is currently not possible. This error message usually means that there is no internet connection or that the internet access is blocked on your web server. If you have a web server with SSH access, you can check this yourself. Execute the command curl https://datenstrom.se on the web server.
Can't generate static page
The page in question is not supported in a static website. There are some technical limitations to what the static generator can do, for example the static generator can't generate a contact form. Any page could theoretically be generated as a static page, but then you would need additional services to handle dynamic HTTP requests.
Can't send email message
The mail server can not send the message. Contact the webmaster if this error message is displayed continuously. You may have to configure the email for outgoing messages, so that the email address contains your domain name. Sometimes the default email address doesn't work or the mail server is miss-configured.
Problems with web server
You need a web server that forwards HTTP requests to Datenstrom Yellow. It's best to contact your web hosting provider and have them check the configuration of your web server. The web server has to do three things. First it has to forward requests for non existing files/folders to the yellow.php. Second it has to block direct access to the content folder with an error page. Third it has to block direct access to the system folder with an error page. See examples for common web servers.
Problems with mail server
You need a mail server to send emails. It's best to contact your web hosting provider and ask if sendmail is enabled. When you have confirmed that sendmail is enabled, your next option is to configure the email for outgoing messages. Open file system/extensions/yellow-system.ini and change From. Configure an email address with your domain name, for example noreply@example.com. Sometimes the default email address doesn't work or the mail server is miss-configured. Learn more about system settings.
Problems with extensions
You can use the debug mode to investigate the cause of a problem or if you are curious about how Datenstrom Yellow works. To activate the debug mode on your website open file system/extensions/yellow-system.ini and change CoreDebugMode: 1. Additional information will be displayed on the screen and in the browser console. Depending on the debug mode, more or less information are shown. Learn more about debugging.
Do you have questions? Get help.