Commit 8d569f9f authored by Lin Jen-Shin's avatar Lin Jen-Shin

Document that we need rsync for backing up

parent f10fb6c2
...@@ -64,7 +64,7 @@ up-to-date and install it. ...@@ -64,7 +64,7 @@ up-to-date and install it.
Install the required packages (needed to compile Ruby and native extensions to Ruby gems): Install the required packages (needed to compile Ruby and native extensions to Ruby gems):
sudo apt-get install -y build-essential zlib1g-dev libyaml-dev libssl-dev libgdbm-dev libre2-dev libreadline-dev libncurses5-dev libffi-dev curl openssh-server checkinstall libxml2-dev libxslt-dev libcurl4-openssl-dev libicu-dev logrotate python-docutils pkg-config cmake sudo apt-get install -y build-essential zlib1g-dev libyaml-dev libssl-dev libgdbm-dev libre2-dev libreadline-dev libncurses5-dev libffi-dev curl openssh-server checkinstall libxml2-dev libxslt-dev libcurl4-openssl-dev libicu-dev logrotate rsync python-docutils pkg-config cmake
Ubuntu 14.04 (Trusty Tahr) doesn't have the `libre2-dev` package available, but Ubuntu 14.04 (Trusty Tahr) doesn't have the `libre2-dev` package available, but
you can [install re2 manually](https://github.com/google/re2/wiki/Install). you can [install re2 manually](https://github.com/google/re2/wiki/Install).
......
...@@ -5,8 +5,8 @@ ...@@ -5,8 +5,8 @@
An application data backup creates an archive file that contains the database, An application data backup creates an archive file that contains the database,
all repositories and all attachments. all repositories and all attachments.
You can only restore a backup to **exactly the same version and type (CE/EE)** You can only restore a backup to **exactly the same version and type (CE/EE)**
of GitLab on which it was created. The best way to migrate your repositories of GitLab on which it was created. The best way to migrate your repositories
from one server to another is through backup restore. from one server to another is through backup restore.
## Backup ## Backup
...@@ -14,6 +14,19 @@ from one server to another is through backup restore. ...@@ -14,6 +14,19 @@ from one server to another is through backup restore.
GitLab provides a simple command line interface to backup your whole installation, GitLab provides a simple command line interface to backup your whole installation,
and is flexible enough to fit your needs. and is flexible enough to fit your needs.
### Requirements
If you're using GitLab with the Omnibus package, you're all set. If you
installed GitLab from source, make sure the following packages are installed:
* rsync
If you're using Ubuntu, you could run:
```
sudo apt-get install -y rsync
```
### Backup timestamp ### Backup timestamp
>**Note:** >**Note:**
...@@ -431,7 +444,7 @@ The [restore prerequisites section](#restore-prerequisites) includes crucial ...@@ -431,7 +444,7 @@ The [restore prerequisites section](#restore-prerequisites) includes crucial
information. Make sure to read and test the whole restore process at least once information. Make sure to read and test the whole restore process at least once
before attempting to perform it in a production environment. before attempting to perform it in a production environment.
You can only restore a backup to **exactly the same version and type (CE/EE)** of You can only restore a backup to **exactly the same version and type (CE/EE)** of
GitLab that you created it on, for example CE 9.1.0. GitLab that you created it on, for example CE 9.1.0.
### Restore prerequisites ### Restore prerequisites
...@@ -511,7 +524,7 @@ sudo service gitlab restart ...@@ -511,7 +524,7 @@ sudo service gitlab restart
This procedure assumes that: This procedure assumes that:
- You have installed the **exact same version and type (CE/EE)** of GitLab - You have installed the **exact same version and type (CE/EE)** of GitLab
Omnibus with which the backup was created. Omnibus with which the backup was created.
- You have run `sudo gitlab-ctl reconfigure` at least once. - You have run `sudo gitlab-ctl reconfigure` at least once.
- GitLab is running. If not, start it using `sudo gitlab-ctl start`. - GitLab is running. If not, start it using `sudo gitlab-ctl start`.
......
...@@ -21,6 +21,8 @@ sudo service gitlab stop ...@@ -21,6 +21,8 @@ sudo service gitlab stop
### 2. Backup ### 2. Backup
NOTE: If you installed GitLab from source, make sure `rsync` is installed.
```bash ```bash
cd /home/git/gitlab cd /home/git/gitlab
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment