<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://bugzilla.yoctoproject.org/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.6"
          urlbase="https://bugzilla.yoctoproject.org/"
          
          maintainer="it-coreprojects-helpdesk@linuxfoundation.org"
>

    <bug>
          <bug_id>13589</bug_id>
          
          <creation_ts>2019-10-09 20:56:27 +0000</creation_ts>
          <short_desc>Document sstate cache mirror best practices</short_desc>
          <delta_ts>2026-08-03 13:19:04 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>9</classification_id>
          <classification>Documentation</classification>
          <product>Reference</product>
          <component>handbook</component>
          <version>unspecified</version>
          <rep_platform>x86</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>Medium+</priority>
          <bug_severity>enhancement</bug_severity>
          <target_milestone>6.1 M1</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Paul Eggleton">bluelightning</reporter>
          <assigned_to name="Antonin Godard">antonin.godard</assigned_to>
          <cc>mark.morton</cc>
    
    <cc>michael.opdenacker</cc>
    
    <cc>poky.doc.watcher</cc>
    
    <cc>poky.watcher</cc>
    
    <cc>randy.macleod</cc>
    
    <cc>srifenbark</cc>
    
    <cc>tim.orling</cc>
          
          
          <cf_os>---</cf_os>
          <cf_regression_type>---</cf_regression_type>
          
          <cf_docchange>Yes (doc changes required)</cf_docchange>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>85280</commentid>
    <comment_count>0</comment_count>
    <who name="Paul Eggleton">bluelightning</who>
    <bug_when>2019-10-09 20:56:27 +0000</bug_when>
    <thetext>It would be useful to have a section in the docs that discusses the practical aspects of setting up and maintaining an sstate cache mirror, since there are a few gotchas. Some points to consider:

* How to configure it
* How to share it
* Arrangement of machines for a build farm or team of developers
* Keeping size under control (multiple approaches?)
* Ensuring siginfo files are synced before tarballs
* Troubleshooting issues (e.g. how to recognise host contamination - at least make people aware that it can be exposed more readily)
* Other services that need to be alongside e.g. PR server, hash equivalency, etc.
* Limitations</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>85281</commentid>
    <comment_count>1</comment_count>
    <who name="Paul Eggleton">bluelightning</who>
    <bug_when>2019-10-09 20:57:45 +0000</bug_when>
    <thetext>I meant to mention - I thought we had a section similar to this already but I could not find it in the reference or development manuals.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>85302</commentid>
    <comment_count>2</comment_count>
    <who name="Scott Rifenbark">srifenbark</who>
    <bug_when>2019-10-10 14:56:00 +0000</bug_when>
    <thetext>We don&apos;t have this Paul.  Someone could provide some rough info and I can get it in.

Scott</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>100012</commentid>
    <comment_count>3</comment_count>
    <who name="Randy MacLeod">randy.macleod</who>
    <bug_when>2024-10-24 15:04:00 +0000</bug_when>
    <thetext>Bulk move of 5.1 M4 to 5.2 M2 as approved by AlexB.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>102190</commentid>
    <comment_count>4</comment_count>
    <who name="Antonin Godard">antonin.godard</who>
    <bug_when>2025-06-06 07:42:31 +0000</bug_when>
    <thetext>Bulk move of bugs I am assigned to from Milestone 5.2M4 to 5.3M1.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>106262</commentid>
    <comment_count>5</comment_count>
    <who name="Antonin Godard">antonin.godard</who>
    <bug_when>2026-07-22 12:59:19 +0000</bug_when>
    <thetext>Sent a series to document this: https://lore.kernel.org/r/20260722-sstate-mirrors-doc-v1-0-570baeb41c32@bootlin.com</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>106424</commentid>
    <comment_count>6</comment_count>
    <who name="Antonin Godard">antonin.godard</who>
    <bug_when>2026-08-03 13:19:04 +0000</bug_when>
    <thetext>Series merged: https://git.yoctoproject.org/yocto-docs/commit/?id=15b08adf30ddbeb9f9911d4a6ae207e95f94ca87</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>