gitlab-org--gitlab-foss/doc/raketasks/maintenance.md

### Gather information about GitLab and the system it runs on

This command gathers information about your GitLab installation and the System
it runs on. These may be useful when asking for help or reporting issues.

```
bundle exec rake gitlab:env:info RAILS_ENV=production
```

Example output:

```
System information
System:		Debian 6.0.7
Current User:	git
Using RVM:	no
Ruby Version:	1.9.3p392
Gem Version:	1.8.23
Bundler Version:1.3.5
Rake Version:	10.0.4

GitLab information
Version:	5.1.0.beta2
Revision:	4da8b37
Directory:	/home/git/gitlab
DB Adapter:	mysql2
URL:		http://localhost
HTTP Clone URL:	http://localhost/some-project.git
SSH Clone URL:	git@localhost:some-project.git
Using LDAP:	no
Using Omniauth:	no

GitLab Shell
Version:	1.2.0
Repositories:	/home/git/repositories/
Hooks:		/home/git/gitlab-shell/hooks/
Git:		/usr/bin/git
```


### Check GitLab configuration

Runs the following rake tasks:

* gitlab:env:check
* gitlab:gitlab_shell:check
* gitlab:sidekiq:check
* gitlab:app:check

It will check that each component was setup according to the installation guide and suggest fixes for issues found.

