Skip to content

Commit e039834

Browse files
committed
Minor cleanups of the CentOS_6 install guide
1 parent b2c0041 commit e039834

File tree

1 file changed

+20
-22
lines changed

1 file changed

+20
-22
lines changed

install/CentOS_6.md

+20-22
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
# Maintainer: @nielsbasjes
33
# App Version: 5.1
44

5-
**This installation guide was created for CentOS 6.3 in combination with gitlab 5.1 and tested on it.**
5+
**This installation guide was created for CentOS 6.4 in combination with gitlab 5.1 and tested on it.**
66
We also tried this on RHEL 6.3 and found that there are subtle differences that we so far have only documented in part.
77

88
Please read `doc/install/requirements.md` for hardware and platform requirements.
@@ -21,13 +21,13 @@ following the contribution guide (see `CONTRIBUTING.md`).
2121

2222
**Note about accounts:**
2323
In most cases you are required to run commands as the 'root' user.
24-
When it is required you should be either the 'git' or 'gitlab' user it will be indicated with a line like this
24+
When it is required you should be either the 'git' or 'root' user it will be indicated with a line like this
2525

2626
*logged in as **git***
2727

2828
The best way to become that user is by logging in as root and typing
2929

30-
su - gitlab
30+
su - git
3131

3232
**Note about security:**
3333
Many setup guides of Linux software simply state: "disable selinux and firewall".
@@ -40,7 +40,7 @@ This guide does not disable any of them, we simply configure them as they were i
4040

4141
The GitLab installation consists of setting up the following components:
4242

43-
1. Installing the base operating system (CentOS 6.3 Minimal) and Packages / Dependencies
43+
1. Installing the base operating system (CentOS 6.4 Minimal) and Packages / Dependencies
4444
2. Ruby
4545
3. System Users
4646
4. GitLab shell
@@ -49,14 +49,14 @@ The GitLab installation consists of setting up the following components:
4949

5050
----------
5151

52-
# 1. Installing the operating system (CentOS 6.3 Minimal)
52+
# 1. Installing the operating system (CentOS 6.4 Minimal)
5353

54-
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.
54+
We start with a completely clean CentOS 6.4 "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.
5555

