github.com/techend/deis@v1.0.1-0.20141111224634-e0eee0392b8a/docs/customizing_deis/store_monitor_settings.rst (about)

     1  :title: Customizing store-monitor
     2  :description: Learn how to tune custom Deis settings.
     3  
     4  .. _store_monitor_settings:
     5  
     6  Customizing store-monitor
     7  =========================
     8  The following settings are tunable for the :ref:`store` component's monitor service.
     9  
    10  Dependencies
    11  ------------
    12  Requires: none
    13  
    14  Required by: :ref:`store-daemon <store_daemon_settings>`, :ref:`store-gateway <store_gateway_settings>`
    15  
    16  Considerations: none
    17  
    18  Settings set by store-monitor
    19  -----------------------------
    20  The following etcd keys are set by the store-monitor component, typically in its /bin/boot script.
    21  
    22  =============================            =================================================================================
    23  setting                                  description
    24  =============================            =================================================================================
    25  /deis/store/adminKeyring                 keyring for an admin user to access the Ceph cluster
    26  /deis/store/fsid                         Ceph filesystem ID
    27  /deis/store/hosts/$HOST                  hostname (not IP) of the host running this store-monitor instance
    28  /deis/store/monKeyring                   keyring for the monitor to access the Ceph cluster
    29  /deis/store/monSetupComplete             set when the Ceph cluster setup is complete
    30  /deis/store/monSetupLock                 IP address of the monitor instance that is or has set up the Ceph cluster
    31  /deis/store/minSize                      minimum number of store-daemons necessary for the cluster to accept writes
    32  /deis/store/pgNum                        number of Ceph placement groups for the storage pools
    33  /deis/store/size                         number of replicas for data stored in Ceph
    34  =============================            =================================================================================
    35  
    36  Settings used by store-monitor
    37  ------------------------------
    38  The store-monitor component uses no keys from etcd other than the ones it sets.
    39  
    40  Using a custom store-monitor image
    41  ----------------------------------
    42  You can use a custom Docker image for the store-monitor component instead of the image
    43  supplied with Deis:
    44  
    45  .. code-block:: console
    46  
    47      $ deisctl config store-monitor set image=myaccount/myimage:latest
    48  
    49  This will pull the image from the public Docker registry. You can also pull from a private
    50  registry:
    51  
    52  .. code-block:: console
    53  
    54      $ deisctl config store-monitor set image=registry.mydomain.org:5000/myaccount/myimage:latest
    55  
    56  Be sure that your custom image functions in the same way as the `stock store-monitor image`_ shipped with
    57  Deis. Specifically, ensure that it sets and reads appropriate etcd keys.
    58  
    59  .. _`stock store-monitor image`: https://github.com/deis/deis/tree/master/store/monitor