github.com/technosophos/deis@v1.7.1-0.20150915173815-f9005256004b/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/maxPGsPerOSDWarning          threshold for warning on number of placement groups per OSD (set by store-monitor)
    29  /deis/store/monKeyring                   keyring for the monitor to access the Ceph cluster
    30  /deis/store/monSetupComplete             set when the Ceph cluster setup is complete
    31  /deis/store/monSetupLock                 IP address of the monitor instance that is or has set up the Ceph cluster
    32  /deis/store/minSize                      minimum number of store-daemons necessary for the cluster to accept writes
    33  /deis/store/pgNum                        number of Ceph placement groups for the storage pools
    34  /deis/store/size                         number of replicas for data stored in Ceph
    35  ===============================          ==================================================================================
    36  
    37  Settings used by store-monitor
    38  ------------------------------
    39  The store-monitor component uses no keys from etcd other than the ones it sets.
    40  
    41  Using a custom store-monitor image
    42  ----------------------------------
    43  You can use a custom Docker image for the store-monitor component instead of the image
    44  supplied with Deis:
    45  
    46  .. code-block:: console
    47  
    48      $ deisctl config store-monitor set image=myaccount/myimage:latest
    49  
    50  This will pull the image from the public Docker registry. You can also pull from a private
    51  registry:
    52  
    53  .. code-block:: console
    54  
    55      $ deisctl config store-monitor set image=registry.mydomain.org:5000/myaccount/myimage:latest
    56  
    57  Be sure that your custom image functions in the same way as the `stock store-monitor image`_ shipped with
    58  Deis. Specifically, ensure that it sets and reads appropriate etcd keys.
    59  
    60  .. _`stock store-monitor image`: https://github.com/deis/deis/tree/master/store/monitor