You may also have a look at our [Trouble Shooting Guide](https://github.com/gitlabhq/gitlab-public-wiki/wiki/Trouble-Shooting-Guide).

```
bundle exec rake gitlab:check RAILS_ENV=production
```

Example output:

```
Checking Environment ...

Git configured for git user? ... yes
Has python2? ... yes
python2 is supported version? ... yes

Checking Environment ... Finished

Checking GitLab Shell ...

GitLab Shell version? ... OK (1.2.0)
Repo base directory exists? ... yes
Repo base directory is a symlink? ... no
Repo base owned by git:git? ... yes
Repo base access is drwxrws---? ... yes
post-receive hook up-to-date? ... yes
post-receive hooks in repos are links: ... yes

Checking GitLab Shell ... Finished

Checking Sidekiq ...

Running? ... yes

Checking Sidekiq ... Finished

Checking GitLab ...

Database config exists? ... yes
Database is SQLite ... no
All migrations up? ... yes
GitLab config exists? ... yes
GitLab config outdated? ... no
Log directory writable? ... yes
Tmp directory writable? ... yes
Init script exists? ... yes
Init script up-to-date? ... yes
Projects have satellites? ... yes
Redis version >= 2.0.0? ... yes

Checking GitLab ... Finished
```


### (Re-)Create satellite repos

This will create satellite repos for all your projects.
If necessary, remove the `tmp/repo_satellites` directory and rerun the command below.

```
bundle exec rake gitlab:satellites:create RAILS_ENV=production
```

### Import bare repositories into GitLab project instance

Notes:

* project owner will be a first admin
* groups will be created as needed
* group owner will be the first admin
* existing projects will be skipped

How to use:

1. copy your bare repos under git repos_path (see `config/gitlab.yml` gitlab_shell -> repos_path)
2. run the command below

```
bundle exec rake gitlab:import:repos RAILS_ENV=production
```

Example output:

```
Processing abcd.git
 * Created abcd (abcd.git)
Processing group/xyz.git
 * Created Group group (2)
 * Created xyz (group/xyz.git)
[...]
```
Improve gitlab:env:info task Renamed from gitlab:app:info Add several extra info points 2012-12-06 15:16:48 -05:00			`### Gather information about GitLab and the system it runs on`
add rake task to gather system information 2012-12-05 12:27:54 -05:00
Improve gitlab:env:info task Renamed from gitlab:app:info Add several extra info points 2012-12-06 15:16:48 -05:00			`This command gathers information about your GitLab installation and the System`
			`it runs on. These may be useful when asking for help or reporting issues.`
add rake task to gather system information 2012-12-05 12:27:54 -05:00
			```
Add RAILS_ENV to rake docs 2013-01-05 16:36:04 -05:00			`bundle exec rake gitlab:env:info RAILS_ENV=production`
add rake task to gather system information 2012-12-05 12:27:54 -05:00			```

			`Example output:`

			```
			`System information`
Added check_redis_version. Fixes #3449 Checking the redis version will warn users that are using an old version to update. Included reference to the troubleshooting guide. 2013-04-14 16:17:06 -04:00			`System: Debian 6.0.7`
			`Current User: git`
			`Using RVM: no`
			`Ruby Version: 1.9.3p392`
			`Gem Version: 1.8.23`
			`Bundler Version:1.3.5`
			`Rake Version: 10.0.4`
Improve gitlab:env:info task Renamed from gitlab:app:info Add several extra info points 2012-12-06 15:16:48 -05:00
			`GitLab information`
Added check_redis_version. Fixes #3449 Checking the redis version will warn users that are using an old version to update. Included reference to the troubleshooting guide. 2013-04-14 16:17:06 -04:00			`Version: 5.1.0.beta2`
			`Revision: 4da8b37`
			`Directory: /home/git/gitlab`
			`DB Adapter: mysql2`
			`URL: http://localhost`
			`HTTP Clone URL: http://localhost/some-project.git`
			`SSH Clone URL: git@localhost:some-project.git`
			`Using LDAP: no`
			`Using Omniauth: no`
add rake task to gather system information 2012-12-05 12:27:54 -05:00
Remove gitolite mention from docs 2013-02-25 14:45:33 -05:00			`GitLab Shell`
Added check_redis_version. Fixes #3449 Checking the redis version will warn users that are using an old version to update. Included reference to the troubleshooting guide. 2013-04-14 16:17:06 -04:00			`Version: 1.2.0`
			`Repositories: /home/git/repositories/`
			`Hooks: /home/git/gitlab-shell/hooks/`
			`Git: /usr/bin/git`
add rake task to gather system information 2012-12-05 12:27:54 -05:00			```

Improve gitlab:env:info task Renamed from gitlab:app:info Add several extra info points 2012-12-06 15:16:48 -05:00
Update gitlab:check task docs 2012-12-12 17:55:09 -05:00			`### Check GitLab configuration`
add help page for gitlab specific rake tasks 2012-12-02 07:56:04 -05:00
Update gitlab:check task docs 2012-12-12 17:55:09 -05:00			`Runs the following rake tasks:`

			`* gitlab:env:check`
Remove gitolite mention from docs 2013-02-25 14:45:33 -05:00			`* gitlab:gitlab_shell:check`
			`* gitlab:sidekiq:check`
Update gitlab:check task docs 2012-12-12 17:55:09 -05:00			`* gitlab:app:check`

			`It will check that each component was setup according to the installation guide and suggest fixes for issues found.`

			`You may also have a look at our [Trouble Shooting Guide](https://github.com/gitlabhq/gitlab-public-wiki/wiki/Trouble-Shooting-Guide).`
add help page for gitlab specific rake tasks 2012-12-02 07:56:04 -05:00
			```
Add RAILS_ENV to rake docs 2013-01-05 16:36:04 -05:00			`bundle exec rake gitlab:check RAILS_ENV=production`
add help page for gitlab specific rake tasks 2012-12-02 07:56:04 -05:00			```

			`Example output:`

			```
Update gitlab:check task docs 2012-12-12 17:55:09 -05:00			`Checking Environment ...`

Added check_redis_version. Fixes #3449 Checking the redis version will warn users that are using an old version to update. Included reference to the troubleshooting guide. 2013-04-14 16:17:06 -04:00			`Git configured for git user? ... yes`
Update gitlab:check task docs 2012-12-12 17:55:09 -05:00			`Has python2? ... yes`
			`python2 is supported version? ... yes`

			`Checking Environment ... Finished`

changed Gitlab to GitLab 2013-05-19 05:13:39 -04:00			`Checking GitLab Shell ...`
Update gitlab:check task docs 2012-12-12 17:55:09 -05:00
Added check_redis_version. Fixes #3449 Checking the redis version will warn users that are using an old version to update. Included reference to the troubleshooting guide. 2013-04-14 16:17:06 -04:00			`GitLab Shell version? ... OK (1.2.0)`
Update gitlab:check task docs 2012-12-12 17:55:09 -05:00			`Repo base directory exists? ... yes`
Added check_redis_version. Fixes #3449 Checking the redis version will warn users that are using an old version to update. Included reference to the troubleshooting guide. 2013-04-14 16:17:06 -04:00			`Repo base directory is a symlink? ... no`
Update gitlab:check task docs 2012-12-12 17:55:09 -05:00			`Repo base owned by git:git? ... yes`
Don't setuid the repositories (Rake checks) 2012-12-30 21:46:28 -05:00			`Repo base access is drwxrws---? ... yes`
Update gitlab:check task docs 2012-12-12 17:55:09 -05:00			`post-receive hook up-to-date? ... yes`
Added check_redis_version. Fixes #3449 Checking the redis version will warn users that are using an old version to update. Included reference to the troubleshooting guide. 2013-04-14 16:17:06 -04:00			`post-receive hooks in repos are links: ... yes`
Update gitlab:check task docs 2012-12-12 17:55:09 -05:00
changed Gitlab to GitLab 2013-05-19 05:13:39 -04:00			`Checking GitLab Shell ... Finished`
Update gitlab:check task docs 2012-12-12 17:55:09 -05:00
Added check_redis_version. Fixes #3449 Checking the redis version will warn users that are using an old version to update. Included reference to the troubleshooting guide. 2013-04-14 16:17:06 -04:00			`Checking Sidekiq ...`
Update gitlab:check task docs 2012-12-12 17:55:09 -05:00
			`Running? ... yes`

Added check_redis_version. Fixes #3449 Checking the redis version will warn users that are using an old version to update. Included reference to the troubleshooting guide. 2013-04-14 16:17:06 -04:00			`Checking Sidekiq ... Finished`
Update gitlab:check task docs 2012-12-12 17:55:09 -05:00
			`Checking GitLab ...`

			`Database config exists? ... yes`
Added check_redis_version. Fixes #3449 Checking the redis version will warn users that are using an old version to update. Included reference to the troubleshooting guide. 2013-04-14 16:17:06 -04:00			`Database is SQLite ... no`
Update gitlab:check task docs 2012-12-12 17:55:09 -05:00			`All migrations up? ... yes`
			`GitLab config exists? ... yes`
Added check_redis_version. Fixes #3449 Checking the redis version will warn users that are using an old version to update. Included reference to the troubleshooting guide. 2013-04-14 16:17:06 -04:00			`GitLab config outdated? ... no`
Update gitlab:check task docs 2012-12-12 17:55:09 -05:00			`Log directory writable? ... yes`
			`Tmp directory writable? ... yes`
			`Init script exists? ... yes`
			`Init script up-to-date? ... yes`
Added check_redis_version. Fixes #3449 Checking the redis version will warn users that are using an old version to update. Included reference to the troubleshooting guide. 2013-04-14 16:17:06 -04:00			`Projects have satellites? ... yes`
			`Redis version >= 2.0.0? ... yes`
Update gitlab:check task docs 2012-12-12 17:55:09 -05:00
			`Checking GitLab ... Finished`
add help page for gitlab specific rake tasks 2012-12-02 07:56:04 -05:00			```


Add gitlab:satellites:create as an alias for gitlab:enable_automerge 2012-12-20 15:52:26 -05:00			`### (Re-)Create satellite repos`

			`This will create satellite repos for all your projects.`
			If necessary, remove the `tmp/repo_satellites` directory and rerun the command below.

			```
Add RAILS_ENV to rake docs 2013-01-05 16:36:04 -05:00			`bundle exec rake gitlab:satellites:create RAILS_ENV=production`
Add gitlab:satellites:create as an alias for gitlab:enable_automerge 2012-12-20 15:52:26 -05:00			```

add help page for gitlab specific rake tasks 2012-12-02 07:56:04 -05:00			`### Import bare repositories into GitLab project instance`

			`Notes:`

			`* project owner will be a first admin`
Include groups in import with import repos rake task Expand the import glob to include `*/.git` to find projects in groups as well as top level projects. Check for existing group, and create group if needed. Set namespace_id for imported projects. 2013-05-25 13:38:55 -04:00			`* groups will be created as needed`
			`* group owner will be the first admin`
add help page for gitlab specific rake tasks 2012-12-02 07:56:04 -05:00			`* existing projects will be skipped`

			`How to use:`

Fixed Import Bare Repositories instructions to match rake task. 2013-09-06 19:19:35 -04:00			1. copy your bare repos under git repos_path (see `config/gitlab.yml` gitlab_shell -> repos_path)
add help page for gitlab specific rake tasks 2012-12-02 07:56:04 -05:00			`2. run the command below`

			```
			`bundle exec rake gitlab:import:repos RAILS_ENV=production`
			```

			`Example output:`

			```
			`Processing abcd.git`
			`* Created abcd (abcd.git)`
Include groups in import with import repos rake task Expand the import glob to include `*/.git` to find projects in groups as well as top level projects. Check for existing group, and create group if needed. Set namespace_id for imported projects. 2013-05-25 13:38:55 -04:00			`Processing group/xyz.git`
			`* Created Group group (2)`
			`* Created xyz (group/xyz.git)`
add help page for gitlab specific rake tasks 2012-12-02 07:56:04 -05:00			`[...]`
			```