Document occ incoming-shares:poll for update detection with federated shares

[mmattel]

What Needs to be Documented?

With core owncloud/core#34903 (Add a command to poll incoming federated shares for updates)
a new occ command needs to be documented: incoming-shares:poll

Where Does This Need To Be Documented?

admin_manual, occ command set

Why Should This Change Be Made? (Optional)

What Type Of Content Change Is This? (Optional)

• New Content Addition
• Old Content Deprecation
• Existing Content Simplification
• Bug Fix to Existing Content

Which Manual Does This Relate To? (Optional)

• Admin Manual
• Developer Manual
• User Manual
• Android
• iOS
• Branded Clients
• Desktop Client
• Other

@PVince81 Pls let us know if it is correct to have this for 10.2 + no backporting to older releases
@VicDeo @jvillafanez FYI
@settermjd

[PVince81]

@VicDeo can you provide a quick summary that could be incorporated into the documentation ?

If there is a section about federated shares, it could be linked back to the section for this command for improving update detection and syncing.

[VicDeo]

summary: due to performance reasons federated shares are not updated automatically.
The particular directory of the federated share is updated only when user browse into it via web UI.

CLI command occ incoming-shares:poll could be added into the system crontab in order to poll federated shares for updates automatically.

[mmattel]

Just for the record, this command polls all fed shares recieved, there is no path necessary to provide.

[pmaier1]

What is the recommended interval for running the background job? @VicDeo @micbar

[pmaier1]

Does the command provide any options?

[micbar]

@pmaier1 The first question is currently discussed in our testing.

This command does not provide any options.

[VicDeo]

What is the recommended interval for running the background job?

The recommended is never. :)
Since it iterates through all federated shares in one go the interval depends on the federated shares amount.
Once per 12 hours should be safe enough for any instance. It could be reduced to once per 2 hrs for instances with low federated shares amount.

[pmaier1]

Can we add some more information like I tried in the release notes (starting here https://github.com/owncloud/docs/pull/967/files#diff-ba12788edde90b189cd9bb4d1b5492afR90)? I think that makes it more clear for admins how to handle the interval for the background job.

[settermjd]

Closing, as the implementing PR, #1134, has been merged.