Universal Logging System

Download the uls-server-1.9.2.tgz and follow the installation instruction for different operating systems.

Remember that have to do some configurations before starting to use the ULS-server! That is described in ULS Basic Configuration below.

The ULS-server is packed as uls-server-1.9.6.tgz

Install the operating system and chose the software: SSH-server, Standard-system tools

Become root and install Maria-DB:

# apt-get install mariadb-server libmariadb-dev

Enter the password for mysql-root and file it for further use.

Install gcc for compiling the u2webtools:

# apt-get install build-essential libssl-dev

Install gnuplot for the generation of charts:

# apt-get install gnuplot

Install recode:

# apt-get install recode

Install gnu-awk (needed for the processing of start-stop tuples):

# apt-get install gawk

Install wkhtmltopdf from wkhtmltopdf.org

# apt-get install libpng12-0                # may be required on Raspbian
# dpkg -i wkhtmltox_<version>.deb

Add language support for at least german and english, mark “de_DE.UTF-8 UTF-8” and “en_US.UTF-8 UTF-8”:

# dpkg-reconfigure locales

Unpack the ULS-server, version 1.9.6:

# tar xf ULS-Server-1.9.6.tgz
# cd ULS-Server-1.9.6

Install u2webtools from u2webtools-mariadb_9.7-7debian10_amd64.deb or u2webtools-mariadb_9.7-7debian11_amd64.deb

Adjust Maria-DB configuration

# vi /etc/mysql/mariadb.conf.d/50-server.cnf 
...
max_allowed_packet   = 64M
max_connections      = 2000
group_concat_max_len = 1024000
sql_mode             = ''

and restart Maria-DB with:

# systemctl restart mysql

Start the installation:

# cd ulsserver
# ./installuls.sh

You will be prompted for the mysql-root password. On Debian 10 and 11 hit return for no password.

Now, the ULS-server is running and waits for its base configuration.

Point your webbrowser to 'htts:localhost/' and login as user 'admin', password 'NewAdmin'. Continue with the install. —– ==== ULS Basic Configuration ==== You must make configurations to the ULS-server! Use your webbrowser, open https://localhost/ and login as user 'admin', password 'NewAdmin'. This may be English or German, depending on your browser settings. “Server” → “Server anlegen” {| !Sin: |<ServerIdentNumber> |- !Servername: |<Servername> (short name) |- !domain: |chose - each source must be related to a domain |- !IP-address: |IP-address from which agents send values to the ULS-server |- !transfer-IP: |a probably existing alternative IP-address, second interface |- !value-IPs: |alternate or virtual IP-address from which agents send values to the ULS-server. Mainly used in cluster environments |} the following is not finished yet. “main menu” “User” → “User anlegen” Ggf. Button “alle Verfahren”, damit das Verfahren des Clients erscheint. Haken unter Verfahren setzen. “OK” Install the ULS-client for Linux Double-click on file “uls-client_3.14-5debian10_amd64.deb” or “uls-client_3.14-5debian11_amd64.deb” and install the package using the GDebi installation program. <code bash> $ vi /etc/uls/uls.conf … ULSSERVER=ulsap:11976 </code> Check directory /tmp/uls for files, should look like: <code bash> $ ls -al /var/tmp/uls drwxrwxrwt 2 uls ulsuser 4096 Dez 23 14:40 . drwxrwxrwt 14 root root 299008 Dez 23 14:40 .. -rw——- 1 root root 929 Dez 23 14:40 dat-0-8550.uls -rw——- 1 root root 789 Dez 23 14:40 dat-0-8575.uls -rw——- 1 root root 400 Dez 23 14:40 dat-0-8602.uls -rw——- 1 root root 381 Dez 23 14:40 dat-0.uls -rw——- 1 uls ulsuser 720 Dez 23 14:39 dat-900.uls </code> If no files are shown, check the crontab entries: <code bash> $ cd /etc/cron.d/ $ cat ulsclient </code> to verify that the crontab file has been created and the entries are activated. If the files do not disappear (not transferred to the ULS-server), try: <code bash> $ sudo flush_test_values -t </code> further explanation is needed. To check, if an error condition exists, e.g. “ERROR from ULS-Server: NOSRV”, which means that the current hostname has not been set up as server. Setup a user that can access the ULS domain! Values should appear after about 5 to 10 minutes. —– ==== Update ==== Update from version 1.6.0 or newer to version 1.9.2 Install the u2webtools-9.4.5 from the install package. Unpack uls-update-1.9.2.tgz and run the updatescript: <code bash> tar xf uls-update-1.9.2.tgz cd update ./uls_update.sh <db-root-user> </code> After updates from versions previous to 1.8.0 the user “admin” will have a new password: “NewAdminV1.8”.