FAQ

Update server configuration

Use the command puppet-agent to update the configuration on your server. This will affect all vHosts on this machine.

Which log files are available

Within a website, the following log files are available

~/log/access.log
each request to the website is logged here
~/log/error.log
errors within the webserver
for example files which are not found
~/log/php-error.log
errors within PHP
for example memory limits
~/log/php-mail.log
log for mails sent by PHP
~/log/php-slow.log
PHP requests which took longer than 10 seconds to process

Monitor log files

tail <filename to get the last 10 lines
tail -f <filename> to get a steady output (finish with Ctrl + C)
cat <filename> to get the whole file in one part
less <filename> to get the whole file in a search- and scrollable fashion

Show MySQL processes

open mysql
issue the SHOW PROCESSLIST; command

HTTP status codes

403 forbidden
WAF block or access denied due to ip address/user restriction
see the webserver error log for details
500 internal server error
Backend error, for example within PHP
check the application error log file (in case of PHP: ~/log/php-error.log)

Hint: For details, see the full List of HTTP status codes on Wikipedia.

Sent mails are lost

check the application level log file (in case of PHP: ~/log/php-mail.log)
check the system level log file (/var/log/mail.info, access trough Log Server only)
if applicable (*.snowflakehosting.ch servers only), check the mail relay log files (access trough Log Server only)

What does DEV, STAGE and PROD stand for?

Each website has a corresponding environment configured. See environments within the website service documentation (Website Service) for details.

YAML syntax errors

make sure your YAML file is valid

if you encounter the following error, you added invalid YAML to your configuration

$ puppet-agent
Info: Retrieving pluginfacts
Info: Retrieving plugin
Info: Loading facts
Error: Could not retrieve catalog from remote server: Error 400 on SERVER: Evaluation Error: Error while evaluating a Resource Statement, Error from DataBinding 'hiera' while looking up 'apt::always_apt_update': (<unknown>): could not find expected ':' while scanning a simple key at line 24 column 5 at modules/base/manifests/apt.pp:13:2 on node host.example.net
Warning: Not using cache on failed catalog
Error: Could not retrieve catalog; skipping run

Hint

for details, see the YAML documentation on Wikipedia

Warning

do not use online YAML validators, as you might leak private informations like passwords to 3rd parties