BlackBox Framework Wiki - User contributions [en]

Center Financial Management Guide

2024-09-22T08:19:11Z

Josef templ:

The BlackBox Framework Center periodically spends money for its operation. This memo describes the tasks of the financial manager and the required steps/logins.

== Domain name blackboxframework.org ==

The domain name needs to be paid annually. Initially it cost USD 12.99 per year. The last payment was € 16.59.
The next expiration date is September 14th, 2025.
An automatic extension has been set up with payment via Paypal.

Login at [http://name.com http://name.com] or [https://www.name.com https://www.name.com].

user: <dnsUser>

password: <dnsPassword>

Go to "Renew My Domains", then "My Domains list".
In the resulting list with one entry for 'blackboxframework.org' click "Renew Domain".
If the user interface has been changed, look for something similar.
Open the shopping cart and proceed with payment via PayPal.

"WhoIs Privacy" is not really required and costs additional money.
Until now we are not using this option.

== EDIS server hosting ==

EDIS server hosting is based on a KVM Plan (KVM SMART, ID kvm_47273_211705) and costs EUR 5.99 plus tax per month.
The IP address of the server is 178.209.40.72, located in Switzerland.
It runs a Debian 11 (Bullseye) 64Bit Linux operating system.

Payment method is set to PayPal.
Payment can be automated by a repeating transfer from a PayPal account.

For managing financial aspects EDIS provides a web-based client area.

Login at [https://manage.edis.at/whmcs/clientarea.php https://manage.edis.at/whmcs/clientarea.php].

email: <edisUser>

password: <edisPassword>

Note: If the treasurer changes, customer data can be updated via the client area but some fields are read only and require a change request sent via e-mail from <edisUser> to support@edis.at.

== PayPal and Gmail account ==

The center uses a PayPal account for collecting donations and for paying the fees. The name of this PayPal account is an e-mail address connected to the account. The e-mail address is a Google mail address (gmail.com) and the same user and password is used for the Edis customer account, the Paypal account, and the Gmail account. The PayPal account has been upgraded to a 'business account' (free of charge) in order to be able to create the 'Donate' button on the center's web site.

email: <edisUser>

password: <edisPassword>

Center Financial Management Guide

2023-09-18T06:01:46Z

Josef templ:

The BlackBox Framework Center periodically spends money for its operation. This memo describes the tasks of the financial manager and the required steps/logins.

== Domain name blackboxframework.org ==

The domain name needs to be paid annually. Initially it cost USD 12.99 per year. The last payment was € 17.56.
The next expiration date is September 14th, 2024.

Login at [http://name.com http://name.com] or [https://www.name.com https://www.name.com].

user: <dnsUser>

password: <dnsPassword>

Go to "Renew My Domains", then "My Domains list".
In the resulting list with one entry for 'blackboxframework.org' click "Renew Domain".
If the user interface has been changed, look for something similar.
Open the shopping cart and proceed with payment via PayPal.

"WhoIs Privacy" is not really required and costs additional money.
Until now we are not using this option.

== EDIS server hosting ==

EDIS server hosting is based on a KVM Plan (KVM SMART, ID kvm_47273_211705) and costs EUR 5.99 plus tax per month.
The IP address of the server is 178.209.40.72, located in Switzerland.
It runs a Debian 11 (Bullseye) 64Bit Linux operating system.

Payment method is set to PayPal.
Payment can be automated by a repeating transfer from a PayPal account.

For managing financial aspects EDIS provides a web-based client area.

Login at [https://manage.edis.at/whmcs/clientarea.php https://manage.edis.at/whmcs/clientarea.php].

email: <edisUser>

password: <edisPassword>

Note: If the treasurer changes, customer data can be updated via the client area but some fields are read only and require a change request sent via e-mail from <edisUser> to support@edis.at.

== PayPal and Gmail account ==

The center uses a PayPal account for collecting donations and for paying the fees. The name of this PayPal account is an e-mail address connected to the account. The e-mail address is a Google mail address (gmail.com) and the same user and password is used for the Edis customer account, the Paypal account, and the Gmail account. The PayPal account has been upgraded to a 'business account' (free of charge) in order to be able to create the 'Donate' button on the center's web site.

email: <edisUser>

password: <edisPassword>

Center Server Administration Guide

2022-10-26T07:45:50Z

Josef templ: /* Cleaning up Disc Space */

== 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 [https://manage.edis.at/whmcs/clientarea.php?action=productdetails&id=214299 https://manage.edis.at/whmcs/clientarea.php?action=productdetails&id=214299],
use Login credentials

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 blackboxframework.org 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 renew

or use the long form if you need to deal with virtual hosts explicitly:

certbot certonly --standalone -d blackboxframework.org -d forum.blackboxframework.org -d community.blackboxframework.org -d wiki.blackboxframework.org -d www.blackboxframework.org -d redmine.blackboxframework.org

then

service nginx start

For checking the web server status use:

service nginx status

exit

== 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 [http://178.209.50.165/phpmyadmin/ http://178.209.50.165/phpmyadmin/]

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/id_rsa.pub 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

For checking and trimming the systemd journal use

sudo journalctl --disk-usage

sudo journalctl --vacuum-size=10M

== Virtual Hosts ==

The web-based services on our Edis server use so-called ''virtual hosts'' in order to provide nice URLs such as
''forum.blackboxframework.org'', ''wiki.blackboxframework.org'', etc.
For every distinct service, there exists a corresponding virtual host.
All virtual hosts are entered in the domain name system (DNS) on [http://name.com name.com] in addition to
the root domain name ''blackboxframework.org''.

If a new service needs to be added, a new entry in the domain name system is required and our web server (nginx) needs to be
configured to serve this new virtual host in ''/etc/nginx/sites-enabled''. In addition, the list of virtual hosts for certificate renewal needs to be extended (see ''Certificate extension'').

After any change to the nginx configuration, a HUP signal may be sent to the nginx process in order to reload the configuration without a server restart: ''kill -HUP `cat /var/run/nginx.pid''`

Virtual Hosts served by ''nginx''
# blackboxframework.org (root domain name; content management system)
# www.blackboxframework.org (redirected to blackboxframework.org)
# forum.blackboxframework.org
# community.blackboxframework.org
# wiki.blackboxframework.org
# redmine.blackboxframework.org

All http requests are redirected to https automatically.

Center Server Administration Guide

2022-10-26T07:45:16Z

Josef templ: /* Cleaning up Disc Space */

== 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 [https://manage.edis.at/whmcs/clientarea.php?action=productdetails&id=214299 https://manage.edis.at/whmcs/clientarea.php?action=productdetails&id=214299],
use Login credentials

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 blackboxframework.org 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 renew

or use the long form if you need to deal with virtual hosts explicitly:

certbot certonly --standalone -d blackboxframework.org -d forum.blackboxframework.org -d community.blackboxframework.org -d wiki.blackboxframework.org -d www.blackboxframework.org -d redmine.blackboxframework.org

then

service nginx start

For checking the web server status use:

service nginx status

exit

== 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 [http://178.209.50.165/phpmyadmin/ http://178.209.50.165/phpmyadmin/]

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/id_rsa.pub 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

For checking and trimming the systemd journal use

journalctl --disk-usage

journalctl --vacuum-size=10M

== Virtual Hosts ==

The web-based services on our Edis server use so-called ''virtual hosts'' in order to provide nice URLs such as
''forum.blackboxframework.org'', ''wiki.blackboxframework.org'', etc.
For every distinct service, there exists a corresponding virtual host.
All virtual hosts are entered in the domain name system (DNS) on [http://name.com name.com] in addition to
the root domain name ''blackboxframework.org''.

If a new service needs to be added, a new entry in the domain name system is required and our web server (nginx) needs to be
configured to serve this new virtual host in ''/etc/nginx/sites-enabled''. In addition, the list of virtual hosts for certificate renewal needs to be extended (see ''Certificate extension'').

After any change to the nginx configuration, a HUP signal may be sent to the nginx process in order to reload the configuration without a server restart: ''kill -HUP `cat /var/run/nginx.pid''`

Virtual Hosts served by ''nginx''
# blackboxframework.org (root domain name; content management system)
# www.blackboxframework.org (redirected to blackboxframework.org)
# forum.blackboxframework.org
# community.blackboxframework.org
# wiki.blackboxframework.org
# redmine.blackboxframework.org

All http requests are redirected to https automatically.

Center Server Administration Guide

2022-10-26T07:44:44Z

Josef templ: /* Cleaning up Disc Space */

== 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 [https://manage.edis.at/whmcs/clientarea.php?action=productdetails&id=214299 https://manage.edis.at/whmcs/clientarea.php?action=productdetails&id=214299],
use Login credentials

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 blackboxframework.org 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 renew

or use the long form if you need to deal with virtual hosts explicitly:

certbot certonly --standalone -d blackboxframework.org -d forum.blackboxframework.org -d community.blackboxframework.org -d wiki.blackboxframework.org -d www.blackboxframework.org -d redmine.blackboxframework.org

then

service nginx start

For checking the web server status use:

service nginx status

exit

== 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 [http://178.209.50.165/phpmyadmin/ http://178.209.50.165/phpmyadmin/]

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/id_rsa.pub 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

For checking and trimming the systemd journal use

journalctl --disk-usage
journalctl --vacuum-size=10M

== Virtual Hosts ==

The web-based services on our Edis server use so-called ''virtual hosts'' in order to provide nice URLs such as
''forum.blackboxframework.org'', ''wiki.blackboxframework.org'', etc.
For every distinct service, there exists a corresponding virtual host.
All virtual hosts are entered in the domain name system (DNS) on [http://name.com name.com] in addition to
the root domain name ''blackboxframework.org''.

If a new service needs to be added, a new entry in the domain name system is required and our web server (nginx) needs to be
configured to serve this new virtual host in ''/etc/nginx/sites-enabled''. In addition, the list of virtual hosts for certificate renewal needs to be extended (see ''Certificate extension'').

After any change to the nginx configuration, a HUP signal may be sent to the nginx process in order to reload the configuration without a server restart: ''kill -HUP `cat /var/run/nginx.pid''`

Virtual Hosts served by ''nginx''
# blackboxframework.org (root domain name; content management system)
# www.blackboxframework.org (redirected to blackboxframework.org)
# forum.blackboxframework.org
# community.blackboxframework.org
# wiki.blackboxframework.org
# redmine.blackboxframework.org

All http requests are redirected to https automatically.

Center Server Administration Guide

2022-10-26T07:44:29Z

Josef templ: /* Cleaning up Disc Space */

== 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 [https://manage.edis.at/whmcs/clientarea.php?action=productdetails&id=214299 https://manage.edis.at/whmcs/clientarea.php?action=productdetails&id=214299],
use Login credentials

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 blackboxframework.org 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 renew

or use the long form if you need to deal with virtual hosts explicitly:

certbot certonly --standalone -d blackboxframework.org -d forum.blackboxframework.org -d community.blackboxframework.org -d wiki.blackboxframework.org -d www.blackboxframework.org -d redmine.blackboxframework.org

then

service nginx start

For checking the web server status use:

service nginx status

exit

== 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 [http://178.209.50.165/phpmyadmin/ http://178.209.50.165/phpmyadmin/]

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/id_rsa.pub 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

For checking and trimming the systemd journal use
journalctl --disk-usage
journalctl --vacuum-size=10M

== Virtual Hosts ==

The web-based services on our Edis server use so-called ''virtual hosts'' in order to provide nice URLs such as
''forum.blackboxframework.org'', ''wiki.blackboxframework.org'', etc.
For every distinct service, there exists a corresponding virtual host.
All virtual hosts are entered in the domain name system (DNS) on [http://name.com name.com] in addition to
the root domain name ''blackboxframework.org''.

If a new service needs to be added, a new entry in the domain name system is required and our web server (nginx) needs to be
configured to serve this new virtual host in ''/etc/nginx/sites-enabled''. In addition, the list of virtual hosts for certificate renewal needs to be extended (see ''Certificate extension'').

After any change to the nginx configuration, a HUP signal may be sent to the nginx process in order to reload the configuration without a server restart: ''kill -HUP `cat /var/run/nginx.pid''`

Virtual Hosts served by ''nginx''
# blackboxframework.org (root domain name; content management system)
# www.blackboxframework.org (redirected to blackboxframework.org)
# forum.blackboxframework.org
# community.blackboxframework.org
# wiki.blackboxframework.org
# redmine.blackboxframework.org

All http requests are redirected to https automatically.

Center Server Administration Guide

2022-10-26T07:40:48Z

Josef templ:

== 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 [https://manage.edis.at/whmcs/clientarea.php?action=productdetails&id=214299 https://manage.edis.at/whmcs/clientarea.php?action=productdetails&id=214299],
use Login credentials

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 blackboxframework.org 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 renew

or use the long form if you need to deal with virtual hosts explicitly:

certbot certonly --standalone -d blackboxframework.org -d forum.blackboxframework.org -d community.blackboxframework.org -d wiki.blackboxframework.org -d www.blackboxframework.org -d redmine.blackboxframework.org

then

service nginx start

For checking the web server status use:

service nginx status

exit

== 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 [http://178.209.50.165/phpmyadmin/ http://178.209.50.165/phpmyadmin/]

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/id_rsa.pub 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 on our Edis server use so-called ''virtual hosts'' in order to provide nice URLs such as
''forum.blackboxframework.org'', ''wiki.blackboxframework.org'', etc.
For every distinct service, there exists a corresponding virtual host.
All virtual hosts are entered in the domain name system (DNS) on [http://name.com name.com] in addition to
the root domain name ''blackboxframework.org''.

If a new service needs to be added, a new entry in the domain name system is required and our web server (nginx) needs to be
configured to serve this new virtual host in ''/etc/nginx/sites-enabled''. In addition, the list of virtual hosts for certificate renewal needs to be extended (see ''Certificate extension'').

After any change to the nginx configuration, a HUP signal may be sent to the nginx process in order to reload the configuration without a server restart: ''kill -HUP `cat /var/run/nginx.pid''`

Virtual Hosts served by ''nginx''
# blackboxframework.org (root domain name; content management system)
# www.blackboxframework.org (redirected to blackboxframework.org)
# forum.blackboxframework.org
# community.blackboxframework.org
# wiki.blackboxframework.org
# redmine.blackboxframework.org

All http requests are redirected to https automatically.

Center Financial Management Guide

2022-08-28T11:39:41Z

Josef templ:

The BlackBox Framework Center periodically spends money for its operation. This memo describes the tasks of the financial manager and the required steps/logins.

== Domain name blackboxframework.org ==

The domain name needs to be paid annually. Initially it cost USD 12.99 per year. The last payment was € 13.43.
The next expiration date is September 14th, 2023.

Login at [http://name.com http://name.com] or [https://www.name.com https://www.name.com].

user: <dnsUser>

password: <dnsPassword>

Go to "Renew My Domains", then "My Domains list".
In the resulting list with one entry for 'blackboxframework.org' click "Renew Domain".
If the user interface has been changed, look for something similar.
Open the shopping cart and proceed with payment via PayPal.

"WhoIs Privacy" is not really required and costs additional money.
Until now we are not using this option.

== EDIS server hosting ==

EDIS server hosting is based on a KVM Plan (KVM SMART, ID kvm_47273_211705) and costs EUR 5.99 plus tax per month.
The IP address of the server is 178.209.40.72, located in Switzerland.
It runs a Debian 11 (Bullseye) 64Bit Linux operating system.

Payment method is set to PayPal.
Payment can be automated by a repeating transfer from a PayPal account.

For managing financial aspects EDIS provides a web-based client area.

Login at [https://manage.edis.at/whmcs/clientarea.php https://manage.edis.at/whmcs/clientarea.php].

email: <edisUser>

password: <edisPassword>

Note: If the treasurer changes, customer data can be updated via the client area but some fields are read only and require a change request sent via e-mail from <edisUser> to support@edis.at.

== PayPal and Gmail account ==

The center uses a PayPal account for collecting donations and for paying the fees. The name of this PayPal account is an e-mail address connected to the account. The e-mail address is a Google mail address (gmail.com) and the same user and password is used for the Edis customer account, the Paypal account, and the Gmail account. The PayPal account has been upgraded to a 'business account' (free of charge) in order to be able to create the 'Donate' button on the center's web site.

email: <edisUser>

password: <edisPassword>

Center Financial Management Guide

2022-08-28T11:21:32Z

Josef templ:

The BlackBox Framework Center periodically spends money for its operation. This memo describes the tasks of the financial manager and the required steps/logins.

== Domain name blackboxframework.org ==

The domain name needs to be paid annually. Currently it costs USD 12.99 per year.
The next expiration date is September 14th, 2023.

Login at [http://name.com http://name.com] or [https://www.name.com https://www.name.com].

user: <dnsUser>

password: <dnsPassword>

Go to "Renew My Domains", then "My Domains list".
In the resulting list with one entry for 'blackboxframework.org' click "Renew Domain".
If the user interface has been changed, look for something similar.
Open the shopping cart and proceed with payment via PayPal.

"WhoIs Privacy" is not really required and costs additional money.
Until now we are not using this option.

== EDIS server hosting ==

EDIS server hosting is based on a KVM Plan (KVM SMART, ID kvm_47273_211705) and costs EUR 5.99 plus tax per month.
The IP address of the server is 178.209.40.72, located in Switzerland.
It runs a Debian 11 (Bullseye) 64Bit Linux operating system.

Payment method is set to PayPal.
Payment can be automated by a repeating transfer from a PayPal account.

For managing financial aspects EDIS provides a web-based client area.

Login at [https://manage.edis.at/whmcs/clientarea.php https://manage.edis.at/whmcs/clientarea.php].

email: <edisUser>

password: <edisPassword>

Note: If the treasurer changes, customer data can be updated via the client area but some fields are read only and require a change request sent via e-mail from <edisUser> to support@edis.at.

== PayPal and Gmail account ==

The center uses a PayPal account for collecting donations and for paying the fees. The name of this PayPal account is an e-mail address connected to the account. The e-mail address is a Google mail address (gmail.com) and the same user and password is used for the Edis customer account, the Paypal account, and the Gmail account. The PayPal account has been upgraded to a 'business account' (free of charge) in order to be able to create the 'Donate' button on the center's web site.

email: <edisUser>

password: <edisPassword>

Center Server Administration Guide

2022-05-29T08:24:58Z

Josef templ: adapted to KVM Smart

== 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 [https://manage.edis.at/whmcs/clientarea.php?action=productdetails&id=214299 https://manage.edis.at/whmcs/clientarea.php?action=productdetails&id=214299],
use Login credentials

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 blackboxframework.org 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

export TMP="/var/www/tmp"

export TEMP="/var/www/tmp"

service nginx stop

certbot certonly --standalone -d blackboxframework.org -d forum.blackboxframework.org -d community.blackboxframework.org -d wiki.blackboxframework.org -d www.blackboxframework.org -d redmine.blackboxframework.org

service nginx start

For checking the web server status use:

service nginx status

exit

== 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 [http://178.209.50.165/phpmyadmin/ http://178.209.50.165/phpmyadmin/]

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/id_rsa.pub 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 on our Edis server use so-called ''virtual hosts'' in order to provide nice URLs such as
''forum.blackboxframework.org'', ''wiki.blackboxframework.org'', etc.
For every distinct service, there exists a corresponding virtual host.
All virtual hosts are entered in the domain name system (DNS) on [http://name.com name.com] in addition to
the root domain name ''blackboxframework.org''.

If a new service needs to be added, a new entry in the domain name system is required and our web server (nginx) needs to be
configured to serve this new virtual host in ''/etc/nginx/sites-enabled''. In addition, the list of virtual hosts for certificate renewal needs to be extended (see ''Certificate extension'').

After any change to the nginx configuration, a HUP signal may be sent to the nginx process in order to reload the configuration without a server restart: ''kill -HUP `cat /var/run/nginx.pid''`

Virtual Hosts served by ''nginx''
# blackboxframework.org (root domain name; content management system)
# www.blackboxframework.org (redirected to blackboxframework.org)
# forum.blackboxframework.org
# community.blackboxframework.org
# wiki.blackboxframework.org
# redmine.blackboxframework.org

All http requests are redirected to https automatically.

Center Financial Management Guide

2022-05-29T08:14:27Z

Josef templ: /* EDIS server hosting */

The BlackBox Framework Center periodically spends money for its operation. This memo describes the tasks of the financial manager and the required steps/logins.

== Domain name blackboxframework.org ==

The domain name needs to be paid annually. Currently it costs USD 12.99 per year.
The next expiration date is September 14th, 2021.

Login at [http://name.com http://name.com] or [https://www.name.com https://www.name.com].

user: <dnsUser>

password: <dnsPassword>

Go to "Renew My Domains", then "My Domains list".
In the resulting list with one entry for 'blackboxframework.org' click "Renew Domain".
If the user interface has been changed, look for something similar.
Open the shopping cart and proceed with payment via PayPal.

"WhoIs Privacy" is not really required and costs additional money.
Until now we are not using this option.

== EDIS server hosting ==

EDIS server hosting is based on a KVM Plan (KVM SMART, ID kvm_47273_211705) and costs EUR 5.99 plus tax per month.
The IP address of the server is 178.209.40.72, located in Switzerland.
It runs a Debian 11 (Bullseye) 64Bit Linux operating system.

Payment method is set to PayPal.
Payment can be automated by a repeating transfer from a PayPal account.

For managing financial aspects EDIS provides a web-based client area.

Login at [https://manage.edis.at/whmcs/clientarea.php https://manage.edis.at/whmcs/clientarea.php].

email: <edisUser>

password: <edisPassword>

Note: If the treasurer changes, customer data can be updated via the client area but some fields are read only and require a change request sent via e-mail from <edisUser> to support@edis.at.

== PayPal and Gmail account ==

The center uses a PayPal account for collecting donations and for paying the fees. The name of this PayPal account is an e-mail address connected to the account. The e-mail address is a Google mail address (gmail.com) and the same user and password is used for the Edis customer account, the Paypal account, and the Gmail account. The PayPal account has been upgraded to a 'business account' (free of charge) in order to be able to create the 'Donate' button on the center's web site.

email: <edisUser>

password: <edisPassword>

Center Financial Management Guide

2022-05-29T08:11:33Z

Josef templ: updated to KVM Smart

The BlackBox Framework Center periodically spends money for its operation. This memo describes the tasks of the financial manager and the required steps/logins.

== Domain name blackboxframework.org ==

The domain name needs to be paid annually. Currently it costs USD 12.99 per year.
The next expiration date is September 14th, 2021.

Login at [http://name.com http://name.com] or [https://www.name.com https://www.name.com].

user: <dnsUser>

password: <dnsPassword>

Go to "Renew My Domains", then "My Domains list".
In the resulting list with one entry for 'blackboxframework.org' click "Renew Domain".
If the user interface has been changed, look for something similar.
Open the shopping cart and proceed with payment via PayPal.

"WhoIs Privacy" is not really required and costs additional money.
Until now we are not using this option.

== EDIS server hosting ==

EDIS server hosting is based on a KVM Plan (KVM SMART) and costs EUR 5.99 plus tax per month.
The IP address of the server is 178.209.40.72, located in Switzerland.
It runs a Debian 11 (Bullseye) 64Bit Linux operating system.

Payment method is set to PayPal.
Payment can be automated by a repeating transfer from a PayPal account.

For managing financial aspects EDIS provides a web-based client area.

Login at [https://manage.edis.at/whmcs/clientarea.php https://manage.edis.at/whmcs/clientarea.php].

email: <edisUser>

password: <edisPassword>

Note: If the treasurer changes, customer data can be updated via the client area but some fields are read only and require a change request sent via e-mail from <edisUser> to support@edis.at.

== PayPal and Gmail account ==

The center uses a PayPal account for collecting donations and for paying the fees. The name of this PayPal account is an e-mail address connected to the account. The e-mail address is a Google mail address (gmail.com) and the same user and password is used for the Edis customer account, the Paypal account, and the Gmail account. The PayPal account has been upgraded to a 'business account' (free of charge) in order to be able to create the 'Donate' button on the center's web site.

email: <edisUser>

password: <edisPassword>

Center Server Administration Guide

2022-05-29T06:58:18Z

Josef templ: Certificate extension updated to our current KVM version

== 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 [https://manage.edis.at/vps/?&lang=en https://manage.edis.at/vps],
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 blackboxframework.org 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

export TMP="/var/www/tmp"

export TEMP="/var/www/tmp"

service nginx stop

certbot certonly --standalone -d blackboxframework.org -d forum.blackboxframework.org -d community.blackboxframework.org -d wiki.blackboxframework.org -d www.blackboxframework.org -d redmine.blackboxframework.org

service nginx start

For checking the web server status use:

service nginx status

exit

== 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 [http://178.209.50.165/phpmyadmin/ http://178.209.50.165/phpmyadmin/]

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/id_rsa.pub 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 on our Edis server use so-called ''virtual hosts'' in order to provide nice URLs such as
''forum.blackboxframework.org'', ''wiki.blackboxframework.org'', etc.
For every distinct service, there exists a corresponding virtual host.
All virtual hosts are entered in the domain name system (DNS) on [http://name.com name.com] in addition to
the root domain name ''blackboxframework.org''.

If a new service needs to be added, a new entry in the domain name system is required and our web server (nginx) needs to be
configured to serve this new virtual host in ''/etc/nginx/sites-enabled''. In addition, the list of virtual hosts for certificate renewal needs to be extended (see ''Certificate extension'').

After any change to the nginx configuration, a HUP signal may be sent to the nginx process in order to reload the configuration without a server restart: ''kill -HUP `cat /var/run/nginx.pid''`

Virtual Hosts served by ''nginx''
# blackboxframework.org (root domain name; content management system)
# www.blackboxframework.org (redirected to blackboxframework.org)
# forum.blackboxframework.org
# community.blackboxframework.org
# wiki.blackboxframework.org
# redmine.blackboxframework.org

All http requests are redirected to https automatically.

Center Server Administration Guide

2020-10-15T08:11:57Z

Josef templ: /* Virtual Hosts */

== 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 [https://manage.edis.at/vps/?&lang=en https://manage.edis.at/vps],
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 blackboxframework.org 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

export TMP="/var/www/tmp"

export TEMP="/var/www/tmp"

service nginx stop

~/certbot-auto --no-self-upgrade certonly --standalone -d blackboxframework.org -d forum.blackboxframework.org -d community.blackboxframework.org -d wiki.blackboxframework.org -d www.blackboxframework.org -d redmine.blackboxframework.org

service nginx start

For checking the web server status use:

service nginx status

exit

== 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 [http://178.209.50.165/phpmyadmin/ http://178.209.50.165/phpmyadmin/]

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/id_rsa.pub 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 on our Edis server use so-called ''virtual hosts'' in order to provide nice URLs such as
''forum.blackboxframework.org'', ''wiki.blackboxframework.org'', etc.
For every distinct service, there exists a corresponding virtual host.
All virtual hosts are entered in the domain name system (DNS) on [http://name.com name.com] in addition to
the root domain name ''blackboxframework.org''.

If a new service needs to be added, a new entry in the domain name system is required and our web server (nginx) needs to be
configured to serve this new virtual host in ''/etc/nginx/sites-enabled''. In addition, the list of virtual hosts for certificate renewal needs to be extended (see ''Certificate extension'').

After any change to the nginx configuration, a HUP signal may be sent to the nginx process in order to reload the configuration without a server restart: ''kill -HUP `cat /var/run/nginx.pid''`

Virtual Hosts served by ''nginx''
# blackboxframework.org (root domain name; content management system)
# www.blackboxframework.org (redirected to blackboxframework.org)
# forum.blackboxframework.org
# community.blackboxframework.org
# wiki.blackboxframework.org
# redmine.blackboxframework.org

All http requests are redirected to https automatically.

Center Financial Management Guide

2020-10-14T09:20:13Z

Josef templ: /* Domain name blackboxframework.org */

The BlackBox Framework Center periodically spends money for its operation. This memo describes the tasks of the financial manager and the required steps/logins.

== Domain name blackboxframework.org ==

The domain name needs to be paid annually. Currently it costs USD 12.99 per year.
The next expiration date is September 14th, 2021.

Login at [http://name.com http://name.com] or [https://www.name.com https://www.name.com].

user: <dnsUser>

password: <dnsPassword>

Go to "Renew My Domains", then "My Domains list".
In the resulting list with one entry for 'blackboxframework.org' click "Renew Domain".
If the user interface has been changed, look for something similar.
Open the shopping cart and proceed with payment via PayPal.

"WhoIs Privacy" is not really required and costs additional money.
Until now we are not using this option.

== EDIS server hosting ==

EDIS server hosting for a virtual root server package (VRS - VRS STARTER) costs EUR 4.99 plus tax per month.
The IP address of the virtual root server is 178.209.50.165, located in Switzerland.
It runs a Debian 7 (Wheezy) 32-Bit Linux operating system.

Payment method is set to PayPal.
Payment can be automated by a repeating transfer from a PayPal account.

For managing financial aspects EDIS provides a web-based client area.

Login at [https://manage.edis.at/whmcs/clientarea.php https://manage.edis.at/whmcs/clientarea.php].

email: <edisUser>

password: <edisPassword>

Note: If the treasurer changes, customer data can be updated via the client area but some fields are read only and require a change request sent via e-mail from <edisUser> to support@edis.at.

== PayPal and Gmail account ==

The center uses a PayPal account for collecting donations and for paying the fees. The name of this PayPal account is an e-mail address connected to the account. The e-mail address is a Google mail address (gmail.com) and the same user and password is used for the Edis customer account, the Paypal account, and the Gmail account. The PayPal account has been upgraded to a 'business account' (free of charge) in order to be able to create the 'Donate' button on the center's web site.

email: <edisUser>

password: <edisPassword>

Center Server Administration Guide

2020-10-14T09:19:07Z

Josef templ: /* Virtual Hosts */

== 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 [https://manage.edis.at/vps/?&lang=en https://manage.edis.at/vps],
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 blackboxframework.org 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

export TMP="/var/www/tmp"

export TEMP="/var/www/tmp"

service nginx stop

~/certbot-auto --no-self-upgrade certonly --standalone -d blackboxframework.org -d forum.blackboxframework.org -d community.blackboxframework.org -d wiki.blackboxframework.org -d www.blackboxframework.org -d redmine.blackboxframework.org

service nginx start

For checking the web server status use:

service nginx status

exit

== 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 [http://178.209.50.165/phpmyadmin/ http://178.209.50.165/phpmyadmin/]

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/id_rsa.pub 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 on our Edis server use so-called ''virtual hosts'' in order to provided nice URLs such as
''forum.blackboxframework.org'', ''wiki.blackboxframework.org'', etc.
For every distinct service, there exists a corresponding virtual host.
All virtual hosts are entered in the domain name system (DNS) on [http://name.com name.com] in addition to
the root domain name ''blackboxframework.org''.

If a new service needs to be added, a new entry in the domain name system is required and our web server (nginx) needs to be
configured to serve this new virtual host in ''/etc/nginx/sites-enabled''. In addition, the list of virtual hosts for certificate renewal needs to be extended (see ''Certificate extension'').

Virtual Hosts served by ''nginx''
# blackboxframework.org (root domain name; content management system)
# www.blackboxframework.org (redirected to blackboxframework.org)
# forum.blackboxframework.org
# community.blackboxframework.org
# wiki.blackboxframework.org
# redmine.blackboxframework.org

All http requests are redirected to https automatically.

Center Server Administration Guide

2020-10-05T10:48:44Z

Josef templ: /* Certificate extension */

== 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 [https://manage.edis.at/vps/?&lang=en https://manage.edis.at/vps],
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 blackboxframework.org 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

export TMP="/var/www/tmp"

export TEMP="/var/www/tmp"

service nginx stop

~/certbot-auto --no-self-upgrade certonly --standalone -d blackboxframework.org -d forum.blackboxframework.org -d community.blackboxframework.org -d wiki.blackboxframework.org -d www.blackboxframework.org -d redmine.blackboxframework.org

service nginx start

For checking the web server status use:

service nginx status

exit

== 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 [http://178.209.50.165/phpmyadmin/ http://178.209.50.165/phpmyadmin/]

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/id_rsa.pub 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
forum.blackboxframework.org, wiki.blackboxframework.org, redmine.blackboxframework.org, etc.
For every distinct service, there exists a distinct virtual host.
All virtual hosts are entered in the domain name system (DNS) on [http://name.com name.com] in addition to
the root domain name 'blackboxframework.org'.
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.

Virtual Hosts served by ''apache'' (http only)
# blackboxframework.org (Content management system)
# www.blackboxframework.org (alias to blackboxframework.org)

Virtual Hosts served by ''nginx'' (supports https)
# forum.blackboxframework.org
# community.blackboxframework.org
# wiki.blackboxframework.org
# redmine.blackboxframework.org

Virtual Hosts not currently served
# mj2.blackboxframework.org (mailing lists)

Center Server Administration Guide

2020-10-05T10:45:21Z

Josef templ: --no-self-update added

== 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 [https://manage.edis.at/vps/?&lang=en https://manage.edis.at/vps],
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 blackboxframework.org 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

export TMP="/var/www/tmp"
export TEMP="/var/www/tmp"
service nginx stop

~/certbot-auto --no-self-upgrade certonly --standalone -d blackboxframework.org -d forum.blackboxframework.org -d community.blackboxframework.org -d wiki.blackboxframework.org -d www.blackboxframework.org -d redmine.blackboxframework.org

service nginx start

For checking the web server status use:

service nginx status

exit

== 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 [http://178.209.50.165/phpmyadmin/ http://178.209.50.165/phpmyadmin/]

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/id_rsa.pub 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
forum.blackboxframework.org, wiki.blackboxframework.org, redmine.blackboxframework.org, etc.
For every distinct service, there exists a distinct virtual host.
All virtual hosts are entered in the domain name system (DNS) on [http://name.com name.com] in addition to
the root domain name 'blackboxframework.org'.
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.

Virtual Hosts served by ''apache'' (http only)
# blackboxframework.org (Content management system)
# www.blackboxframework.org (alias to blackboxframework.org)

Virtual Hosts served by ''nginx'' (supports https)
# forum.blackboxframework.org
# community.blackboxframework.org
# wiki.blackboxframework.org
# redmine.blackboxframework.org

Virtual Hosts not currently served
# mj2.blackboxframework.org (mailing lists)

Center Server Administration Guide

2020-10-05T08:59:21Z

Josef templ: vhost order changed

== 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 [https://manage.edis.at/vps/?&lang=en https://manage.edis.at/vps],
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 blackboxframework.org 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 blackboxframework.org -d forum.blackboxframework.org -d community.blackboxframework.org -d wiki.blackboxframework.org -d www.blackboxframework.org -d redmine.blackboxframework.org

service nginx start

For checking the web server status use:

service nginx status

exit

== 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 [http://178.209.50.165/phpmyadmin/ http://178.209.50.165/phpmyadmin/]

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/id_rsa.pub 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
forum.blackboxframework.org, wiki.blackboxframework.org, redmine.blackboxframework.org, etc.
For every distinct service, there exists a distinct virtual host.
All virtual hosts are entered in the domain name system (DNS) on [http://name.com name.com] in addition to
the root domain name 'blackboxframework.org'.
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.

Virtual Hosts served by ''apache'' (http only)
# blackboxframework.org (Content management system)
# www.blackboxframework.org (alias to blackboxframework.org)

Virtual Hosts served by ''nginx'' (supports https)
# forum.blackboxframework.org
# community.blackboxframework.org
# wiki.blackboxframework.org
# redmine.blackboxframework.org

Virtual Hosts not currently served
# mj2.blackboxframework.org (mailing lists)

Center Server Administration Guide

2020-10-05T08:44:31Z

Josef templ: www.blackboxframework.org added in vhost list

== 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 [https://manage.edis.at/vps/?&lang=en https://manage.edis.at/vps],
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 blackboxframework.org 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 forum.blackboxframework.org -d community.blackboxframework.org -d wiki.blackboxframework.org -d www.blackboxframework.org -d blackboxframework.org -d redmine.blackboxframework.org

service nginx start

For checking the web server status use:

service nginx status

exit

== 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 [http://178.209.50.165/phpmyadmin/ http://178.209.50.165/phpmyadmin/]

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/id_rsa.pub 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
forum.blackboxframework.org, wiki.blackboxframework.org, redmine.blackboxframework.org, etc.
For every distinct service, there exists a distinct virtual host.
All virtual hosts are entered in the domain name system (DNS) on [http://name.com name.com] in addition to
the root domain name 'blackboxframework.org'.
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.

Virtual Hosts served by ''apache'' (http only)
# blackboxframework.org (Content management system)
# www.blackboxframework.org (alias to blackboxframework.org)

Virtual Hosts served by ''nginx'' (supports https)
# forum.blackboxframework.org
# community.blackboxframework.org
# wiki.blackboxframework.org
# redmine.blackboxframework.org

Virtual Hosts not currently served
# mj2.blackboxframework.org (mailing lists)

Center Server Administration Guide

2020-10-03T11:03:12Z

Josef templ: mj2.blackboxframework.org added

== 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 [https://manage.edis.at/vps/?&lang=en https://manage.edis.at/vps],
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 blackboxframework.org 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 forum.blackboxframework.org -d community.blackboxframework.org -d wiki.blackboxframework.org -d blackboxframework.org -d redmine.blackboxframework.org

service nginx start

For checking the web server status use:

service nginx status

exit

== 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 [http://178.209.50.165/phpmyadmin/ http://178.209.50.165/phpmyadmin/]

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/id_rsa.pub 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
forum.blackboxframework.org, wiki.blackboxframework.org, redmine.blackboxframework.org, etc.
For every distinct service, there exists a distinct virtual host.
All virtual hosts are entered in the domain name system (DNS) on [http://name.com name.com] in addition to
the root domain name 'blackboxframework.org'.
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.

Virtual Hosts served by ''apache'' (http only)
# blackboxframework.org (Content management system)
# www.blackboxframework.org (alias to blackboxframework.org)

Virtual Hosts served by ''nginx'' (supports https)
# forum.blackboxframework.org
# community.blackboxframework.org
# wiki.blackboxframework.org
# redmine.blackboxframework.org

Virtual Hosts not currently served
# mj2.blackboxframework.org (mailing lists)

Center Server Administration Guide

2020-10-03T10:46:26Z

Josef templ:

== 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 [https://manage.edis.at/vps/?&lang=en https://manage.edis.at/vps],
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 blackboxframework.org 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 forum.blackboxframework.org -d community.blackboxframework.org -d wiki.blackboxframework.org -d blackboxframework.org -d redmine.blackboxframework.org

service nginx start

For checking the web server status use:

service nginx status

exit

== 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 [http://178.209.50.165/phpmyadmin/ http://178.209.50.165/phpmyadmin/]

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/id_rsa.pub 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
forum.blackboxframework.org, wiki.blackboxframework.org, redmine.blackboxframework.org, etc.
For every distinct service, there exists a distinct virtual host.
All virtual hosts are entered in the domain name system (DNS) on [http://name.com name.com] in addition to
the root domain name 'blackboxframework.org'.
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.

Host served by ''apache'' (http only)
# blackboxframework.org (Content management system)

Virtual Hosts served by ''nginx'' (supports https)
# forum.blackboxframework.org
# community.blackboxframework.org
# wiki.blackboxframework.org
# redmine.blackboxframework.org

Center Server Administration Guide

2020-10-03T10:44:35Z

Josef templ: vhost association to web server added

== 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 [https://manage.edis.at/vps/?&lang=en https://manage.edis.at/vps],
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 blackboxframework.org 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 forum.blackboxframework.org -d community.blackboxframework.org -d wiki.blackboxframework.org -d blackboxframework.org -d redmine.blackboxframework.org

service nginx start

For checking the web server status use:

service nginx status

exit

== 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 [http://178.209.50.165/phpmyadmin/ http://178.209.50.165/phpmyadmin/]

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/id_rsa.pub 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
forum.blackboxframework.org, wiki.blackboxframework.org, redmine.blackboxframework.org, etc.
For every distinct service, there exists a distinct virtual host.
All virtual hosts are entered in the domain name system (DNS) on [http://name.com name.com] in addition to
the root domain name 'blackboxframework.org'.
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.

Host served by ''apache'' (http only)
# blackboxframework.org (Content management system)

Virtual Hosts served by ''nginx'' (supports https)
# forum.blackboxframework.org
# community.blackboxframework.org
# wiki.blackboxframework.org
# redmine.blackboxframework.org

BlackBox Release Checklist

2019-10-10T15:00:19Z

Josef templ:

When creating a new BlackBox release the following steps and checks should be carried out:

1. Create an 'Infrastructure' issue in the redmine issue tracker and reference that issue in all commits related to this release.

2. Set the appropriate version number and release phase according to the [[BlackBox Versioning Strategy]] in the following file,

appbuild/AppVersion.txt

2. Check if the copyright year is set to the current year in the files listed below. If not, set it now.

LICENSE.txt
Docu/BB-License.odc
System/Rsrc/About.odc

BlackBox Release Checklist

2019-10-10T14:58:53Z

Josef templ:

When creating a new BlackBox release the following steps and checks should be carried out:

1. Create an 'Infrastructure' issue in the redmine issue tracker and reference that issue in all commits related to this release.

2. Set the appropriate version number and release phase according to [[BlackBox Versioning Strategy]] in the following file,

appbuild/AppVersion.txt

2. Check if the copyright year is set to the current year in the files listed below. If not, set it now.

LICENSE.txt
Docu/BB-License.odc
System/Rsrc/About.odc

BlackBox Release Checklist

2019-10-10T14:56:38Z

Josef templ: Created page with "When creating a new BlackBox release the following steps and checks should be carried out: 1. Create an 'Infrastructure' issue in the redmine issue tracker and reference that..."

When creating a new BlackBox release the following steps and checks should be carried out:

1. Create an 'Infrastructure' issue in the redmine issue tracker and reference that issue in all commits related to this release.

2. Set the appropriate version number and release phase according to [[The BlackBox Versioning Strategy]] in the following file,

appbuild/AppVersion.txt

2. Check if the copyright year is set to the current year in the files listed below. If not, set it now.

LICENSE.txt
Docu/BB-License.odc
System/Rsrc/About.odc

Main Page

2019-10-10T14:41:42Z

Josef templ: /* Urgent pages */

This Wiki is for documentation of [[BlackBox Component Builder]] and for building it's knowledge base.

BlackBox is available from the BlackBox Framework Center [http://blackboxframework.org/index.php?cID=goto-download-page,en-us Download page].

Also this wiki is used for [[center|BlackBox Сenter]].

== New ==

* [[The two Bulletin Boards]]
* [[Sequencers]]

== Urgent pages ==

* [[Center Financial Management Guide]]
* [[Center Server Administration Guide]]
* [[Center Members Admin Guide]]
* [[Center]] (Mission, Values, & Governance)
* [[Bug fixing pipeline]]
* [[How to develop with Git]]
* [[How to develop with Tortoise Git]]
* [[BlackBox Versioning Strategy|The BlackBox Versioning Strategy]]
* [[The BlackBox Build Engine]]
* [[Localizing BlackBox]]
* [[Running BlackBox under Linux]]
* [[BlackBox Release Checklist]]

== Technical notes ==

* [[Diff|Setting up a diff viewer for BlackBox .odc binary files]]
* [[H2O|Generation of import modules from C-headers]]
* [[Git|Git Gui Instructions]]
* [[Console|Low-level logging to Console]]
* [[ModuleUnloading|On Module Unloading in BlackBox]]
* [[Updating the Git master branch]]
* [[System structure and interface separation]]

== Links ==

* [http://blackboxframework.org/ Main website]
* [http://forum.blackboxframework.org Center Forum]
* [http://github.com/BlackBoxCenter Public repository and issues tracker]
* [http://redmine.blackboxframework.org/projects/blackbox Center project and issues tracker]

Center Financial Management Guide

2018-08-23T04:53:05Z

Josef templ: /* Domain name blackboxframework.org */

The BlackBox Framework Center periodically spends money for its operation. This memo describes the tasks of the financial manager and the required steps/logins.

== Domain name blackboxframework.org ==

The domain name needs to be paid annually. Currently it costs USD 12.99 per year.
The next expiration date is September 14th, 2019.

Login at [http://name.com http://name.com] or [https://www.name.com https://www.name.com].

user: <dnsUser>

password: <dnsPassword>

Go to "Renew My Domains", then "My Domains list".
In the resulting list with one entry for 'blackboxframework.org' click "Renew Domain".
If the user interface has been changed, look for something similar.
Open the shopping cart and proceed with payment via PayPal.

"WhoIs Privacy" is not really required and costs additional money.
Until now we are not using this option.

== EDIS server hosting ==

EDIS server hosting for a virtual root server package (VRS - VRS STARTER) costs EUR 4.99 plus tax per month.
The IP address of the virtual root server is 178.209.50.165, located in Switzerland.
It runs a Debian 7 (Wheezy) 32-Bit Linux operating system.

Payment method is set to PayPal.
Payment can be automated by a repeating transfer from a PayPal account.

For managing financial aspects EDIS provides a web-based client area.

Login at [https://manage.edis.at/whmcs/clientarea.php https://manage.edis.at/whmcs/clientarea.php].

email: <edisUser>

password: <edisPassword>

Note: If the treasurer changes, customer data can be updated via the client area but some fields are read only and require a change request sent via e-mail from <edisUser> to support@edis.at.

== PayPal and Gmail account ==

The center uses a PayPal account for collecting donations and for paying the fees. The name of this PayPal account is an e-mail address connected to the account. The e-mail address is a Google mail address (gmail.com) and the same user and password is used for the Edis customer account, the Paypal account, and the Gmail account. The PayPal account has been upgraded to a 'business account' (free of charge) in order to be able to create the 'Donate' button on the center's web site.

email: <edisUser>

password: <edisPassword>

Center Server Administration Guide

2018-07-24T16:36:39Z

Josef templ: /* Cleaning up Disc Space */

== 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 [https://manage.edis.at/vps/?&lang=en https://manage.edis.at/vps],
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 blackboxframework.org 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 forum.blackboxframework.org -d community.blackboxframework.org -d wiki.blackboxframework.org -d blackboxframework.org -d redmine.blackboxframework.org

service nginx start

For checking the web server status use:

service nginx status

exit

== 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 [http://178.209.50.165/phpmyadmin/ http://178.209.50.165/phpmyadmin/]

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/id_rsa.pub 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
forum.blackboxframework.org, wiki.blackboxframework.org, redmine.blackboxframework.org, etc.
For every distinct service, there exists a distinct virtual host.
All virtual hosts are entered in the domain name system (DNS) on [http://name.com name.com] in addition to
the root domain name 'blackboxframework.org'.
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.

Center Financial Management Guide

2018-01-05T16:50:37Z

Josef templ: /* EDIS server hosting */

The BlackBox Framework Center periodically spends money for its operation. This memo describes the tasks of the financial manager and the required steps/logins.

== Domain name blackboxframework.org ==

The domain name needs to be paid annually. Currently it costs USD 12.99 per year.
The next expiration date is September 14th, 2018.

Login at [http://name.com http://name.com] or [https://www.name.com https://www.name.com].

user: <dnsUser>

password: <dnsPassword>

Go to "Renew My Domains", then "My Domains list".
In the resulting list with one entry for 'blackboxframework.org' click "Renew Domain".
If the user interface has been changed, look for something similar.

"WhoIs Privacy" is not really required and costs additional money.
Until now we are not using this option.

== EDIS server hosting ==

EDIS server hosting for a virtual root server package (VRS - VRS STARTER) costs EUR 4.99 plus tax per month.
The IP address of the virtual root server is 178.209.50.165, located in Switzerland.
It runs a Debian 7 (Wheezy) 32-Bit Linux operating system.

Payment method is set to PayPal.
Payment can be automated by a repeating transfer from a PayPal account.

For managing financial aspects EDIS provides a web-based client area.

Login at [https://manage.edis.at/whmcs/clientarea.php https://manage.edis.at/whmcs/clientarea.php].

email: <edisUser>

password: <edisPassword>

Note: If the treasurer changes, customer data can be updated via the client area but some fields are read only and require a change request sent via e-mail from <edisUser> to support@edis.at.

== PayPal and Gmail account ==

The center uses a PayPal account for collecting donations and for paying the fees. The name of this PayPal account is an e-mail address connected to the account. The e-mail address is a Google mail address (gmail.com) and the same user and password is used for the Edis customer account, the Paypal account, and the Gmail account. The PayPal account has been upgraded to a 'business account' (free of charge) in order to be able to create the 'Donate' button on the center's web site.

email: <edisUser>

password: <edisPassword>

Center Server Administration Guide

2017-12-15T08:19:06Z

Josef templ:

== 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 [https://manage.edis.at/vps/?&lang=en https://manage.edis.at/vps],
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 blackboxframework.org 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 forum.blackboxframework.org -d community.blackboxframework.org -d wiki.blackboxframework.org -d blackboxframework.org -d redmine.blackboxframework.org

service nginx start

For checking the web server status use:

service nginx status

exit

== 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 [http://178.209.50.165/phpmyadmin/ http://178.209.50.165/phpmyadmin/]

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/id_rsa.pub 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

== Virtual Hosts ==
The web-based services provided by our server use so-called 'virtual hosts' in order to provided nice URLs such as
forum.blackboxframework.org, wiki.blackboxframework.org, redmine.blackboxframework.org, etc.
For every distinct service, there exists a distinct virtual host.
All virtual hosts are entered in the domain name system (DNS) on [http://name.com name.com] in addition to
the root domain name 'blackboxframework.org'.
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.

How to develop with Git

2017-12-12T10:37:11Z

Josef templ: /* Building Stable Releases */

== Related Pages ==

Pages related to this topic are [[BlackBox Versioning Strategy|The BlackBox Versioning Strategy]], [[Git]] and [[How to develop with Tortoise Git]].

== Topic Branches ==
For every issue entered into the redmine issue tracker
we create a branch from 'master' in our [https://github.com/BlackBoxCenter/blackbox GitHub repository].

A new branch is created by:

* Go to GitHub https://github.com/BlackBoxCenter/blackbox.
* Alternatively:
*# Go to the Center page: https://forum.blackboxframework.org.
*# Click on the top level yellow option "GitHub repository"
*# Click on the large blue "blackbox" text in the center of the page.

* Use the drop-down on the left of the page "Branch: master ▼" to create the new branch.
*# In the field with light grey text "Find or create a branch" type "issue-#N"
*# Click in the blue area "Create branch: issue-#N from 'master'".

If you use your browser's search function to search for the drop-down menu, use the search string 'Branch:', i.e. without 'master' because this depends on the currently selected branch.

If an issue has number N, we name that newly created branch
issue-#N (see also 'Notes on Naming').
We work on the issue and discuss the solution within this topic branch.

When we agree that an issue has been solved, we create a
so-called 'pull request' and merge that pull request into 'master'.

Multiple such topic branches can be worked on in parallel.
For every branch you can see the files that are affected by this issue only.
There is no mixing with changes that refer to other issues.

In order to reduce merge conflicts as much as possible, care should
be taken not to work on conflicting issues in parallel but sequentially.
A merge conflict arises if two topic branches modify the same binary
.odc file or modify the same lines of an ASCII text file.
If a merge conflicts arises, it must be resolved manually before
merging a pull request.

If the Component Pascal Language is changed such that a feature still
used in the source code of other BlackBox topic branches is removed, such a change
must be merged to master after all topic branches that use this feature.

== Bi-Directional Traceability ==
The general rule with respect to committing changes to [[Git]] is to always refer to an issue in the first line of the commit message.

The format of the first line of a commit message that refers to issue number N is

<code><commit message text>. Refs: #N.</code>

Example commit message for issue-#121:
<pre>
fix for a compiler warning regarding unreleased register AX. Refs: #121.
As proposed by luowy but slightly corrected.
The additional FreeHi must only be called when y.mode = Int64.
</pre>

When browsing the source code repository or when looking at commits (alias revisions) in redmine, references to issues will show up as links that can be clicked on.
Similarly, when browsing the issues list in redmine, commits (alias revisions) that reference an issue show up as links that can be clicked on.
Thereby you can always go from an issue to the related commits and from a commit to the related issue.

This feature is usually called bi-directional traceability and is a requirement in any standardized software engineering process.
It is also used by many open source projects.

Please note the terminating dot after the referenced issue number in the commit message format.
Its purpose it to serve together with the opening # as a bracket for issue numbers.
With such a bracket you can search textually for a referenced issue by specifying a search string "#N." without mixing up the result
with issues that happen to contain the same sequence of digits.
For example, searching for "#2." should find only issue 2 but not issues 20, 21, 22, etc.

== Building Unstable Releases ==
The build engine detects commits to all branches and starts the build process automatically.
If the build engine detects an AppVersion.txt file with a development stage postfix, it builds an unstable release.

The output of the build process will be available in a subdirectory of [http://blackboxframework.org/unstable/ http://blackboxframework.org/unstable]
named after the branch the build has been performed for.

== Building Stable Releases ==
Before building a stable release, check the state of all issues belonging to that release in the ''redmine'' issue tracker.
Also check if descriptions of the issues exist and if they are formatted appropriately.
They should look well both in html and in the BlackBox changelist document.

If the build engine builds for the branch ''master'' and detects an ''AppVersion.txt'' file with no development stage postfix, it builds a stable (final) release automatically.
The core of building a stable release therefore is to remove the development stage postfix from the file ''appbuild/AppVersion.txt'' and commit it to ''master''.

The output of the build process will be available in [http://blackboxframework.org/stable/ http://blackboxframework.org/stable].
The build output is supposed to be never changed later on without setting a new version number in ''AppVersion.txt''.

For a final release ''X'', a tag named ''vX'' should be inserted into the Git repository.
In GitHub, a tag is added by creating a so-called ''release''. The tag should be targeted at the ''master'' branch.
The tag name ''vX'' is also used as the ''release title''. Download links should be added in the description.
By creating a release, Github creates source code archives in two formats (zip and tar.gz) automatically.

Finally, the download page of the center's web site should be updated.

== Notes on Naming ==
There are many ways of naming a topic branch.
The simplest approach is to use only the issue number.

In an early experiment with a BlackBox issue a longer branch name
has been used that also contained the subject of the topic.
But this turned out to be a mistake because
* it leads to long branch names
* it may trigger an endless discussion about the 'best' name
* the name turned out to be inappropriate but cannot be changed later on.

== Notes on Learning Git ==
The best source for learning the concepts and commands of Git is the
[http://git-scm.com/book/en/v2 Git book]. It has been translated into many languages
and explains the basic concepts and the command line syntax of Git very well.
Even if you use a graphical front end for Git, such as TortoiseGit or GitGUI,
it is a valuable source for understanding Git because the many options
and commands presented in any of the available graphical front ends
can only be mastered if the basics of Git are clear.

The starting point for working with Git from the command line is the clone command.
If you want to work on issue <N>, use the following command for cloning
the repository to your local machine.

<nowiki>git clone https://github.com/BlackBoxCenter/blackbox.git blackbox-<N> -b issue-#<N></nowiki>

This command will create a new directory named blackbox-<N> with a clone of the repository.
Option -b sets the current branch to issue-#<N>.

The starting point for working with Git with the GUI-based tool Tortoise Git is [[How to develop with Tortoise Git]].

How to develop with Git

2017-12-11T14:12:05Z

Josef templ: /* Building Stable Releases */

== Related Pages ==

Pages related to this topic are [[BlackBox Versioning Strategy|The BlackBox Versioning Strategy]], [[Git]] and [[How to develop with Tortoise Git]].

== Topic Branches ==
For every issue entered into the redmine issue tracker
we create a branch from 'master' in our [https://github.com/BlackBoxCenter/blackbox GitHub repository].

A new branch is created by:

* Go to GitHub https://github.com/BlackBoxCenter/blackbox.
* Alternatively:
*# Go to the Center page: https://forum.blackboxframework.org.
*# Click on the top level yellow option "GitHub repository"
*# Click on the large blue "blackbox" text in the center of the page.

* Use the drop-down on the left of the page "Branch: master ▼" to create the new branch.
*# In the field with light grey text "Find or create a branch" type "issue-#N"
*# Click in the blue area "Create branch: issue-#N from 'master'".

If you use your browser's search function to search for the drop-down menu, use the search string 'Branch:', i.e. without 'master' because this depends on the currently selected branch.

If an issue has number N, we name that newly created branch
issue-#N (see also 'Notes on Naming').
We work on the issue and discuss the solution within this topic branch.

When we agree that an issue has been solved, we create a
so-called 'pull request' and merge that pull request into 'master'.

Multiple such topic branches can be worked on in parallel.
For every branch you can see the files that are affected by this issue only.
There is no mixing with changes that refer to other issues.

In order to reduce merge conflicts as much as possible, care should
be taken not to work on conflicting issues in parallel but sequentially.
A merge conflict arises if two topic branches modify the same binary
.odc file or modify the same lines of an ASCII text file.
If a merge conflicts arises, it must be resolved manually before
merging a pull request.

If the Component Pascal Language is changed such that a feature still
used in the source code of other BlackBox topic branches is removed, such a change
must be merged to master after all topic branches that use this feature.

== Bi-Directional Traceability ==
The general rule with respect to committing changes to [[Git]] is to always refer to an issue in the first line of the commit message.

The format of the first line of a commit message that refers to issue number N is

<code><commit message text>. Refs: #N.</code>

Example commit message for issue-#121:
<pre>
fix for a compiler warning regarding unreleased register AX. Refs: #121.
As proposed by luowy but slightly corrected.
The additional FreeHi must only be called when y.mode = Int64.
</pre>

When browsing the source code repository or when looking at commits (alias revisions) in redmine, references to issues will show up as links that can be clicked on.
Similarly, when browsing the issues list in redmine, commits (alias revisions) that reference an issue show up as links that can be clicked on.
Thereby you can always go from an issue to the related commits and from a commit to the related issue.

This feature is usually called bi-directional traceability and is a requirement in any standardized software engineering process.
It is also used by many open source projects.

Please note the terminating dot after the referenced issue number in the commit message format.
Its purpose it to serve together with the opening # as a bracket for issue numbers.
With such a bracket you can search textually for a referenced issue by specifying a search string "#N." without mixing up the result
with issues that happen to contain the same sequence of digits.
For example, searching for "#2." should find only issue 2 but not issues 20, 21, 22, etc.

== Building Unstable Releases ==
The build engine detects commits to all branches and starts the build process automatically.
If the build engine detects an AppVersion.txt file with a development stage postfix, it builds an unstable release.

The output of the build process will be available in a subdirectory of [http://blackboxframework.org/unstable/ http://blackboxframework.org/unstable]
named after the branch the build has been performed for.

== Building Stable Releases ==
Before building a stable release, check the state of all issues belonging to that release in the ''redmine'' issue tracker.
Also check if descriptions of the issues exist and if they are formatted appropriately.
They should look well both in html and in the BlackBox changelist document.

If the build engine builds for the branch ''master'' and detects an ''AppVersion.txt'' file with no development stage postfix, it builds a stable (final) release automatically.
The core of building a stable release therefore is to remove the development stage postfix from the file ''appbuild/AppVersion.txt'' and commit it to ''master''.

The output of the build process will be available in [http://blackboxframework.org/stable/ http://blackboxframework.org/stable].
The build output is supposed to be never changed later on without setting a new version number in ''AppVersion.txt''.

For a final release ''X'', a tag named ''vX'' should be inserted into the Git repository.
In GitHub, a tag is added by creating a so-called ''release''. The tag should be targeted at the ''master'' branch.
The tag name ''vX'' is also used as the ''release title''. Download links may be added in the description.

Finally, the download page of the center's web site should be updated.

== Notes on Naming ==
There are many ways of naming a topic branch.
The simplest approach is to use only the issue number.

In an early experiment with a BlackBox issue a longer branch name
has been used that also contained the subject of the topic.
But this turned out to be a mistake because
* it leads to long branch names
* it may trigger an endless discussion about the 'best' name
* the name turned out to be inappropriate but cannot be changed later on.

== Notes on Learning Git ==
The best source for learning the concepts and commands of Git is the
[http://git-scm.com/book/en/v2 Git book]. It has been translated into many languages
and explains the basic concepts and the command line syntax of Git very well.
Even if you use a graphical front end for Git, such as TortoiseGit or GitGUI,
it is a valuable source for understanding Git because the many options
and commands presented in any of the available graphical front ends
can only be mastered if the basics of Git are clear.

The starting point for working with Git from the command line is the clone command.
If you want to work on issue <N>, use the following command for cloning
the repository to your local machine.

<nowiki>git clone https://github.com/BlackBoxCenter/blackbox.git blackbox-<N> -b issue-#<N></nowiki>

This command will create a new directory named blackbox-<N> with a clone of the repository.
Option -b sets the current branch to issue-#<N>.

The starting point for working with Git with the GUI-based tool Tortoise Git is [[How to develop with Tortoise Git]].

How to develop with Git

2017-12-11T13:25:02Z

Josef templ: /* Building Stable Releases */

== Related Pages ==

Pages related to this topic are [[BlackBox Versioning Strategy|The BlackBox Versioning Strategy]], [[Git]] and [[How to develop with Tortoise Git]].

== Topic Branches ==
For every issue entered into the redmine issue tracker
we create a branch from 'master' in our [https://github.com/BlackBoxCenter/blackbox GitHub repository].

A new branch is created by:

* Go to GitHub https://github.com/BlackBoxCenter/blackbox.
* Alternatively:
*# Go to the Center page: https://forum.blackboxframework.org.
*# Click on the top level yellow option "GitHub repository"
*# Click on the large blue "blackbox" text in the center of the page.

* Use the drop-down on the left of the page "Branch: master ▼" to create the new branch.
*# In the field with light grey text "Find or create a branch" type "issue-#N"
*# Click in the blue area "Create branch: issue-#N from 'master'".

If you use your browser's search function to search for the drop-down menu, use the search string 'Branch:', i.e. without 'master' because this depends on the currently selected branch.

If an issue has number N, we name that newly created branch
issue-#N (see also 'Notes on Naming').
We work on the issue and discuss the solution within this topic branch.

When we agree that an issue has been solved, we create a
so-called 'pull request' and merge that pull request into 'master'.

Multiple such topic branches can be worked on in parallel.
For every branch you can see the files that are affected by this issue only.
There is no mixing with changes that refer to other issues.

In order to reduce merge conflicts as much as possible, care should
be taken not to work on conflicting issues in parallel but sequentially.
A merge conflict arises if two topic branches modify the same binary
.odc file or modify the same lines of an ASCII text file.
If a merge conflicts arises, it must be resolved manually before
merging a pull request.

If the Component Pascal Language is changed such that a feature still
used in the source code of other BlackBox topic branches is removed, such a change
must be merged to master after all topic branches that use this feature.

== Bi-Directional Traceability ==
The general rule with respect to committing changes to [[Git]] is to always refer to an issue in the first line of the commit message.

The format of the first line of a commit message that refers to issue number N is

<code><commit message text>. Refs: #N.</code>

Example commit message for issue-#121:
<pre>
fix for a compiler warning regarding unreleased register AX. Refs: #121.
As proposed by luowy but slightly corrected.
The additional FreeHi must only be called when y.mode = Int64.
</pre>

When browsing the source code repository or when looking at commits (alias revisions) in redmine, references to issues will show up as links that can be clicked on.
Similarly, when browsing the issues list in redmine, commits (alias revisions) that reference an issue show up as links that can be clicked on.
Thereby you can always go from an issue to the related commits and from a commit to the related issue.

This feature is usually called bi-directional traceability and is a requirement in any standardized software engineering process.
It is also used by many open source projects.

Please note the terminating dot after the referenced issue number in the commit message format.
Its purpose it to serve together with the opening # as a bracket for issue numbers.
With such a bracket you can search textually for a referenced issue by specifying a search string "#N." without mixing up the result
with issues that happen to contain the same sequence of digits.
For example, searching for "#2." should find only issue 2 but not issues 20, 21, 22, etc.

== Building Unstable Releases ==
The build engine detects commits to all branches and starts the build process automatically.
If the build engine detects an AppVersion.txt file with a development stage postfix, it builds an unstable release.

The output of the build process will be available in a subdirectory of [http://blackboxframework.org/unstable/ http://blackboxframework.org/unstable]
named after the branch the build has been performed for.

== Building Stable Releases ==
If the build engine detects an AppVersion.txt file with no development stage postfix, it builds a stable (final) release automatically.

The output of the build process will be available in [http://blackboxframework.org/stable/ http://blackboxframework.org/stable].
The build output is supposed to be never changed later on without setting a new version number in AppVersion.txt.

For a final release ''X'', a tag named ''vX'' should be inserted into the Git repository.
In GitHub, a tag is added by creating a so-called ''release''. The tag should be targeted at the master branch,
which is used for creating final releases.

Finally, the download page of the center's web site should be updated.

== Notes on Naming ==
There are many ways of naming a topic branch.
The simplest approach is to use only the issue number.

In an early experiment with a BlackBox issue a longer branch name
has been used that also contained the subject of the topic.
But this turned out to be a mistake because
* it leads to long branch names
* it may trigger an endless discussion about the 'best' name
* the name turned out to be inappropriate but cannot be changed later on.

== Notes on Learning Git ==
The best source for learning the concepts and commands of Git is the
[http://git-scm.com/book/en/v2 Git book]. It has been translated into many languages
and explains the basic concepts and the command line syntax of Git very well.
Even if you use a graphical front end for Git, such as TortoiseGit or GitGUI,
it is a valuable source for understanding Git because the many options
and commands presented in any of the available graphical front ends
can only be mastered if the basics of Git are clear.

The starting point for working with Git from the command line is the clone command.
If you want to work on issue <N>, use the following command for cloning
the repository to your local machine.

<nowiki>git clone https://github.com/BlackBoxCenter/blackbox.git blackbox-<N> -b issue-#<N></nowiki>

This command will create a new directory named blackbox-<N> with a clone of the repository.
Option -b sets the current branch to issue-#<N>.

The starting point for working with Git with the GUI-based tool Tortoise Git is [[How to develop with Tortoise Git]].

How to develop with Git

2017-12-11T09:03:04Z

Josef templ: /* Related Pages */

== Related Pages ==

Pages related to this topic are [[BlackBox Versioning Strategy|The BlackBox Versioning Strategy]], [[Git]] and [[How to develop with Tortoise Git]].

== Topic Branches ==
For every issue entered into the redmine issue tracker
we create a branch from 'master' in our [https://github.com/BlackBoxCenter/blackbox GitHub repository].

A new branch is created by:

* Go to GitHub https://github.com/BlackBoxCenter/blackbox.
* Alternatively:
*# Go to the Center page: https://forum.blackboxframework.org.
*# Click on the top level yellow option "GitHub repository"
*# Click on the large blue "blackbox" text in the center of the page.

* Use the drop-down on the left of the page "Branch: master ▼" to create the new branch.
*# In the field with light grey text "Find or create a branch" type "issue-#N"
*# Click in the blue area "Create branch: issue-#N from 'master'".

If you use your browser's search function to search for the drop-down menu, use the search string 'Branch:', i.e. without 'master' because this depends on the currently selected branch.

If an issue has number N, we name that newly created branch
issue-#N (see also 'Notes on Naming').
We work on the issue and discuss the solution within this topic branch.

When we agree that an issue has been solved, we create a
so-called 'pull request' and merge that pull request into 'master'.

Multiple such topic branches can be worked on in parallel.
For every branch you can see the files that are affected by this issue only.
There is no mixing with changes that refer to other issues.

In order to reduce merge conflicts as much as possible, care should
be taken not to work on conflicting issues in parallel but sequentially.
A merge conflict arises if two topic branches modify the same binary
.odc file or modify the same lines of an ASCII text file.
If a merge conflicts arises, it must be resolved manually before
merging a pull request.

If the Component Pascal Language is changed such that a feature still
used in the source code of other BlackBox topic branches is removed, such a change
must be merged to master after all topic branches that use this feature.

== Bi-Directional Traceability ==
The general rule with respect to committing changes to [[Git]] is to always refer to an issue in the first line of the commit message.

The format of the first line of a commit message that refers to issue number N is

<code><commit message text>. Refs: #N.</code>

Example commit message for issue-#121:
<pre>
fix for a compiler warning regarding unreleased register AX. Refs: #121.
As proposed by luowy but slightly corrected.
The additional FreeHi must only be called when y.mode = Int64.
</pre>

When browsing the source code repository or when looking at commits (alias revisions) in redmine, references to issues will show up as links that can be clicked on.
Similarly, when browsing the issues list in redmine, commits (alias revisions) that reference an issue show up as links that can be clicked on.
Thereby you can always go from an issue to the related commits and from a commit to the related issue.

This feature is usually called bi-directional traceability and is a requirement in any standardized software engineering process.
It is also used by many open source projects.

Please note the terminating dot after the referenced issue number in the commit message format.
Its purpose it to serve together with the opening # as a bracket for issue numbers.
With such a bracket you can search textually for a referenced issue by specifying a search string "#N." without mixing up the result
with issues that happen to contain the same sequence of digits.
For example, searching for "#2." should find only issue 2 but not issues 20, 21, 22, etc.

== Building Unstable Releases ==
The build engine detects commits to all branches and starts the build process automatically.
If the build engine detects an AppVersion.txt file with a development stage postfix, it builds an unstable release.

The output of the build process will be available in a subdirectory of [http://blackboxframework.org/unstable/ http://blackboxframework.org/unstable]
named after the branch the build has been performed for.

== Building Stable Releases ==
If the build engine detects an AppVersion.txt file with no development stage postfix, it builds a stable (final) release automatically.

The output of the build process will be available in [http://blackboxframework.org/stable/ http://blackboxframework.org/stable].
The build output is supposed to be never changed later on without setting a new version number in AppVersion.txt.

For a final release X.Y, a tag named vX.Y should be inserted into the Git repository.
In GitHub, a tag is added by creating a so-called release. The tag should be targeted at the master branch,
which is used for creating final releases.

== Notes on Naming ==
There are many ways of naming a topic branch.
The simplest approach is to use only the issue number.

In an early experiment with a BlackBox issue a longer branch name
has been used that also contained the subject of the topic.
But this turned out to be a mistake because
* it leads to long branch names
* it may trigger an endless discussion about the 'best' name
* the name turned out to be inappropriate but cannot be changed later on.

== Notes on Learning Git ==
The best source for learning the concepts and commands of Git is the
[http://git-scm.com/book/en/v2 Git book]. It has been translated into many languages
and explains the basic concepts and the command line syntax of Git very well.
Even if you use a graphical front end for Git, such as TortoiseGit or GitGUI,
it is a valuable source for understanding Git because the many options
and commands presented in any of the available graphical front ends
can only be mastered if the basics of Git are clear.

The starting point for working with Git from the command line is the clone command.
If you want to work on issue <N>, use the following command for cloning
the repository to your local machine.

<nowiki>git clone https://github.com/BlackBoxCenter/blackbox.git blackbox-<N> -b issue-#<N></nowiki>

This command will create a new directory named blackbox-<N> with a clone of the repository.
Option -b sets the current branch to issue-#<N>.

The starting point for working with Git with the GUI-based tool Tortoise Git is [[How to develop with Tortoise Git]].

BlackBox Versioning Strategy

2017-10-28T22:24:33Z

Josef templ:

The versioning strategy for BlackBox distributions built by the BlackBox Framework Center is as follows:

The downloadable BlackBox packages carry a version information in their file names.
The same naming convention applies for installable setup.exe files as well as for
zipped packages that can be installed by unpacking the .zip file.
Also the build-log file uses the same naming convention, which is defined below using
an EBNF grammar.

FileName = "blackbox-" AppVersion ["." BuildNumber] + ("-setup.exe" | ".zip" | "-buildlog.html").

AppVersion = MajorVersion "." MinorVersion ["." PatchLevel] [DevelopmentStage].

DevelopmentStage = "-" ("a" | "b" | "rc") StageNumber.

AppVersion is maintained in a file named 'AppVersion.txt', which can be found
in the directory 'appbuild'. The existence of this file in a branch signals that
automatic building of that branch is enabled.
By looking at the change history of this file the timeline of the development
stages can be retrieved easily.
Examples for AppVersion are: 1.7-a1, 1.7.3-b2, 1.7-rc1, 1.7

The development stage letters have the following meaning:

'''a''' - alpha: not feature complete, internal testing

'''b''' - beta: feature complete, ready for external testing

'''rc''' - release candidate

'''no DevelopmentStage''' - means final release, in this case there is no build number in the file name.

The stage numbers always start at 1 and are only incremented in case of stepping back to a
previous development stage. The order of development stages is a then b then rc then final.
Thus, when for example '1.7-b1' turns out to have missing features or other severe problems,
development is set back to '1.7-a2', later followed by '1.7-b2' and '1.7-rc1', etc.

The build machine maintains a sequential build number for every build performed.
This information is not under Git version control but local to the build machine.

The generated BlackBox.exe file also carries version information.
See 'Properties' of this file under the Windows Explorer.
The version information here consists of four version numbers:
MajorVersion.MinorVersion.PatchLevel.BuildNumber, where PatchLevel defaults to 0 if missing in AppVersion.

The build machine derives all required version information from 'AppVersion.txt' and from the
internally maintained build number. There is only one single place in the source code
repository that needs to be changed in order to express a switch from one development stage to another.

Center Financial Management Guide

2017-08-28T14:40:38Z

Josef templ:

The BlackBox Framework Center periodically spends money for its operation. This memo describes the tasks of the financial manager and the required steps/logins.

== Domain name blackboxframework.org ==

The domain name needs to be paid annually. Currently it costs USD 12.99 per year.
The next expiration date is September 14th, 2018.

Login at [http://name.com http://name.com] or [https://www.name.com https://www.name.com].

user: <dnsUser>

password: <dnsPassword>

Go to "Renew My Domains", then "My Domains list".
In the resulting list with one entry for 'blackboxframework.org' click "Renew Domain".
If the user interface has been changed, look for something similar.

"WhoIs Privacy" is not really required and costs additional money.
Until now we are not using this option.

== EDIS server hosting ==

EDIS server hosting for a virtual root server package (VRS - VRS STARTER) costs EUR 4.99 per month.
The IP address of the virtual root server is 178.209.50.165, located in Switzerland.
It runs a Debian 7 (Wheezy) 32-Bit Linux operating system.

Payment method is set to PayPal.
Payment can be automated by a repeating transfer from a PayPal account.

For managing financial aspects EDIS provides a web-based client area.

Login at [https://manage.edis.at/whmcs/clientarea.php https://manage.edis.at/whmcs/clientarea.php].

email: <edisUser>

password: <edisPassword>

Note: If the treasurer changes, customer data can be updated via the client area but some fields are read only and require a change request sent via e-mail from <edisUser> to support@edis.at.

== PayPal and Gmail account ==

The center uses a PayPal account for collecting donations and for paying the fees. The name of this PayPal account is an e-mail address connected to the account. The e-mail address is a Google mail address (gmail.com) and the same user and password is used for the Edis customer account, the Paypal account, and the Gmail account. The PayPal account has been upgraded to a 'business account' (free of charge) in order to be able to create the 'Donate' button on the center's web site.

email: <edisUser>

password: <edisPassword>

Center Financial Management Guide

2017-08-28T14:40:15Z

Josef templ:

The BlackBox Framework Center periodically spends money for its operation. This memo describes the tasks of the financial manager and the required steps/logins.

== Domain name blackboxframework.org ==

The domain name needs to be paid annually. Currently it costs USD 12.99 per year.
The next expiration date is September 14th, 2018.

Login at [http://name.com http://name.com] or [https://www.name.com https://www.name.com].

user: <dnsUser>

password: <dnsPassword>

Go to "Renew My Domains", then "My Domains list".
In the resulting list with one entry for 'blackboxframework.org' click "Renew Domain".
If the user interface has been changed, look for something similar.

"WhoIs Privacy" is not really required and costs additional money.
Until now we are not using this option.

== EDIS server hosting ==

EDIS server hosting for a virtual root server package (VRS - VRS STARTER) costs EUR 4.99 per month.
The IP address of the virtual root server is 178.209.50.165, located in Switzerland.
It runs a Debian 7 (Wheezy) 32-Bit Linux operating system.

Payment method is set to PayPal.
Payment can be automated by a repeating transfer from a PayPal account.

For managing financial aspects EDIS provides a web-based client area.

Login at [https://manage.edis.at/whmcs/clientarea.php https://manage.edis.at/whmcs/clientarea.php].

email: <edisUser>

password: <edisPassword>

Note: If the treasurer changes, customer data can be updated via the client area but some fields are read only and require a change request sent via e-mail from <edisUser> to support@edis.at.

== PayPal and Gmail account ==

The center uses a PayPal account for collecting donations and for paying the fees. The name of this PayPal account is an e-mail address connected to the account. The e-mail address is a Google mail address (gmail.com) and the same user and password is used for the Edis customer account, the Paypal account, and the Gmail account. The PayPal account has been upgraded to a 'business account' (free of charge) in order to be able to create the 'Donate' button on the center's web site.

email: <edisUser>

password: <edisPassword>

Center Financial Management Guide

2017-08-28T14:39:56Z

Josef templ: /* EDIS server hosting */

The BlackBox Framework Center periodically spends money for its operation. This memo describes the tasks of the financial manager and the required steps/logins.

== Domain name blackboxframework.org ==

The domain name needs to be paid annually. Currently it costs USD 12.99 per year.
The next expiration date is September 14th, 2018.

Login at [http://name.com http://name.com] or [https://www.name.com https://www.name.com].

user: <dnsUser>

password: <dnsPassword>

Go to "Renew My Domains", then "My Domains list".
In the resulting list with one entry for 'blackboxframework.org' click "Renew Domain".
If the user interface has been changed, look for something similar.

"WhoIs Privacy" is not really required and costs additional money.
Until now we are not using this option.

== EDIS server hosting ==

EDIS server hosting for a virtual root server package (VRS - VRS STARTER) costs EUR 4.99 per month.
The IP address of the virtual root server is 178.209.50.165, located in Switzerland.
It runs a Debian 7 (Wheezy) 32-Bit Linux operating system.

Payment method is set to PayPal.
Payment can be automated by a repeating transfer from a PayPal account.

For managing financial aspects EDIS provides a web-based client area.

Login at [https://manage.edis.at/whmcs/clientarea.php https://manage.edis.at/whmcs/clientarea.php].

email: <edisUser>

password: <edisPassword>

Note: If the treasurer changes, customer data can be updated via the client area but some fields are read only and require a change request sent via e-mail from <edisUser> to support@edis.at.

== PayPal and Gmail account ==

The center uses a PayPal account for collecting donations and for paying the fees. The name of this PayPal account is an e-mail address connected to the account. The e-mail address is a Google mail address (gmail.com) and the same user and password is used for the Edis customer account, the Paypal account, and the Gmail account. The PayPal account has been upgraded to a 'business account' (free of charge) in order to be able to create the 'Donate' button on the center's web site.

email: <edisUser>

password: <edisPassword>

Center Financial Management Guide

2017-08-28T14:14:28Z

Josef templ:

The BlackBox Framework Center periodically spends money for its operation. This memo describes the tasks of the financial manager and the required steps/logins.

== Domain name blackboxframework.org ==

The domain name needs to be paid annually. Currently it costs USD 12.99 per year.
The next expiration date is September 14th, 2018.

Login at [http://name.com http://name.com] or [https://www.name.com https://www.name.com].

user: <dnsUser>

password: <dnsPassword>

Go to "Renew My Domains", then "My Domains list".
In the resulting list with one entry for 'blackboxframework.org' click "Renew Domain".
If the user interface has been changed, look for something similar.

"WhoIs Privacy" is not really required and costs additional money.
Until now we are not using this option.

== EDIS server hosting ==

EDIS server hosting for a virtual root server package (VRS - VRS STARTER) costs EUR 4.99 per month.
The IP address of the virtual root server is 178.209.50.165, located in Switzerland.
It runs a Debian 7 (Wheezy) 32-Bit Linux operating system.

Payment method is set to PayPal.
Payment can be automated by a repeating transfer from a PayPal account.

For managing financial aspects EDIS provides a web-based client area.

Login at [https://manage.edis.at/whmcs/clientarea.php https://manage.edis.at/whmcs/clientarea.php].

email: <edisUser>

password: <edisPassword>

== PayPal and Gmail account ==

The center uses a PayPal account for collecting donations and for paying the fees. The name of this PayPal account is an e-mail address connected to the account. The e-mail address is a Google mail address (gmail.com) and the same user and password is used for the Edis customer account, the Paypal account, and the Gmail account. The PayPal account has been upgraded to a 'business account' (free of charge) in order to be able to create the 'Donate' button on the center's web site.

email: <edisUser>

password: <edisPassword>

Center Financial Management Guide

2017-08-28T14:14:01Z

Josef templ: /* Domain name blackboxframework.org */

The BlackBox Framework Center periodically spends money for its operation. This memo describes the tasks of the financial manager and the required steps/logins.

== Domain name blackboxframework.org ==

The domain name needs to be paid annually. Currently it costs USD 12.99 per year.
The next expiration date is September 14th, 2018.

Login at [http://name.com http://name.com] or [https://www.name.com https://www.name.com].

user: <dnsUser>

password: <dnsPassword>

Go to "Renew My Domains", then "My Domains list".
In the resulting list with one entry for 'blackboxframework.org' click "Renew Domain".
If the user interface has been changed, look for something similar.

"WhoIs Privacy" is not really required and costs additional money.
Until now we are not using this option.

== EDIS server hosting ==

EDIS server hosting for a virtual root server package (VRS - VRS STARTER) costs EUR 4.99 per month.
The IP address of the virtual root server is 178.209.50.165, located in Switzerland.
It runs a Debian 7 (Wheezy) 32-Bit Linux operating system.

Payment method is set to PayPal.
Payment can be automated by a repeating transfer from a PayPal account.

For managing financial aspects EDIS provides a web-based client area.

Login at [https://manage.edis.at/whmcs/clientarea.php https://manage.edis.at/whmcs/clientarea.php].

email: <edisUser>

password: <edisPassword>

== PayPal and Gmail account ==

The center uses a PayPal account for collecting donations and for paying the fees. The name of this PayPal account is an e-mail address connected to the account. The e-mail address is a Google mail address (gmail.com) and the same user and password is used for the Edis customer account, the Paypal account, and the Gmail account. The PayPal account has been upgraded to a 'business account' (free of charge) in order to be able to create the 'Donate' button on the center's web site.

email: <edisUser>

password: <edisPassword>

Center Financial Management Guide

2017-08-28T14:08:02Z

Josef templ:

The BlackBox Framework Center periodically spends money for its operation. This memo describes the tasks of the financial manager and the required steps/logins.

== Domain name blackboxframework.org ==

The domain name needs to be paid annually. Currently it costs USD 12.99 per year.
The next expiration date is September 14th, 2018.

Login at [http://name.com http://name.com] or [https://www.name.com https://www.name.com].

user: <dnsUser>

password: <dnsPassword>

Go to "Renew My Domains", then "My Domains list".
In the resulting list with one entry for 'blackboxframework.org' click "Renew Domain".

"WhoIs Privacy" is not really required and costs additional money.
Until now we are not using this option.

== EDIS server hosting ==

EDIS server hosting for a virtual root server package (VRS - VRS STARTER) costs EUR 4.99 per month.
The IP address of the virtual root server is 178.209.50.165, located in Switzerland.
It runs a Debian 7 (Wheezy) 32-Bit Linux operating system.

Payment method is set to PayPal.
Payment can be automated by a repeating transfer from a PayPal account.

For managing financial aspects EDIS provides a web-based client area.

Login at [https://manage.edis.at/whmcs/clientarea.php https://manage.edis.at/whmcs/clientarea.php].

email: <edisUser>

password: <edisPassword>

== PayPal and Gmail account ==

The center uses a PayPal account for collecting donations and for paying the fees. The name of this PayPal account is an e-mail address connected to the account. The e-mail address is a Google mail address (gmail.com) and the same user and password is used for the Edis customer account, the Paypal account, and the Gmail account. The PayPal account has been upgraded to a 'business account' (free of charge) in order to be able to create the 'Donate' button on the center's web site.

email: <edisUser>

password: <edisPassword>

Center Financial Management Guide

2017-08-28T13:48:41Z

Josef templ: /* Domain name blackboxframework.org */

The BlackBox Framework Center periodically spends money for its operation. This memo describes the tasks of the financial manager and the required steps/logins.

== Domain name blackboxframework.org ==

The domain name needs to be paid annually. Currently it costs USD 12.99 per year.
The next expiration date is September 14th, 2018.

Login at [http://name.com http://name.com] or [https://www.name.com https://www.name.com].

user: <dnsUser>

password: <dnsPassword>

Go to "Renew My Domains", then "My Domains list".
In the resulting list with one entry for 'blackboxframework.org' click "Renew Domain".

"WhoIs Privacy" is not really required and costs additional money.
Until now we are not using this option.

== EDIS server hosting ==

EDIS server hosting for a virtual root server package (VRS - VRS STARTER) costs EUR 4.99 per month.
The IP address of the virtual root server is 178.209.50.165, located in Switzerland.
It runs a Debian 7 (Wheezy) 32-Bit Linux operating system.

Payment method is set to PayPal.
Payment can be automated by a repeating transfer from a PayPal account.

For managing financial aspects EDIS provides a web-based client area.

Login at [https://manage.edis.at/whmcs/clientarea.php https://manage.edis.at/whmcs/clientarea.php].

email: <edisUser>

password: <edisPassword>

== PayPal and Gmail account ==

The center uses a PayPal account for collecting donations and for paying the fees. The name of this PayPal account is an e-mail address connected to the account. The e-mail address is a Google mail address (gmail.com) and the same user and password is used for the Edis customer account, the Paypal account, and the Gmail account. The PayPal account has been upgraded to a 'business account' (free of charge) in order to be able to create the 'Donate' button on the center's web site.

email: <edisUser>

password: <edisPassword>

Center Financial Management Guide

2017-08-28T13:43:50Z

Josef templ: /* PayPal and Gmail account */

The BlackBox Framework Center periodically spends money for its operation. This memo describes the tasks of the financial manager and the required steps/logins.

== Domain name blackboxframework.org ==

The domain name needs to be paid annually. Currently it costs USD 12.99 per year.
The next expiration date is September 14th, 2017.

Login at [http://name.com http://name.com] or [https://www.name.com https://www.name.com].

user: <dnsUser>

password: <dnsPassword>

Go to "Renew My Domains", then "My Domains list".
In the resulting list with one entry for 'blackboxframework.org' click "Renew Domain".

"WhoIs Privacy" is not really required and costs additional money.
Until now we are not using this option.

== EDIS server hosting ==

EDIS server hosting for a virtual root server package (VRS - VRS STARTER) costs EUR 4.99 per month.
The IP address of the virtual root server is 178.209.50.165, located in Switzerland.
It runs a Debian 7 (Wheezy) 32-Bit Linux operating system.

Payment method is set to PayPal.
Payment can be automated by a repeating transfer from a PayPal account.

For managing financial aspects EDIS provides a web-based client area.

Login at [https://manage.edis.at/whmcs/clientarea.php https://manage.edis.at/whmcs/clientarea.php].

email: <edisUser>

password: <edisPassword>

== PayPal and Gmail account ==

The center uses a PayPal account for collecting donations and for paying the fees. The name of this PayPal account is an e-mail address connected to the account. The e-mail address is a Google mail address (gmail.com) and the same user and password is used for the Edis customer account, the Paypal account, and the Gmail account. The PayPal account has been upgraded to a 'business account' (free of charge) in order to be able to create the 'Donate' button on the center's web site.

email: <edisUser>

password: <edisPassword>

Center Financial Management Guide

2017-08-28T07:05:01Z

Josef templ:

The BlackBox Framework Center periodically spends money for its operation. This memo describes the tasks of the financial manager and the required steps/logins.

== Domain name blackboxframework.org ==

The domain name needs to be paid annually. Currently it costs USD 12.99 per year.
The next expiration date is September 14th, 2017.

Login at [http://name.com http://name.com] or [https://www.name.com https://www.name.com].

user: <dnsUser>

password: <dnsPassword>

Go to "Renew My Domains", then "My Domains list".
In the resulting list with one entry for 'blackboxframework.org' click "Renew Domain".

"WhoIs Privacy" is not really required and costs additional money.
Until now we are not using this option.

== EDIS server hosting ==

EDIS server hosting for a virtual root server package (VRS - VRS STARTER) costs EUR 4.99 per month.
The IP address of the virtual root server is 178.209.50.165, located in Switzerland.
It runs a Debian 7 (Wheezy) 32-Bit Linux operating system.

Payment method is set to PayPal.
Payment can be automated by a repeating transfer from a PayPal account.

For managing financial aspects EDIS provides a web-based client area.

Login at [https://manage.edis.at/whmcs/clientarea.php https://manage.edis.at/whmcs/clientarea.php].

email: <edisUser>

password: <edisPassword>

== PayPal and Gmail account ==

The center uses a PayPal account for collecting donations and for paying the fees. The name of this PayPal account is an e-mail address connected to the account. The e-mail address is a Google mail address (gmail.com) and the same user and password is used for both the Paypal and the Gmail account. The PayPal account has been upgraded to a 'business account' (free of charge) in order to be able to create the 'Donate' button on the center's web site.

email: <paypalUser>

password: <paypalPassword>

Center

2017-08-11T09:59:55Z

Josef templ: /* Links */

The "BlackBox Center" is a non-profit voluntary organization dedicated to maintaining the vision and values of the BlackBox/Component Pascal software developed by Oberon microsystems Inc. (Zurich Switzerland). Today the Center is the ''de facto'' standard for BlackBox developers, users, and project managers. The members spearhead projects that, through a collaborative and meritocratic development process, deliver enterprise-quality software attractive to large user communities. We operate under [http://opensource.org/licenses/BSD-2-Clause BSD 2-clause license] to deploy products for business and individuals.

==Mission==

To provide software for the public good, based on the [[Oberon Spirit]]. We do this by keeping alive, adapting, and developing [[Component Pascal]] and [[BlackBox Component Builder]] starting with the [http://www.oberon.ch/blackbox.html last official release (v 1.6)] provided by [[Oberon microsystems AG]] (the "software") and growing and maintaining an international user community.

''The Blackbox Center provides and ensures guidelines and policies to keep the community centered around the mission described above. We are not the sole developers of the software, nor the only providers of the software, but we provide a clearing house to centralize efforts.''

==Values==
As a community we strive to:
* cooperate for the common good;
* make things as simple as possible but not simpler;
* use the idea of component building and let everybody add what they are good at to form something more than the sum of the parts;
* work democratically and meritocratically;
* be good citizens.

==How is the BlackBox Center and its projects governed?==

Members decide issues by voting. Every voting has the option "Abstain".

Votes on issues and proposals are normally called by the [[Chair]]man (or Chairperson).

The vote will be called, at the Chairman's discretion, when a discussion appears to have reached a stable point, or when two members call for a vote. He shall also notify members of the upcoming vote (by using the provided automatic notification tools).

Votes will normally be scheduled to run for five days, and members will be given the opportunity to change their votes during this period. Under appropriate circumstances the Chairman may choose a shorter or longer period.

If significant new or changed information comes to light during the voting period the Chairman may extend or cancel the vote.

At the conclusion of the voting period, and provided the vote is quorate, the vote is decided by simple majority. In the event of a tie the Chairman has a casting vote.

The quorum is given by the formula: "(Number of active Center members) DIV 2 + 1". All votes, including "Abstain" votes, count towards the quorum.

The vote may be decided and terminated early if the result cannot be changed however those who have not yet voted decide to vote (on the assumption that existing votes do not change). This is called the "Short-circuit" rule.

The Chairman is elected by vote on a half yearly basis

New members can be added by vote.

Members can apply for leaving the Center and stay in touch in the special board group 'exCenter' with posting privileges and without voting rights.

Contributions to the software come from the wider community, and the Center members decide what to add, and when, in compliance with our mission, our vision and our values.

==Visions of development for the software==

The following sections illustrate possible projects and priorities for the future of BlackBox. These visions will mature and evolve in the light of experience and input from the wider user community.

===Keeping alive===

* All parts of the software are documented both in source and in an overview document (no "this module is internal" documentations!)
* All OS function calls are checked regularly and if necessary changed so that the software does not use deprecated functions.
* Known bugs are fixed
* There are regular "working releases" and once a year or so there are "major releases", to make sure that the user can rely on the stability of the software.

=== Adapting===
BlackBox is now 20 years old, and the world has changed. We need to adapt.

* Providing a 64-bit version of the software
* Adapting to the changed native look and feel of the OS
* Internationalization of user documentation and user interface
* Implementation of additional GUI elements provided by the OS as part of the standard distribution

===Developing===
Source-Code compatible versions with local look-and-feel for
* Mac OS
* Linux
* JVM
* Dalvik VM
* .NET
* Raspbian…

==Looking beyond our noses==

* When Niklaus Wirth designed the Oberon System, he discouraged multi-tasking on single processor systems, because it only adds complexity (i.e. it is against the values). Over 20 years later, most of our systems are multi-processor systems. Is the current handling of “Actions” still the best practice, or should be implement – in the spirit of Oberon – multi-threading, and if so, how? For instance, we are faced with the problem that the run time system freezes when you keep a mouse key pressed. Is this really necessary, and how can we solve this in the Oberon Spirit?

* Are there new paradigms of user interaction in software development that we could (and probably should) integrate, such as MS IntelliSense? Is it inherently against the Oberon Spirit, or are there ways to provide similar functionality in keeping the Spirit?

==Center tasks==

* to make first version with all known bug fixes
* to maintain stable versions of [[BlackBox Component Builder]]
* provide it's distribution and promotion.

To maintain means:
* regularly (period?) publish new versions of the BlackBox Component Builder;
* support the international BlackBox open-source community;
* adapt the BlackBox Component Builder to modern challenges.

== Links ==

* [https://blackboxframework.org/ Main website]
* [https://forum.blackboxframework.org Center Forum]
* [https://github.com/BlackBoxCenter Public repository and issues tracker]
* [https://redmine.blackboxframework.org/projects/blackbox Center project tracker]

Center Server Administration Guide

2017-07-20T07:21:49Z

Josef templ: /* Certificate extension */

== 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 [https://manage.edis.at/vps/?&lang=en https://manage.edis.at/vps],
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 blackboxframework.org 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 forum.blackboxframework.org -d community.blackboxframework.org -d wiki.blackboxframework.org -d blackboxframework.org -d redmine.blackboxframework.org

service nginx start

For checking the web server status use:

service nginx status

exit

== 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 [http://178.209.50.165/phpmyadmin/ http://178.209.50.165/phpmyadmin/]

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/id_rsa.pub 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

Center Server Administration Guide

2017-07-11T12:11:16Z

Josef templ:

== 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 [https://manage.edis.at/vps/?&lang=en https://manage.edis.at/vps],
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 blackboxframework.org 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. Note that the TMP folder is very small on EDIS, therefore the /tmp directory should be redirected:

sudo su

export TMP="/var/www/tmp"

export TEMP="/var/www/tmp"

export TMPDIR="/var/www/tmp"

export DIRTMP="/var/www/tmp"

service nginx stop

~/certbot-auto certonly --standalone -d forum.blackboxframework.org -d community.blackboxframework.org -d wiki.blackboxframework.org -d blackboxframework.org -d redmine.blackboxframework.org

service nginx start

For checking the web server status use:

service nginx status

exit

== 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 [http://178.209.50.165/phpmyadmin/ http://178.209.50.165/phpmyadmin/]

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/id_rsa.pub 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

Center Server Administration Guide

2017-07-11T11:13:33Z

Josef templ: /* Certificate extension */

== 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 [https://manage.edis.at/vps/?&lang=en https://manage.edis.at/vps],
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 blackboxframework.org 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. Note that the TMP folder is very small on EDIS, therefore the /tmp directory should be redirected:

sudo su

export TMP="/var/www/tmp"

export TEMP="/var/www/tmp"

export TMPDIR="/var/www/tmp"

export DIRTMP="/var/www/tmp"

service nginx stop

~/certbot-auto certonly --standalone -d forum.blackboxframework.org -d community.blackboxframework.org -d wiki.blackboxframework.org -d blackboxframework.org -d redmine.blackboxframework.org

service nginx start

For checking the web server status use:

service nginx status

exit

== 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 [http://178.209.50.165/phpmyadmin/ http://178.209.50.165/phpmyadmin/]

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/id_rsa.pub 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 &

Center Server Administration Guide

2017-06-13T08:42:51Z

Josef templ: /* Backup Files */

== 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 [https://manage.edis.at/vps/?&lang=en https://manage.edis.at/vps],
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 blackboxframework.org 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. Note that the TMP folder is very small on EDIS, therefore the TMP variable should be redefined:

export TMP="/var/www/tmp"

export TEMP="/var/www/tmp"

service nginx stop

sudo ./certbot-auto certonly --standalone -d forum.blackboxframework.org -d community.blackboxframework.org -d wiki.blackboxframework.org -d blackboxframework.org -d redmine.blackboxframework.org

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 [http://178.209.50.165/phpmyadmin/ http://178.209.50.165/phpmyadmin/]

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/id_rsa.pub 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 &