opendev/gerrit
Code Issues Proposed changes

Separate the database setup instructions to a shared file

Browse Source 
Separate the database setup instructions out into a shared file
so the same text can be included in the Tomcat install instructions
later.

Change-Id: I91dae81f8dc7ad361a40f7a76ec74ec69aaa4250
This commit is contained in:
Jason Huntley 2012-08-02 11:10:31 -04:00 committed by David Pursehouse
parent dd21001708
commit 25bbd51d6e
2 changed files with 62 additions and 63 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

59
Documentation/database-setup.txt Normal file
View File

@ -0,0 +1,59 @@
[[createdb]]
Database Setup
--------------
[[createdb_h2]]
H2
~~
During the init phase of Gerrit you will need to specify which database to use.
If you choose H2, Gerrit will automatically set up the embedded H2 database as
backend so no set up in advance is necessary. Also, no additional configuration is
necessary. Using the embedded H2 database is the easiest way to get a Gerrit
site up and running, making it ideal for proof of concepts or small team
servers. On the flip side, H2 is not the recommended option for large
corporate installations. This is because there is no easy way to interact
with the database while Gerrit is offline, it's not easy to backup the data,
and it's not possible to set up H2 in a load balanced/hotswap configuration.
If this option interests you, you might want to consider link:install-quick.html[the quick guide].
[[createdb_postgres]]
PostgreSQL
~~~~~~~~~~
This option is more complicated than the H2 option but is recommended
for larger installations. It's the database backend with the largest userbase
in the Gerrit community.
Create a user for the web application within Postgres, assign it a
password, create a database to store the metadata, and grant the user
full rights on the newly created database:
----
createuser -A -D -P -E gerrit2
createdb -E UTF-8 -O gerrit2 reviewdb
----
[[createdb_mysql]]
MySQL
~~~~~
This option is also more complicated than the H2 option. Just as with
PostgreSQL it's also recommended for larger installations.
Create a user for the web application within the database, assign it a
password, create a database, and give the newly created user full
rights on it:
----
mysql
CREATE USER 'gerrit2'@'localhost' IDENTIFIED BY 'secret';
CREATE DATABASE reviewdb;
ALTER DATABASE reviewdb charset=latin1;
GRANT ALL ON reviewdb.* TO 'gerrit2'@'localhost';
FLUSH PRIVILEGES;
----

66
Documentation/install.txt
View File

@ -1,5 +1,5 @@
Gerrit Code Review - Installation Guide
=======================================
Gerrit Code Review - Standalone Daemon Installation Guide
=========================================================
[[requirements]]
Requirements
@ -29,67 +29,7 @@ rename the downloaded file.
If you would prefer to build Gerrit directly from source, review
the notes under link:dev-readme.html[developer setup].
[[createdb]]
Database Setup
--------------
[[createdb_h2]]
H2
~~
During the init phase of Gerrit you will need to specify which database to use.
If you choose H2, Gerrit will automatically set up the embedded H2 database as
backend so no set up in advance is necessary. Also, no additional configuration is
necessary. Using the embedded H2 database is the easiest way to get a Gerrit
site up and running, making it ideal for proof of concepts or small team
servers. On the flip side, H2 is not the recommended option for large
corporate installations. This is because there is no easy way to interact
with the database while Gerrit is offline, it's not easy to backup the data,
and it's not possible to set up H2 in a load balanced/hotswap configuration.
If this option interests you, you might want to consider link:install-quick.html[the quick guide].
[[createdb_postgres]]
PostgreSQL
~~~~~~~~~~
This option is more complicated than the H2 option but is recommended
for larger installations. It's the database backend with the largest userbase
in the Gerrit community.
Create a user for the web application within Postgres, assign it a
password, create a database to store the metadata, and grant the user
full rights on the newly created database:
----
createuser -A -D -P -E gerrit2
createdb -E UTF-8 -O gerrit2 reviewdb
----
[[createdb_mysql]]
MySQL
~~~~~
This option is also more complicated than the H2 option. Just as with
PostgreSQL it's also recommended for larger installations.
Create a user for the web application within the database, assign it a
password, create a database, and give the newly created user full
rights on it:
----
mysql
CREATE USER 'gerrit2'@'localhost' IDENTIFIED BY 'secret';
CREATE DATABASE reviewdb;
ALTER DATABASE reviewdb charset=latin1;
GRANT ALL ON reviewdb.* TO 'gerrit2'@'localhost';
FLUSH PRIVILEGES;
----
include::database-setup.txt[]
[[init]]
Initialize the Site