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


for details, see the YAML documentation on Wikipedia


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