Skip to content
A system for collecting key information from all your servers and presenting it through an easy-to-use web GUI with search and browse functions. The previous generation of this system is used in production at the University of Oslo, Norway.
Go Perl Shell JavaScript HTML PowerShell Other
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
client
debian Update Debian changelog Dec 10, 2019
rpm
server Overwrite cache entries instead of remove + add Jan 8, 2020
tests Bugfix: renewcert must notify the system service Jan 8, 2020
.gitignore
CODE_OF_CONDUCT.md
LICENSE.txt
README.md

README.md

Getting started

Install the server

  1. Spin up a clean VM running Fedora 30, 29, RHEL 7, or CentOS 7
  2. If you're using RHEL or CentOS, you need to enable the EPEL package repository.
sudo yum install -y epel-release
  1. Configure the package repository.
    • Fedora:
    sudo dnf copr enable oyvindh/Nivlheim
    
    • CentOS / RHEL:
    sudo yum install -y yum-plugin-copr
    sudo yum copr enable oyvindh/Nivlheim
    

or go to the project page at Fedora Copr, download the appropriate repository config file, and place it in /etc/yum.repos.d/

  1. Install the packages:
sudo dnf -y install nivlheim-server nivlheim-client
  1. Open the web admin interface in a browser: https://<your server>/

At this point, there's no data in the system, because no clients have been configured yet.

Get the client running

  1. Edit /etc/nivlheim/client.conf, add one line:
server=localhost
  1. The client package has already configured a cron job, but to speed things up you can manually run the client:
sudo /usr/sbin/nivlheim_client
  1. Open the web admin interface in a browser, go to "Settings", and you should see that there's a new machine waiting to be approved. Click "approve".

  2. Run the client one more time:

sudo /usr/sbin/nivlheim_client
  1. Wait a few seconds, and refresh the web page. You should see some information about the machine. It takes a few seconds for the system to process before it shows up.

Install more clients

  1. Spin up a new VM or use another existing machine.

  2. Configure the package repository as detailed above.

  3. Install the nivlheim-client package.

sudo dnf -y install nivlheim-client
  1. Edit /etc/nivlheim/client.conf, add one line with the server hostname or ip address
server=yourserver.example.com
  1. If you are using a self-signed certificate for the web server (by default the nivlheim_server package will set it up with one), then the CA certificate file must be distributed to the clients.
    Copy /var/www/nivlheim/CA/nivlheimca.crt from the server, and place it in /var/nivlheim on the machine you're installing the client software on.

  2. Run /usr/sbin/nivlheim_client manually (as root), or wait for cron to run it (could take up to 5 minutes).

  3. On the web admin pages the new machine will show up as waiting for approval. After it has been approved, and the client has run one more time, data from it will start showing up in the system.

How to contribute

  • Do you have a suggestion, feature request, or idea? Or have you found a bug? Go to the "issues" page and create a new issue! Everything is welcome.
  • Would you like to contribute code? Fork the repository and create a pull request! We try to use the GitHub workflow. You can also ask to be added as a collaborator.
  • Questions? Contact me at oyvind.hagberg@usit.uio.no
You can’t perform that action at this time.