5656
Note that during the installation you use the *"Configure Network"* option (it's a button in the same screen where you specify the hostname) to enable the *"Connect automatically"* option for the network interface and hand (usually eth0).
5757
**If you forget this option the network will NOT start at boot.**
5858

59-
The end result is a bare minimum CentOS installation that effectively only has network connectivity and no services at all.
59+
The end result is a bare minimum CentOS installation that effectively only has network connectivity and (almost) no services at all.
6060

6161
## Updating and adding basic software and services
6262
### Add EPEL repository
@@ -65,7 +65,7 @@ The end result is a bare minimum CentOS installation that effectively only has n
6565

6666
rpm -Uvh http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm
6767

68-
### Install the required tools for gitlab and gitolite
68+
### Install the required tools for gitlab
6969

7070
*logged in as **root***
7171

@@ -82,7 +82,7 @@ The end result is a bare minimum CentOS installation that effectively only has n
8282

8383
**IMPORTANT NOTE About Redhat EL 6**
8484

85-
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.
85+
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. Someone told me that you can get these "packages direct from RHEL by enabling the “RHEL Server Optional” Channel in RHN.". I haven't tried this yet.
8686

8787
### Update CentOS to the latest set of patches
8888

@@ -96,7 +96,6 @@ Just make sure it is started at the next reboot
9696
*logged in as **root***
9797

9898
chkconfig redis on
99-
service redis start
10099

101100
## Configure mysql
102101
Make sure it is started at the next reboot and start it immediately so we can configure it.
@@ -117,7 +116,7 @@ Just make sure it is started at the next reboot
117116

118117
chkconfig httpd on
119118

120-
We want to be able to reach gitlab using the normal http ports (i.e. not the :3000 thing)
119+
We want to be able to reach gitlab using the normal http ports (i.e. not the :9292 thing)
121120
So we create a file called **/etc/httpd/conf.d/gitlab.conf** with this content (replace the git.example.org with your hostname!!).
122121

123122
<VirtualHost *:80>
@@ -136,7 +135,7 @@ OPTIONAL: If you want to run other websites on the same system you'll need to en
136135

137136
NameVirtualHost *:80
138137

139-
Poke an selinux hole for httpd so it can httpd can be in front of gitlab
138+
Poke a selinux hole for httpd so it can httpd can be in front of gitlab
140139

141140
setsebool -P httpd_can_network_connect on
142141

@@ -269,6 +268,7 @@ Now we want all logging of the system to be forwarded to a central email address
269268
\q
270269

271270
Try connecting to the new database with the new user
271+
272272
mysql -u gitlab -p -D gitlabhq_production
273273

274274
----------
@@ -287,7 +287,6 @@ GitLab Shell is a ssh access and repository management software developed specia
287287

288288
# Clone gitlab shell
289289
git clone https://github.com/gitlabhq/gitlab-shell.git
290-
291290
cd gitlab-shell
292291

293292
# switch to right version
@@ -339,8 +338,8 @@ Edit the gitlab config to make sure to change "localhost" to the fully-qualified
339338
*logged in as **root***
340339

341340
# Make sure GitLab can write to the log/ and tmp/ directories
342-
chown -R git /home/git/gitlab/log/
343-
chown -R git /home/git/gitlab/tmp/
341+
chown -R git /home/git/gitlab/log/
342+
chown -R git /home/git/gitlab/tmp/
344343
chmod -R u+rwX /home/git/gitlab/log/
345344
chmod -R u+rwX /home/git/gitlab/tmp/
346345

@@ -352,12 +351,12 @@ Edit the gitlab config to make sure to change "localhost" to the fully-qualified
352351
# Create directories for sockets/pids and make sure GitLab can write to them
353352
mkdir /home/git/gitlab/tmp/pids/
354353
mkdir /home/git/gitlab/tmp/sockets/
355-
chmod -R u+rwX /home/git/gitlab/tmp/pids/
356-
chmod -R u+rwX /home/git/gitlab/tmp/sockets/
354+
chmod -R u+rwX /home/git/gitlab/tmp/pids/
355+
chmod -R u+rwX /home/git/gitlab/tmp/sockets/
357356

358357
# Create public/uploads directory otherwise backup will fail
359358
mkdir /home/git/gitlab/public/uploads
360-
chmod -R u+rwX /home/git/gitlab/public/uploads
359+
chmod -R u+rwX /home/git/gitlab/public/uploads
361360

362361
# Copy the example Puma config
363362
cp /home/git/gitlab/config/puma.rb{.example,}
@@ -371,15 +370,14 @@ Edit the gitlab config to make sure to change "localhost" to the fully-qualified
371370
**Important Note:**
372371
Make sure to edit both `gitlab.yml` and `puma.rb` to match your setup.
373372

374-
Speficially for our setup behind Apache edit the puma config
373+
Specifically for our setup behind Apache edit the puma config
375374

376375
vim /home/git/gitlab/config/puma.rb
377376

378377
Change the bind parameter so that it reads:
379378

380379
bind 'tcp://127.0.0.1:9292'
381380

382-
383381
## Configure GitLab DB settings
384382

385383
# MySQL
@@ -389,7 +387,7 @@ Edit the database config and set the correct username/password
389387

390388
vim /home/git/gitlab/config/database.yml
391389

392-
The config should look something like this (where supersecret is replaced with your real password):
390+
The config should look something like this (where *supersecret* is replaced with your real password):
393391

394392
production:
395393
adapter: mysql2
@@ -423,7 +421,7 @@ The config should look something like this (where supersecret is replaced with y
423421
bundle install --deployment --without development test postgres
424422

425423

426-
## Initialise Database and Activate Advanced Features
424+
## Initialize Database and Activate Advanced Features
427425

428426
*logged in as **git***
429427

0 commit comments

Comments
 (0)