Center Server Administration Guide

From BlackBox Framework Wiki
Jump to: navigation, search


Server control panel

For controlling technical aspects of the server (POWER ON, POWER OFF, RESET, etc.) a web-based control panel is used.

Login at, use "Login with email-address and password (new system)"

email: <edisUser>

password: <edisPassword>

Server login

The server allows secure (ssh) logins only. From a Windows machine it is recommended to use the PuTTy tool as the ssh client.

Login at on port 22 with SSH selected.

Server reboot

Use the control panel for rebooting the server in case it shows any anomaly such as out-of memory error messages.

Then login to the server and start Redmine:

cd /var/www/redmine-2.5.2

unicorn_rails -c config/unicorn.rb -E production -D

Certificate extension

Certificates should be extended every 3 months.

sudo su

service nginx stop

~/certbot-auto certonly --standalone -d -d -d -d -d

service nginx start

For checking the web server status use:

service nginx status


MySql Database control panel

This can be used for example for creating backups of MySql databases. The administration tool is a php-based web application.

Login at

user: <mysqlUser>

password: <mysqlPassword>

Backup Files

Before running the following bash command you should copy your public key to this server in order to login without password (modify it for user/serveradress you want to use):

ssh-copy-id -i .ssh/ user@serveradress

bash command for backup of all files starting from /var/www (modify it for user/serveradress you want to use).

nohup tar -c /var/www 2>/dev/null | ssh user@serveradress "dd of=.../backup_of_var-www.tar" > result.out 2>&1 &

Cleaning up Disc Space

The servers running on the host produce a lot of log files, summing up to several gigabytes over time. Therefore it is required to check the available disc space periodically and to clean up old log files. The log files are located in /var/log. With the following commands it is easy to identify large log files, which are potential candidates for cleaning up.

cd /var/log

sudo du -had 1

If the result of 'df' and 'du' differ largely, check if there are deleted files that are still open in some program. Use the following command to get a list of such files.

lsof | grep deleted

Virtual Hosts

The web-based services provided by our server use so-called 'virtual hosts' in order to provided nice URLs such as,,, etc. For every distinct service, there exists a distinct virtual host. All virtual hosts are entered in the domain name system (DNS) on in addition to the root domain name ''. If a new service needs to be provided, a new entry in the domain name system is required and one of our web servers needs to be configured to serve this virtual host.