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