Backup JIRA Software

Rate this post

На фоне всякого рода сбоев и вирусов, многие начинают вспоминать о резервных копиях и все те, кто не поскупился на резервное хранилище достаточных объемов, чувствуют себя спокойно. Ну а кто «скряга» – тому и не возможно объяснить поговорку: «Скупой платит дважды».

Сегодня поговорим о продуктах Atlassian, а конкретнее о Jira и Confluence и ручном бекапе

Что надо бекапить

Первое что нужно понять – что и зачем бекапить. У приведенных выше продуктов можно делать полный и частичный бэкапы.

Частичный бекап

Jira
1. Папку export
2. Папку data
Confluence
1. Папку backups
2. Папку attachments

Это позволит сэкономить место и время. Конечно, для восстановления потребуется рабочие Jira и/или Confluence.

Уточнение:

указанные папки желательно синхронизировать с удаленных хранилищем, так как файлы в них могут добавляться, удалятся или изменятся.
Файлы в папках export и/или backups – это резервная копия, которая делается при помощи приложения Jira и Confluence соответственно. В них находятся метаданные и пользовательские данные из БД, в формате ПО Atlassian.
Файлы в папках data и/или attachments – это прикрепленные файлы(изображения, документы и т.п.) в Jira и/или Confluence

Полный бекап

Полный бэкап – это расширенная версия частичного. В нем делается бекап папки установки и папки с данными. Если по поводу папки установки более-менее понятно, то вот папка с данными может вызвать вопрос.

Что бы найти путь к папке с данными, следует посмотреть:

Jira
- Файл sh/setenv.bat и найти в нем переменную JIRA_HOME
- Файл jira-application.properties и в нем посмотреть на переменную jira.home
Confluence
- Файл confluence-init.properties и найти в нем переменную home

Теперь, когда мы знаем пути, то следует:

Остановить Jira и/или Confluence
Сделать дамп БД
Заархивировать все (папку инсталляции, папку данных и дамп БД)
Положить в надежное место

После этого, любой сбой и потеря данных в ПО не проблема.

Как мы делаем

Если очень коротко, то мы комбинируем первый и второй варианты. Раз в месяц мы делаем полный бэкап. А каждую ночь частичный. Конечно же, перед всякого рода бекапом, мы удаляем старые файлы export и/или backups, а файлы в data и/или attachments – во время частичного бекапа, синхронизируем с удаленным хранилищем.

Ниже будет будет небольшой скрипт, который делает резервную копию. В нем не сложно разобраться. Строки 3,4,5 задают путь к папкам бекапа инсталляции, данных и БД.

Далее идет функция остановки ПО, создания нужных папок для бекапа и синхронизация при помощи rsync.

Ну и в самом конце перед началом бекапа идет проверка, не запущен ли бекап уже. Плюс в этом скрипте – подробный лог-действий.

#!/bin/bash
TIMESTAMP=`date '+%d%m%y_%H%M%S'`
INSTALL_BACKUP="/srv/backup/atlassian_install_backup_$TIMESTAMP"
HOME_BACKUP="/srv/backup/atlassian_home_backup_$TIMESTAMP"
DATABASE_BACKUP="/srv/backup/atlassian_db_backup_$TIMESTAMP"
BACKUP_LOG_FILE="atlassian_backup_${TIMESTAMP}.log"
PID_FILE="/var/run/atlassian-backup.pid"

# Print messages to log file
_log() {
    echo "$(date '+%b %d %T') $1: $2" >> $LOG_FILE
}

# Creating backups
_create_backup() {
    systemctl stop jira; JIRA_STOP_STATUS=$?
    sleep 10
    systemctl stop confluence; CONFL_STOP_STATUS=$?
    sleep 10
    if [ $JIRA_STOP_STATUS -eq 0 ] && [ $CONFL_STOP_STATUS -eq 0 ]; then
	MSG="Atlassian services stopped successfully"
	_log INFO $MSG

	mkdir -p $INSTALL_BACKUP
	if [ -d $INSTALL_BACKUP ]; then
	    MSG="Creating installation directory backups"
	    _log INFO $MSG
	    rsync -avhP /opt/atlassian/ $INSTALL_BACKUP; INSTALL_BACKUP_STATUS=$?
	    if [ $INSTALL_BACKUP_STATUS -eq 0 ]; then
		MSG="... Created"
		_log INFO $MSG
	    else
		MSG="... Failed"
		_log ERROR $MSG
		exit 1
	    fi
	else
	    MSG="Installation backup directory doesn't exist"
	    _log ERROR $MSG
	    exit 1
	fi
        mkdir -p $HOME_BACKUP
        if [ -d $HOME_BACKUP ]; then
            MSG="Creating home directory backups"
            _log INFO $MSG
	    rsync -avhP /var/atlassian/application-data/ $HOME_BACKUP; HOME_BACKUP_STATUS=$?
            if [ $HOME_BACKUP_STATUS -eq 0 ]; then
                MSG="... Created"
                _log INFO $MSG
            else
                MSG="... Failed"
                _log ERROR $MSG
                exit 1
            fi
        else
            MSG="Home backup directory doesn't exist"
            _log ERROR $MSG
            exit 1
	fi
        mkdir -p $DATABASE_BACKUP
        if [ -d $DATABASE_BACKUP ]; then
            MSG="Creating database backups"
            _log INFO $MSG
            pg_dump -U postgres jiradb > $DATABASE_BACKUP/jiradb.sql && pg_dump -U postgres confldb > $DATABASE_BACKUP/confldb.sql; DB_BACKUP_STATUS=$?
            if [ $DB_BACKUP_STATUS -eq 0 ]; then
                MSG="... Created"
                _log INFO $MSG
            else
                MSG="... Failed"
                _log ERROR $MSG
                exit 1
            fi
        else
            MSG="Database backup directory doesn't exist"
            _log ERROR "$MSG"
            exit 1
	fi
    else
        MSG="Failed to stop atlassian services"
        _log ERROR $MSG
	exit 1
    fi

    systemctl start jira; JIRA_START_STATUS=$?
    sleep 30
    systemctl start confluence; CONFL_START_STATUS=$?
    sleep 30
    if [ $JIRA_START_STATUS -eq 0 ] && [ $CONFL_START_STATUS -eq 0 ]; then
        MSG="Atlassian services started successfully"
        _log INFO $MSG
    else
        MSG="Failed to start atlassian services"
        _log ERROR $MSG
	exit 1
    fi
}
if [ ! -f $PID_FILE ]; then
    echo $$ > $PID_FILE
    _create_backup
