diff options
Diffstat (limited to 'doc/administration/package_information/index.md')
-rw-r--r-- | doc/administration/package_information/index.md | 29 |
1 files changed, 14 insertions, 15 deletions
diff --git a/doc/administration/package_information/index.md b/doc/administration/package_information/index.md index bfa751a051f..503fdfe3ba8 100644 --- a/doc/administration/package_information/index.md +++ b/doc/administration/package_information/index.md @@ -6,7 +6,7 @@ info: To determine the technical writer assigned to the Stage/Group associated w # Package information **(FREE SELF)** -The Omnibus GitLab package is bundled with all dependencies required for GitLab +The Linux package is bundled with all dependencies required for GitLab to function correctly. More details can be found at [bundling dependencies document](omnibus_packages.md). @@ -14,11 +14,11 @@ at [bundling dependencies document](omnibus_packages.md). The released package versions are in the format `MAJOR.MINOR.PATCH-EDITION.OMNIBUS_RELEASE` -| Component | Meaning | Example | -|---------------------|---------|---------| -| `MAJOR.MINOR.PATCH` | The GitLab version this corresponds to. | `13.3.0` | -| `EDITION` | The edition of GitLab this corresponds to. | `ee` | -| `OMNIBUS_RELEASE` | The Omnibus GitLab release. Usually, this is 0. This is incremented if we need to build a new package without changing the GitLab version. | `0` | +| Component | Meaning | Example | +|:--------------------|:------------------------------------------------------------------------------------------------------------------------------------------|:---------| +| `MAJOR.MINOR.PATCH` | The GitLab version this corresponds to. | `13.3.0` | +| `EDITION` | The edition of GitLab this corresponds to. | `ee` | +| `OMNIBUS_RELEASE` | The Linux package release. Usually, this is `0`. We increment this if we need to build a new package without changing the GitLab version. | `0` | ## Licenses @@ -26,7 +26,7 @@ See [licensing](licensing.md) ## Defaults -The Omnibus GitLab package requires various configuration to get the components +The Linux package requires various configuration to get the components in working order. If the configuration is not provided, the package uses the default values assumed in the package. @@ -34,10 +34,10 @@ These defaults are noted in the package [defaults document](defaults.md). ## Checking the versions of bundled software -After the Omnibus GitLab package is installed, you can find the version of +After the Linux package is installed, you can find the version of GitLab and all bundled libraries in `/opt/gitlab/version-manifest.txt`. -If you don't have the package installed, you can always check the Omnibus GitLab +If you don't have the package installed, you can always check the Linux package [source repository](https://gitlab.com/gitlab-org/omnibus-gitlab/tree/master), specifically the [configuration directory](https://gitlab.com/gitlab-org/omnibus-gitlab/tree/master/config). @@ -51,15 +51,14 @@ Documentation on package signatures can be found at [Signed Packages](signed_pac ## Checking for newer configuration options on upgrade -Configuration file in `/etc/gitlab/gitlab.rb` is created on initial installation -of the Omnibus GitLab package. On subsequent package upgrades, the configuration -file is not updated with new configuration. This is done to avoid -accidental overwrite of user configuration provided in `/etc/gitlab/gitlab.rb`. +The `/etc/gitlab/gitlab.rb` configuration file is created when the Linux package is initially installed. +To avoid accidental overwrites of user configuration, the `/etc/gitlab/gitlab.rb` configuration file is not updated +with new configuration when the Linux package installation is upgraded. New configuration options are noted in the [`gitlab.rb.template` file](https://gitlab.com/gitlab-org/omnibus-gitlab/raw/master/files/gitlab-config-template/gitlab.rb.template). -The Omnibus GitLab package also provides convenience command which +The Linux package also provides a convenience command which compares the existing user configuration with the latest version of the template contained in the package. @@ -76,7 +75,7 @@ characters on each line. ## Init system detection -Omnibus GitLab attempts to query the underlying system to +The Linux package attempts to query the underlying system to check which init system it uses. This manifests itself as a `WARNING` during the `sudo gitlab-ctl reconfigure` run. |