Update ReadMe.md to use directory format for backing up & restoring the database
authorrniwa@webkit.org <rniwa@webkit.org@268f45cc-cd09-0410-ab3c-d52691b4dbfc>
Tue, 7 Mar 2017 23:21:49 +0000 (23:21 +0000)
committerrniwa@webkit.org <rniwa@webkit.org@268f45cc-cd09-0410-ab3c-d52691b4dbfc>
Tue, 7 Mar 2017 23:21:49 +0000 (23:21 +0000)
https://bugs.webkit.org/show_bug.cgi?id=169263

Reviewed by Joseph Pecoraro.

Update ReadMe.md's instruction to backup and restore the database to use directory format instead of
piping it to gzip. The new command will backup and restore the database with multiple concurrent processes
with a custom compression level.

* ReadMe.md:

git-svn-id: https://svn.webkit.org/repository/webkit/trunk@213548 268f45cc-cd09-0410-ab3c-d52691b4dbfc

Websites/perf.webkit.org/ChangeLog
Websites/perf.webkit.org/ReadMe.md

index 41bb956..59568cf 100644 (file)
@@ -1,3 +1,16 @@
+2017-03-07  Ryosuke Niwa  <rniwa@webkit.org>
+
+        Update ReadMe.md to use directory format for backing up & restoring the database
+        https://bugs.webkit.org/show_bug.cgi?id=169263
+
+        Reviewed by Joseph Pecoraro.
+
+        Update ReadMe.md's instruction to backup and restore the database to use directory format instead of
+        piping it to gzip. The new command will backup and restore the database with multiple concurrent processes
+        with a custom compression level.
+
+        * ReadMe.md:
+
 2017-03-02  Ryosuke Niwa  <rniwa@webkit.org>
 
         Make baseline data points selectable
index bf8ba63..8f21410 100644 (file)
@@ -123,8 +123,13 @@ Run `database/init-database.sql` in psql as `webkit-perf-db-user`:
 
 ### Making a Backup and Restoring
 
-- Backing up the database: `/Applications/Server.app/Contents/ServerRoot/usr/bin/pg_dump -h localhost --no-owner -f <filepath> webkit-perf-db | gzip > backup.gz`
-- Restoring the database: `gunzip -c backup.gz | /Applications/Server.app/Contents/ServerRoot/usr/bin/psql webkit-perf-db -h localhost --username webkit-perf-db-user`
+Use `pg_dump` and `pg_restore` to backup and restore the database. If you're replicating the production database for development purposes, you may consider excluding `run_iterations` table, which takes up 2/3 of the storage space, to reduce the size of the database for your local copy. Adjust the number of concurrent processes to use by `--jobs` and adjust the compression level by `--compress` (0 is no compression, 9 is most compressed).
+
+- Making the fullbackup of the database: `/Applications/Server.app/Contents/ServerRoot/usr/bin/pg_dump -h localhost webkit-perf-db --format=directory --file=<path to backup directory> --jobs=4 --no-owner --compress=7`
+
+- Making an abridged backup without `run_iterations` table: `/Applications/Server.app/Contents/ServerRoot/usr/bin/pg_dump -h localhost webkit-perf-db --format=directory --file=<path to backup directory> --jobs=4 --no-owner --compress=7 --exclude-table=run_iterations`
+
+- Restoring the database: `/Applications/Server.app/Contents/ServerRoot/usr/bin/pg_restore --format=directory --jobs=4 --no-owner --host localhost --username=webkit-perf-db-user <path to backup directory> --dbname=webkit-perf-db`
 
 ## Concepts