else
    $MSG="Script is already started"
    echo "$MSG"
    _log ERROR $MSG
    exit 1
fi

100

101

102

103

104

105

#!/bin/bash

TIMESTAMP=`date '+%d%m%y_%H%M%S'`

INSTALL_BACKUP="/srv/backup/atlassian_install_backup_$TIMESTAMP"

HOME_BACKUP="/srv/backup/atlassian_home_backup_$TIMESTAMP"

DATABASE_BACKUP="/srv/backup/atlassian_db_backup_$TIMESTAMP"

BACKUP_LOG_FILE="atlassian_backup_${TIMESTAMP}.log"

PID_FILE="/var/run/atlassian-backup.pid"

# Print messages to log file

_log() {

echo "$(date '+%b %d %T') $1: $2" >> $LOG_FILE

}

# Creating backups

_create_backup() {

systemctl stop jira; JIRA_STOP_STATUS=$?

sleep 10

systemctl stop confluence; CONFL_STOP_STATUS=$?

sleep 10

if [ $JIRA_STOP_STATUS -eq 0 ] && [ $CONFL_STOP_STATUS -eq 0 ]; then

MSG="Atlassian services stopped successfully"

_log INFO $MSG

mkdir -p $INSTALL_BACKUP

if [ -d $INSTALL_BACKUP ]; then

MSG="Creating installation directory backups"

_log INFO $MSG

rsync -avhP /opt/atlassian/ $INSTALL_BACKUP; INSTALL_BACKUP_STATUS=$?

if [ $INSTALL_BACKUP_STATUS -eq 0 ]; then

MSG="... Created"

_log INFO $MSG

else

MSG="... Failed"

_log ERROR $MSG

exit 1

else

MSG="Installation backup directory doesn't exist"

_log ERROR $MSG

exit 1

mkdir -p $HOME_BACKUP

if [ -d $HOME_BACKUP ]; then

MSG="Creating home directory backups"

_log INFO $MSG

rsync -avhP /var/atlassian/application-data/ $HOME_BACKUP; HOME_BACKUP_STATUS=$?

if [ $HOME_BACKUP_STATUS -eq 0 ]; then

MSG="... Created"

_log INFO $MSG

else

MSG="... Failed"

_log ERROR $MSG

exit 1

else

MSG="Home backup directory doesn't exist"

_log ERROR $MSG

exit 1

mkdir -p $DATABASE_BACKUP

if [ -d $DATABASE_BACKUP ]; then

MSG="Creating database backups"

_log INFO $MSG

pg_dump -U postgres jiradb > $DATABASE_BACKUP/jiradb.sql && pg_dump -U postgres confldb > $DATABASE_BACKUP/confldb.sql; DB_BACKUP_STATUS=$?

if [ $DB_BACKUP_STATUS -eq 0 ]; then

MSG="... Created"

_log INFO $MSG

else

MSG="... Failed"

_log ERROR $MSG

exit 1

else

MSG="Database backup directory doesn't exist"

_log ERROR "$MSG"

exit 1

else

MSG="Failed to stop atlassian services"

_log ERROR $MSG

exit 1

systemctl start jira; JIRA_START_STATUS=$?

sleep 30

systemctl start confluence; CONFL_START_STATUS=$?

sleep 30

if [ $JIRA_START_STATUS -eq 0 ] && [ $CONFL_START_STATUS -eq 0 ]; then

MSG="Atlassian services started successfully"

_log INFO $MSG

else

MSG="Failed to start atlassian services"

_log ERROR $MSG

exit 1

}

if [ ! -f $PID_FILE ]; then

echo $$ > $PID_FILE

_create_backup

else

$MSG="Script is already started"

echo "$MSG"

_log ERROR $MSG

exit 1

Следует отметить, что:

Используется БД postgres
Пароль от БД указан непосредственно в сроке выгрузки дамп
Нет проверки на остановку ПО Atlassian(из практики, последнии версии 7.3.х страдают долгим выключением и тем, что оставляют за собой мусор.)