Logserver - Installation

 Installing LogServer

Yarra LogServer (YLS) is currently built and packaged for Ubuntu 18.04 and 20.04.

YLS is not designed to be made available to the internet. It should never be made available outside your internal network. The system uses common-sense security measures to protect patient data, but it was not designed to withstand a determined attack across the public internet.

Installation is simple. First, download the most recent yarralogserver package for your Ubuntu version here.

On Ubuntu 18.04, install it like this:

sudo dpkg -i <the package>.deb && sudo apt-get install -f

On Ubuntu 20.04, this is the recommended method:

sudo apt install ./<the package>.deb

After installation, initialize the database locally by running

sudo /opt/yarralogserver/dbinit.sh

To verify that it has been installed correctly, visit https://localhost:4444 to open the web-based admin interface. You will probably have to click through a security warning regarding the self-signed certificate that the server is using (the server will not respond to unencrypted http requests). This is expected and not an error.

If the login page does not appear, check the health of the yarralogviewer process. Any number of things might have broken it here. If it looks like it’s something we broke, please get in touch.

sudo systemctl status yarralogviewer

The next thing to check is the health of the LogServer service. This is the process that receives and stores the information coming from the clients. Navigate to https://localhost:4443/test, which should give you an empty page, but not error. This verifies that the LogServer is running and accepting connections.

Now that the software is installed, before it can be used it must be configured .