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