You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: doc/settings/database.md
+51-51Lines changed: 51 additions & 51 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -932,57 +932,6 @@ sure that any folders that relate to PostgreSQL are deleted and that there are n
932
932
933
933
For more information, see the example in [configuration documentation](../settings/configuration.md#provide-the-postgresql-user-password-to-gitlab-rails).
934
934
935
-
### Troubleshooting
936
-
937
-
#### Set `default_transaction_isolation` into `read committed`
938
-
939
-
If you see errors similar to the following in your `production/sidekiq` log:
940
-
941
-
```plaintext
942
-
ActiveRecord::StatementInvalid PG::TRSerializationFailure: ERROR: could not serialize access due to concurrent update
943
-
```
944
-
945
-
Chances are your database's `default_transaction_isolation` configuration is not
946
-
in line with the GitLab application requirement. You can check this configuration by
947
-
connecting to your PostgreSQL database and run `SHOW default_transaction_isolation;`.
948
-
GitLab application expects `read committed` to be configured.
949
-
950
-
This`default_transaction_isolation` configuration is set in your
951
-
`postgresql.conf` file. You will need to restart/reload the database once you
952
-
changed the configuration. This configuration comes by default in the packaged
953
-
PostgreSQL server included with the Linux package.
954
-
955
-
### Could not load library `plpgsql.so`
956
-
957
-
You might see errors similar to the following while running Database migrations
958
-
orin the PostgreSQL/Patronilogs:
959
-
960
-
```plaintext
961
-
ERROR: could not load library "/opt/gitlab/embedded/postgresql/12/lib/plpgsql.so": /opt/gitlab/embedded/postgresql/12/lib/plpgsql.so: undefined symbol: EnsurePortalSnapshotExists
962
-
```
963
-
964
-
This error is caused due to not restarting PostgreSQL after the underlying
965
-
version changed. To fix this error:
966
-
967
-
1. Run one of the following commands:
968
-
969
-
```shell
970
-
# For PostgreSQL
971
-
sudo gitlab-ctl restart postgresql
972
-
973
-
# For Patroni
974
-
sudo gitlab-ctl restart patroni
975
-
976
-
# For Geo PostgreSQL
977
-
sudo gitlab-ctl restart geo-postgresql
978
-
```
979
-
980
-
1. ReconfigureGitLab:
981
-
982
-
```shell
983
-
sudo gitlab-ctl reconfigure
984
-
```
985
-
986
935
## Application Settings for the Database
987
936
988
937
### Disabling automatic database migration
@@ -1291,3 +1240,54 @@ or as a PostgreSQL superuser:
1291
1240
```shell
1292
1241
sudo gitlab-psql -d gitlabhq_production
1293
1242
```
1243
+
1244
+
## Troubleshooting
1245
+
1246
+
### Set `default_transaction_isolation` into `read committed`
1247
+
1248
+
If you see errors similar to the following in your `production/sidekiq`log:
1249
+
1250
+
```plaintext
1251
+
ActiveRecord::StatementInvalid PG::TRSerializationFailure: ERROR: could not serialize access due to concurrent update
1252
+
```
1253
+
1254
+
Chances are your database's `default_transaction_isolation` configuration is not
1255
+
in line with the GitLab application requirement. You can check this configuration by
1256
+
connecting to your PostgreSQL database and run `SHOW default_transaction_isolation;`.
1257
+
GitLab application expects `read committed` to be configured.
1258
+
1259
+
This `default_transaction_isolation` configuration is set in your
1260
+
`postgresql.conf` file. You will need to restart/reload the database once you
1261
+
changed the configuration. This configuration comes by default in the packaged
1262
+
PostgreSQL server included with the Linux package.
1263
+
1264
+
### Could not load library `plpgsql.so`
1265
+
1266
+
You might see errors similar to the following while running Database migrations
1267
+
or in the PostgreSQL/Patroni logs:
1268
+
1269
+
```plaintext
1270
+
ERROR: could not load library "/opt/gitlab/embedded/postgresql/12/lib/plpgsql.so": /opt/gitlab/embedded/postgresql/12/lib/plpgsql.so: undefined symbol: EnsurePortalSnapshotExists
1271
+
```
1272
+
1273
+
This error is caused due to not restarting PostgreSQL after the underlying
0 commit comments