X-Git-Url: https://git.arvados.org/arvados.git/blobdiff_plain/db31bedb109a4d918830a910654685a9f591cf28..d71d4273d1f3d0b6381efafa649b81c6b4107cf1:/doc/install/install-keep-balance.html.textile.liquid diff --git a/doc/install/install-keep-balance.html.textile.liquid b/doc/install/install-keep-balance.html.textile.liquid index 09bc04114d..1d9b654b25 100644 --- a/doc/install/install-keep-balance.html.textile.liquid +++ b/doc/install/install-keep-balance.html.textile.liquid @@ -18,6 +18,10 @@ h2(#introduction). Introduction Keep-balance deletes unreferenced and overreplicated blocks from Keep servers, makes additional copies of underreplicated blocks, and moves blocks into optimal locations as needed (e.g., after adding new servers). See "Balancing Keep servers":{{site.baseurl}}/admin/keep-balance.html for usage details. +Keep-balance can be installed anywhere with network access to Keep services. Typically it runs on the same host as keepproxy. + +*A cluster should have only one instance of keep-balance running at a time.* + {% include 'notebox_begin' %} If you are installing keep-balance on an existing system with valuable data, you can run keep-balance in "dry run" mode first and review its logs as a precaution. To do this, edit your keep-balance startup script to use the flags @-commit-pulls=false -commit-trash=false@. @@ -26,13 +30,13 @@ If you are installing keep-balance on an existing system with valuable data, you h2(#update-config). Update the cluster config -Edit the cluster config at @/etc/arvados/config.yml@ and set @Services.Keepbalance.InternalURLs@. This port is only used to publish metrics. +Edit the cluster config at @config.yml@ and set @Services.Keepbalance.InternalURLs@. This port is only used to publish metrics.
    Services:
       Keepbalance:
         InternalURLs:
-          "http://keep.ClusterID.example.com:9005/": {}
+          "http://keep.ClusterID.example.com:9005/": {}
 
@@ -46,44 +50,8 @@ Ensure your cluster configuration has @Collections.BlobTrash: true@ (this is the If BlobTrash is false, unneeded blocks will be counted and logged by keep-balance, but they will not be deleted. -h2(#install-packages). Install keep-balance package - -Keep-balance can be installed anywhere with network access to Keep services. Typically it runs on the same host as keepproxy. - -*A cluster should have only one instance of keep-balance running at a time.* - -h3. Centos 7 - - -
# yum install keep-balance
-
-
- -h3. Debian and Ubuntu +{% assign arvados_component = 'keep-balance' %} - -
# apt-get install keep-balance
-
-
+{% include 'install_packages' %} -h2(#start-service). Start the service - -If your system uses systemd, the keep-balance service should already be set up. Start it and check its status: - - -
~$ sudo systemctl restart keep-balance
-~$ sudo systemctl status keep-balance
-● keep-balance.service - Arvados Keep Balance
-   Loaded: loaded (/lib/systemd/system/keep-balance.service; enabled)
-   Active: active (running) since Sat 2017-02-14 18:46:01 UTC; 3 days ago
-     Docs: https://doc.arvados.org/
- Main PID: 541 (keep-balance)
-   CGroup: /system.slice/keep-balance.service
-           └─541 /usr/bin/keep-balance -commit-pulls -commit-trash
-
-Feb 14 18:46:01 zzzzz.arvadosapi.com keep-balance[541]: 2017/02/14 18:46:01 starting up: will scan every 10m0s and on SIGUSR1
-Feb 14 18:56:01 zzzzz.arvadosapi.com keep-balance[541]: 2017/02/14 18:56:01 Run: start
-Feb 14 18:56:01 zzzzz.arvadosapi.com keep-balance[541]: 2017/02/14 18:56:01 skipping zzzzz-bi6l4-rbtrws2jxul6i4t with service type "proxy"
-Feb 14 18:56:01 zzzzz.arvadosapi.com keep-balance[541]: 2017/02/14 18:56:01 clearing existing trash lists, in case the new rendezvous order differs from previous run
-
-
+{% include 'start_service' %}