owncloud / data_exporter

Export/Import for ownCloud user data

GNU General Public License v2.0

7 stars 5 forks source link

User manual - Draft #44

Closed IljaN closed 5 years ago

IljaN commented 5 years ago

Feel free to edit/commit.

Closes #13

codecov-io commented 5 years ago

Codecov Report

Merging #44 into master will not change coverage. The diff coverage is n/a.

@@            Coverage Diff            @@
##             master      #44   +/-   ##
=========================================
  Coverage     41.16%   41.16%           
  Complexity      204      204           
=========================================
  Files            29       29           
  Lines           838      838           
=========================================
  Hits            345      345           
  Misses          493      493

Continue to review full report at Codecov.

Legend - Click here to learn more Δ = absolute <relative> (impact), ø = not affected, ? = missing data Powered by Codecov. Last update c2476b5...1c4ce64. Read the comment docs.

mmattel commented 5 years ago

@IljaN thanks for this proposal.

This kind of documentation MUST go into the documentation for occ commands for apps: https://github.com/owncloud/docs/tree/master/modules/administration_manual/pages/configuration/server/occ_app_command.adoc and into a own new description file (like we have for LDAP, https://github.com/owncloud/docs/tree/master/modules/administration_manual/pages/configuration/user/user_auth_ldap.adoc).

You will find many reusable things / templates there you can copy / paste and adopt according the needs.

@settermjd fyi

Comment updated to reflect content and locations

jvillafanez commented 5 years ago

Also known limitations:

Share's state will be always "accepted" regardless of the state in the old server.
Remote shares from both directions (the ones created via the import:user in the new server as well as the ones created via export:migrate:share on the old server) need to be manually accepted.

jvillafanez commented 5 years ago

Some additional notes:

overwrite.cli.url key in the config.php MUST be properly set, otherwise there will be problems during the import because shares created in the new server won't be able to connect to the old one.
if you're using https, make sure the certificates are recognized by both servers. The easiest way to test this is to create a remote share from the UI, both from the old server to the new and the other way around. Verify you can do this before importing.
if you're using http (you shouldn't), make sure the sharing.federation.allowHttpFallback key in the config.php is set to true. In addition, verify you can create remote shares as said above.

mmattel commented 5 years ago

@jvillafanez you may have overseen it, I have opened an PR in docs, see link above, please add you comments there. As written in the PR, any comments or changes here will not find its way to the user - which means it is worthless to continue this PR here. Only the docs PR is the valid one. Thanks