<page xmlns="http://projectmallard.org/1.0/"
      xmlns:its="http://www.w3.org/2005/11/its"
      type="topic" style="task"
      id="dconf-nfs-home">

  <info>
    <link type="guide" xref="setup" />
    <link type="seealso" xref="dconf-profiles" />
    <link type="seealso" xref="dconf-custom-defaults" />
    <revision version="0.1" date="2013-03-19" status="draft"/>
    <revision pkgversion="3.8" date="2013-05-09" status="review"/>
    <revision pkgversion="3.12" date="2014-06-17" status="review"/>

    <credit type="author copyright">
      <name>Jana Svarova</name>
      <email>[email protected]</email>
      <years>2013</years>
    </credit>
    <credit type="author copyright">
      <name>Ekaterina Gerasimova</name>
      <email>[email protected]</email>
      <years>2013</years>
    </credit>
    <credit type="editor">
      <name>Petr Kovar</name>
      <email>[email protected]</email>
      <years>2014</years>
    </credit>

    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>

    <desc>Update the system configuration for <sys>dconf</sys> to store settings
    in an <sys>NFS</sys> home directory.</desc>
  </info>

  <title>Store settings over <sys>NFS</sys></title>

  <comment>
    <cite date="2013-03-19" href="mailto:[email protected]">Jana Svarova</cite>
    <p>Adapted from GNOME Bugzilla: Bug 694569</p>
  </comment>
  <comment>
    <cite date="2013-05-09" href="mailto:[email protected]">Kat</cite>
    <p>Also affected by bugs 595579 and 670493.</p>
    <p>https://bugzilla.gnome.org/show_bug.cgi?id=595579#c40 and
    https://bugzilla.gnome.org/show_bug.cgi?id=670493#c8</p>
  </comment>

  <p>For <sys its:translate="no">dconf</sys> to work correctly when using
  <sys>Network File System</sys> (<sys>NFS</sys>) home directories, the
  <sys its:translate="no">dconf</sys> <em>keyfile back end</em> must be
  used.</p>

  <steps>
    <item>
      <p>Create or edit the <file its:translate="no">/etc/dconf/profile/user</file> file
      on every client.</p>
    </item>
    <item>
      <p>At the very beginning of this file, add the following line:</p>
      <code><input its:translate="no">service-db:keyfile/user</input></code>
    </item>
  </steps>

  <comment>
    <cite href="mailto:[email protected]">Kat</cite>
    <p>In-process changes will take effect immediately, but out-of-process
    changes will be delayed by the poll time on GFileMonitor.</p>
  </comment>
  <p>The <sys its:translate="no">dconf</sys> <em>keyfile back end</em> will only
  take effect the next time that the user logs in. It polls the keyfile to
  determine whether updates have been made, so settings may not be updated
  immediately.</p>

  <comment>
    <cite href="mailto:[email protected]">Kat</cite>
    <p>According to Ryan, "SIGBUS being semi-randomly delivered to your
    processes is a real downer". This means stuff will crash.</p>
  </comment>
  <p>If a <em>keyfile back end</em> is not used, the user settings may not be
  retrieved or updated correctly.</p>

</page>