====== Sentry ======

Sentry to oprogramowanie do zbierania i zarządzania logami z innych aplikacji.

===== Instalacja =====

Zaczynamy od zainstalowania następujących zależności:

<code bash>
# Oprogramowanie
apt-get install redis-server
apt-get install supervisor
apt-get install build-essential
apt-get install python-pip
# Dodatkowe biblioteki
apt-get install python-dev
apt-get install libpq-dev
apt-get install libxslt1-dev
apt-get install libffi-dev
apt-get install libjpeg-dev
apt-get install libyaml-dev
# Instalator pakietów Pythona i środowisko wirtualne
pip install --upgrade pip
pip install --upgrade virtualenv
</code>

Tworzymy użytkownika ''sentry'' z własnym katalogiem domowym. Instalację wykonamy w katalogu ''/home/sentry/httpdocs''.

<code bash>
adduser sentry
</code>

Sentry najlepiej współpracuje z bazą PostgreSQL.

<code bash>
apt-get install postgresql
su - postgres
psql
</code>

===== Aktualizacja =====

Przed aktualizacją zalecam zrobienie kopii plików konfiguracyjnych, bazy danych, a najlepiej całej maszyny wirtualnej.

<code bash>
# Przechodzimy do katalogu z aplikacją

cd /home/sentry/httpdocs

# Aktywujemy środowisko wirtualne

source /home/sentry/httpdocs/bin/activate

# Tworzymy zmienną środowiskową wskazującą na lokalizację pliku konfiguracyjnego.

export SENTRY_CONF=/home/sentry/httpdocs
</code>

Pora na właściwą aktualizację. Aby ją przeprowadzić wystarczą dwa polecenia:

<code bash>
pip install --upgrade pip # Opcjonalnie
pip install --upgrade sentry
sentry upgrade
</code>

<WRAP center round important 80%>
Uwaga: podczas aktualizacji do wersji 8.19.0 trzeba było dodatkowo doinstalować pakiet ''postgresql-contrib'' i tymczasowo nadać uprawnienia superużytkownika dla użytkownika ''sentry'' w bazie postgres.
</WRAP>

<code bash>
su postgres
\psql
ALTER ROLE sentry SUPERUSER;
\q
exit           # Wyjście z użytkownika postgres

sentry upgrade # Teraz powinno się udać

su postgres    # Ponownie odbieramy uprawnienia
\psql
ALTER ROLE sentry NOSUPERUSER;
\q
exit
</code>

Jeżeli wystąpią zmiany w pliku konfiguracyjnym ''/home/sentry/httpdocs/sentry.conf.py'', możemy zrobić jego kopię i wygenerować nowy plik celem ich porównania:

<code bash>
sentry init
</code>

Jeżeli wszystko się udało, możemy opuścić środowisko wirtualne:

<code bash>
deactivate
</code>