https://github.com/gbv/libsites

Standortinformationen für GBV-Bibliotheken
https://github.com/gbv/libsites

Last synced: 28 days ago
JSON representation

Standortinformationen für GBV-Bibliotheken

• Host: GitHub
• URL: https://github.com/gbv/libsites
• Owner: gbv
• License: agpl-3.0
• Created: 2012-12-17T11:42:02.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2024-04-02T05:52:49.000Z (10 months ago)
• Last Synced: 2024-11-10T03:17:58.175Z (3 months ago)
• Language: Perl
• Homepage: http://uri.gbv.de/organization/
• Size: 486 KB
• Stars: 0
• Watchers: 5
• Forks: 0
• Open Issues: 13
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# NAME

libsites - GBV-Standortverzeichnis

# SYNOPSIS

The application is automatically started as service, listening on port 6013

    sudo service libsites {status|start|stop|restart}

# DESCRIPTION

libsites implements an RDF-based web registry of library locations.

# INSTALLATION

Create user `libsites` and directories:

    sudo adduser --home /srv/libsites --disabled-password libsites

    sudo mkdir /etc/libsites /var/log/libsites

    sudo chown libsites:libsites /etc/libsites /var/log/libsites

Install dependencies:

    sudo apt-get install git libcatmandu-perl librdf-trine-perl libgit-repository-perl liblog-contextual-perl starman 

Clone this repository as user `libsites` in `/srv/libsites`

    sudo -iu libsites

    git clone --bare https://github.com/gbv/libsites.git .git

    git config --unset core.bare

    git checkout .

    git clone https://github.com/gbv/libsites-config.git /etc/libsites

    ln -s /etc/libsites libsites-config

Locally install Perl libraries

    make -B local

The actual content is retrieved from the German ISIL directory (hosted by ZDB)

and the git repository  among other sources.

Initally update data of libraries (will take a while):

    perl -Ilib -Ilocal/lib/perl5 bin/update all

Add a cronjob (`crontab -e`) to daily update the data, e.g.

    10 03 * * * perl -Ilib -Ilocal/lib/perl5 bin/update all

Switch back to root and enable the service by copying `libsites.init` to `/etc/init.d/libsites` and update runlevel directories with `update-rc.d libsites defaults`. then start the service

    sudo cp /srv/libsites/libsites.init /etc/init.d/libsites

    sudo update-rc.d libsites defaults

    sudo service libsites start

After installation the service is available at localhost on port 6013. Better

put the service behind a reverse proxy to enable SSL and nice URLs!

# ADMINISTRATION

## Updates of content

A full update is run daily and logged to `/var/log/libsites/update.log`. At URL

path `/update` there is also a GitHub Webhook to trigger update from configuration

repository `libsites-config`. The update script can be run manually as following:

    cd /srv/libsites && sudo -u libsites perl -Ilib -Ilocal/lib/perl5 bin/update all

Remove the parameter `all` for usage help.

## Logging

Log files are written in `/var/log/libsites/` and kept for 30 day by default:

* `access.log` - HTTP request and responses in Apache Log Format

* `server.log` - Web server messages (when server was started and stopped)

* `update.log` - Update script output

# SEE ALSO

The source code of libsites is managed in a public git repository at

. Please report bugs and feature request at

!