Skip to content

Commit c4d4c4e

Browse files
author
Niels Basjes
committed
Fixed the TOC (which showed nginx)
Described the biggest problem when installing on RHEL 6.3 Additional clarification about switching users Signed-off-by: Niels Basjes <[email protected]>
1 parent 167e0ad commit c4d4c4e

File tree

1 file changed

+26
-11
lines changed

1 file changed

+26
-11
lines changed

install/CentOS_6.md

Lines changed: 26 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
**This installation guide was created for CentOS 6.3 in combination with gitlab 4.0 and tested on it.**
2+
We also tried this on RHEL 6.3 and found that there are subtle differences that we so far have only documeted in part.
23

34
Please read `doc/install/requirements.md` for hardware and platform requirements.
45

@@ -36,17 +37,17 @@ This guide does not disable any of them, we simply configure them as they were i
3637
# Overview
3738

3839
The GitLab installation consists of setting up the following components:
39-
1. Installing the operating system (CentOS 6.3 Minimal) and Packages / Dependencies
40+
41+
1. Installing the base operating system (CentOS 6.3 Minimal) and Packages / Dependencies
4042
2. Ruby
4143
3. System Users
4244
4. Gitolite
43-
5. Database
44-
6. GitLab
45-
7. Nginx
45+
5. GitLab
46+
4647

4748
----------
4849

49-
# Installing the operating system (CentOS 6.3 Minimal)
50+
# 1. Installing the operating system (CentOS 6.3 Minimal)
5051

5152
We start with a completely clean CentOS 6.3 "minimal" installation which can be accomplished by downloading the appropriate installation iso file. Just boot the system of the iso file and install the system.
5253

@@ -77,6 +78,10 @@ The end result is a bare minimum CentOS installation that effectively only has n
7778
mysql-devel crontabs logwatch logrotate sendmail-cf qtwebkit qtwebkit-devel \
7879
perl-Time-HiRes
7980

81+
**IMPORTANT NOTE About Redhat EL 6**
82+
83+
During an installation on an official RHEL 6.3 we found that some packages (in our case gdbm-devel, libffi-devel and libicu-devel) were NOT installed. You MUST make sure that all the packages are installed. The simplest way is to run the above command for a second time and you'll see quite easily of everything is either already installed or "No package XXX available". When you run into this issue you can try installing these required packages from the CentOS distribution.
84+
8085
### Update CentOS to the latest set of patches
8186

8287
*logged in as root*
@@ -153,7 +158,6 @@ The quick way is to put this in the file called **/etc/sysconfig/iptables**
153158
-A FORWARD -j REJECT --reject-with icmp-host-prohibited
154159
COMMIT
155160

156-
157161
## Configure email
158162

159163
cd /etc/mail
@@ -329,8 +333,7 @@ Check the [Trouble Shooting Guide](https://github.com/gitlabhq/gitlab-public-wik
329333
and make sure you have followed all of the above steps carefully.
330334

331335
----------
332-
333-
# 6. GitLab
336+
# 5. GitLab
334337

335338
*logged in as gitlab*
336339

@@ -398,6 +401,10 @@ The config should look something like this (where supersecret is replaced with y
398401
# socket: /tmp/mysql.sock
399402

400403
## Install Gems
404+
*logged in as **gitlab***
405+
406+
logout
407+
401408
*logged in as **root***
402409

403410
cd /home/gitlab/gitlab
@@ -406,7 +413,7 @@ The config should look something like this (where supersecret is replaced with y
406413

407414
su - gitlab
408415

409-
*logged in as gitlab*
416+
*logged in as **gitlab***
410417

411418
cd /home/gitlab/gitlab
412419

@@ -425,6 +432,9 @@ used for the `email.from` setting in `config/gitlab.yml`)
425432
git config --global user.email "gitlab@localhost"
426433

427434
## Setup GitLab Hooks
435+
*logged in as **gitlab***
436+
437+
logout
428438

429439
*logged in as **root***
430440

@@ -434,6 +444,8 @@ used for the `email.from` setting in `config/gitlab.yml`)
434444

435445
## Initialise Database and Activate Advanced Features
436446

447+
*logged in as **root***
448+
437449
su - gitlab
438450

439451
*logged in as **gitlab***
@@ -445,7 +457,11 @@ The previous command will ask you for the root password of the mysql database an
445457

446458
## Install Init Script
447459

448-
Download the init script (will be /etc/init.d/gitlab):
460+
Download the init script (will be /etc/init.d/gitlab)
461+
462+
*logged in as **gitlab***
463+
464+
logout
449465

450466
*logged in as root*
451467

@@ -463,7 +479,6 @@ Start your GitLab instance:
463479
# or
464480
/etc/init.d/gitlab start
465481

466-
467482
## Check Application Status
468483

469484
Check if GitLab and its environment is configured correctly:

0 commit comments

Comments
 (0)