Technical Documentation
For now this page will kind of serve as a "brain dump" until such time as I have enough information to divide it up into categories and separate pages.
Feathur currently uses Power DNS to process and respond to rDNS requests. If you wish to use the system you'll need to have your server provider point the rDNS authority at Feathur.
Feathur stores rDNS records in the dns table in the database. Power DNS uses the records stored in the database to respond to requests.
Feathur has a "bridge" setup which automatically logs administrators on Feathur into PHPMyAdmin at /phpmyadmin on typical installations. Users with permissions set to "7" in the database have access to PHPMyAdmin and the administrative area.
Feathur stores its SSH RSA keys in text files in /var/feathur/data/keys
Templates and ISOs are stored in /var/feathur/data/templates/virt and are synced automatically using SSH and Rsync. If a template fails to sync check that rsync is installed on the target server.
Bandwidth calculations on OpenVZ rely on PMACCTD which is different from most other panels. It is possible to use iptables, but we've found that PMACCTD is more accurate and doesn't have as many loop holes in measuring bandwidth.
Bandwidth calculations on KVM aren't completed yet, we plan to use ifconfig to determine usage.
The update system supports automatic and "forced" updates. Updates are done by pulling the latest version from GitHub. Currently all copies pull from the "develop" branch. In the future we'll start using the master branch (once Feathur is > 1.0).
The server status system is based on our original system status script (which was later taken and made popular by Mojeda). The system uses php-curl to pull the uptime.php stored on each server.
Feathur issues and activation email for each new user added to the system. The activation email allows the user to set a password for the first time. Should the user not recieve the activation email you can make one for them to use by:
- Login to Feathur, go into PHPMyAdmin
- Go under panel => accounts
- Find the user (either by their email or by name).
- Create a URL like such based on the user's account information
https://your-hostname.com:2026/activate.php?id=USERS_ACTIVATION_CODE&email=USERS_EMAIL_ADDRESS
If the VPS isn't starting up login to the host node and use the steps bellow to troubleshoot:
Issue these commands (fill in blanks): cd /var/feathur/configs/ virsh create kvm####-vps.xml [The numbers are the container id from the control panel.]
Results may be as follows:
- Domain created
- Great, maybe feathur couldn't connect momentarily...
- ISO is missing.
- Wget the ISO from your master server (EG: wget http://yourip/templates/kvm/missing.iso)
- error: internal error unable to add domain kvm5498 task 28072 to cgroup: No space left on device
- service cgconfig restart (wait 30 seconds)
- service libvirtd restart
- Attempt startup again
- error: Unable to create cgroup for kvm5498: No such file or directory
- service cgconfig restart (wait 30 seconds)
- service libvirtd restart
- Attempt startup again