01. Installation manual

BlissRADIUS installation manual

Installation manual is the first thing you should read. It is aimed to sys admins and informs about program requirements, installation procedure and what to do if procedure fails.

System requirements for Windows and Linux

PostgreSQL 9.1 is part of installer, so there is no need for separate installation. It runs on port 9000 so it will not interfere with standard PostgreSQL server port.

Choice of operating system

Both Linux and Windows systems work equally reliable with BlissRADIUS. Ease of maintenance is most important so select OS you are more familiar with.

Installation procedure steps

  1. Download installer from this website. It is provided as .exe file for Windows and .sh shell installation script for Linux.
  2. Run it by double clicking it on Windows or typing shell command sh blissradius-X.Y.Z.sh on Linux. where X.Y.Z is version downloaded.
  3. Follow instructions during installation untill installer is finished.
  4. Open web browser from same computer and go to URL http://localhost:8800. Login to admin portal with username admin and password admin. If you are accessing installation on remote computer, replace localhost with servers address.

How to configure program to run on computer start

BlissRADIUS is registered as automatic service on Windows by default, so each time you turn on computer it will start without your intervention.

On Linux you must add start command to your system specific boot up script, eg. /etc/rc.local. Append following line:

/blissradius/bin/bliss_ctl start

Don't forget to remove exit 0 line if it is mentioned in script.

Troubleshooting in case of install failure

Common reasons for failure are:

  1. Antivirus or some other form of protection like SELinux is preventing installer to do its job.
  2. There is firewall blocking access to admin portal at port 8800.
  3. If you are installing on remote computer, then there is problem with NAT or firewall configuration that makes remote computer unreachable from where you are.
  4. There is already webservice, PostgreSQL or other process listening on TCP port 8800, 8801 or 9000.

You can try this to fix the problem:

  1. Open command prompt or console and type in C:\BlissRADIUS\bin\bliss_ctl.exe status on Windows or /blissradius/bin/bliss_ctl status on Linux to get BlissRADIUS service status. These are default installation paths.
    • If file or whole folder is missing, then installer didn't manage to run correctly at all. It is most likely antivirus or privilege problem. Try reinstalling.
    • Is database and bliss process running? If so, then it is probably a firewall or network issue that prevent you to log in to admin portal.
    • If only one of them is running, then you probably have some other program already using ports 8800, 8801 or 9000.
  2. If service is not running, then try starting it manually by typing in C:\BlissRADIUS\bin\bliss_ctl.exe start on Windows or /blissradius/bin/bliss_ctl start on Linux.
    • What is programs output? If service complains and fails to start then check error log for more information. Default locations are C:\BlissRADIUS\data\stderr.log for Windows and /blissradius/data/stderr.log for Linux.
  3. If you can't make it work by yourself, contact us and we will help you in no time. Don't forget to provide us with error log and program output you got.
2018-06-27
BlissRADIUS Embedded™ 1.6 is out with incremental improvements and new usability features.
2018-03-31
BlissRADIUS Embedded™ 1.5 is released with new proxy features and advanced caching for better resilience.
2018-03-04
BlissRADIUS Embedded™ 1.4 maintenance release is out! No significant changes, lot of small fixes. And we finally updated documentation on custom integration.
2017-12-02
BlissRADIUS Embedded™ 1.3 is released. It is incremental release with more fixes and tweaks than new features.
2017-06-05
BlissRADIUS Embedded™ 1.2 is out! It brings many performance and stability enhancements.
2016-11-05
BlissRADIUS Embedded™ 1.0 is out! This is important milestone that marks more than a year of successful production use. 1.0 is backward compatible with 0.x and brings incremental improvements and bug fixes.
2016-09-26
BlissRADIUS Embedded™ 0.9 brings integration with Blesta billing. There is also a new "local" standalone mode to run program without third-party billing. Manual has been updated accordingly.