mirror of
https://github.com/abraunegg/onedrive
synced 2024-06-08 08:52:15 +02:00
Update documentation
* Update documentation
This commit is contained in:
parent
f325337fcc
commit
1482f1cb5d
2
config
2
config
|
@ -40,7 +40,7 @@
|
||||||
# bypass_data_preservation = "false"
|
# bypass_data_preservation = "false"
|
||||||
# azure_ad_endpoint = ""
|
# azure_ad_endpoint = ""
|
||||||
# azure_tenant_id = "common"
|
# azure_tenant_id = "common"
|
||||||
# sync_business_shared_folders = "false"
|
# sync_business_shared_items = "false"
|
||||||
# sync_dir_permissions = "700"
|
# sync_dir_permissions = "700"
|
||||||
# sync_file_permissions = "600"
|
# sync_file_permissions = "600"
|
||||||
# rate_limit = "131072"
|
# rate_limit = "131072"
|
||||||
|
|
|
@ -2,184 +2,32 @@
|
||||||
## Application Version
|
## Application Version
|
||||||
Before reading this document, please ensure you are running application version [![Version](https://img.shields.io/github/v/release/abraunegg/onedrive)](https://github.com/abraunegg/onedrive/releases) or greater. Use `onedrive --version` to determine what application version you are using and upgrade your client if required.
|
Before reading this document, please ensure you are running application version [![Version](https://img.shields.io/github/v/release/abraunegg/onedrive)](https://github.com/abraunegg/onedrive/releases) or greater. Use `onedrive --version` to determine what application version you are using and upgrade your client if required.
|
||||||
|
|
||||||
|
## Important Note
|
||||||
|
This feature has been 100% re-written from v2.5.0 onwards. A pre-requesite before using this capability in v2.5.0 and above is for you to revert any Shared Business Folder configuration you may be currently using, including, but not limited to:
|
||||||
|
* Removing `sync_business_shared_folders = "true|false"` from your 'config' file
|
||||||
|
* Removing the 'business_shared_folders' file
|
||||||
|
* Removing any local data | shared folder data from your configured 'sync_dir' to ensure that there are no conflicts or issues.
|
||||||
|
|
||||||
## Process Overview
|
## Process Overview
|
||||||
Syncing OneDrive Business Shared Folders requires additional configuration for your 'onedrive' client:
|
Syncing OneDrive Business Shared Folders requires additional configuration for your 'onedrive' client:
|
||||||
1. List available shared folders to determine which folder you wish to sync & to validate that you have access to that folder
|
1. From the OneDrive web interface, review the 'Shared' objects that have been shared with you.
|
||||||
2. Create a new file called 'business_shared_folders' in your config directory which contains a list of the shared folders you wish to sync
|
2. Select the applicable folder, and click the 'Add shortcut to My files', which will then add this to your 'My files' folder
|
||||||
3. Test the configuration using '--dry-run'
|
3. Update your OneDrive Client for Linux 'config' file to enable the feature by adding `sync_business_shared_items = "true"`. Adding this option will trigger a `--resync` requirement.
|
||||||
4. Sync the OneDrive Business Shared folders as required
|
4. Test the configuration using '--dry-run'
|
||||||
|
5. Remove the use of '--dry-run' and sync the OneDrive Business Shared folders as required
|
||||||
|
|
||||||
## Listing available OneDrive Business Shared Folders
|
|
||||||
List the available OneDrive Business Shared folders with the following command:
|
|
||||||
```text
|
|
||||||
onedrive --list-shared-folders
|
|
||||||
```
|
|
||||||
This will return a listing of all OneDrive Business Shared folders which have been shared with you and by whom. This is important for conflict resolution:
|
|
||||||
```text
|
|
||||||
Initializing the Synchronization Engine ...
|
|
||||||
|
|
||||||
Listing available OneDrive Business Shared Folders:
|
**NOTE:** This documentation will be updated as this feature progresses.
|
||||||
---------------------------------------
|
|
||||||
Shared Folder: SharedFolder0
|
|
||||||
Shared By: Firstname Lastname
|
|
||||||
---------------------------------------
|
|
||||||
Shared Folder: SharedFolder1
|
|
||||||
Shared By: Firstname Lastname
|
|
||||||
---------------------------------------
|
|
||||||
Shared Folder: SharedFolder2
|
|
||||||
Shared By: Firstname Lastname
|
|
||||||
---------------------------------------
|
|
||||||
Shared Folder: SharedFolder0
|
|
||||||
Shared By: Firstname Lastname (user@domain)
|
|
||||||
---------------------------------------
|
|
||||||
Shared Folder: SharedFolder1
|
|
||||||
Shared By: Firstname Lastname (user@domain)
|
|
||||||
---------------------------------------
|
|
||||||
Shared Folder: SharedFolder2
|
|
||||||
Shared By: Firstname Lastname (user@domain)
|
|
||||||
...
|
|
||||||
```
|
|
||||||
|
|
||||||
## Configuring OneDrive Business Shared Folders
|
|
||||||
1. Create a new file called 'business_shared_folders' in your config directory
|
|
||||||
2. On each new line, list the OneDrive Business Shared Folder you wish to sync
|
|
||||||
```text
|
|
||||||
[alex@centos7full onedrive]$ cat ~/.config/onedrive/business_shared_folders
|
|
||||||
# comment
|
|
||||||
Child Shared Folder
|
|
||||||
# Another comment
|
|
||||||
Top Level to Share
|
|
||||||
[alex@centos7full onedrive]$
|
|
||||||
```
|
|
||||||
3. Validate your configuration with `onedrive --display-config`:
|
|
||||||
```text
|
|
||||||
Configuration file successfully loaded
|
|
||||||
onedrive version = v2.4.3
|
|
||||||
Config path = /home/alex/.config/onedrive-business/
|
|
||||||
Config file found in config path = true
|
|
||||||
Config option 'check_nosync' = false
|
|
||||||
Config option 'sync_dir' = /home/alex/OneDriveBusiness
|
|
||||||
Config option 'skip_dir' =
|
|
||||||
Config option 'skip_file' = ~*|.~*|*.tmp
|
|
||||||
Config option 'skip_dotfiles' = false
|
|
||||||
Config option 'skip_symlinks' = false
|
|
||||||
Config option 'monitor_interval' = 300
|
|
||||||
Config option 'min_notify_changes' = 5
|
|
||||||
Config option 'log_dir' = /var/log/onedrive/
|
|
||||||
Config option 'classify_as_big_delete' = 1000
|
|
||||||
Config option 'sync_root_files' = false
|
|
||||||
Selective sync 'sync_list' configured = false
|
|
||||||
Business Shared Folders configured = true
|
|
||||||
business_shared_folders contents:
|
|
||||||
# comment
|
|
||||||
Child Shared Folder
|
|
||||||
# Another comment
|
|
||||||
Top Level to Share
|
|
||||||
```
|
|
||||||
|
|
||||||
## Performing a sync of OneDrive Business Shared Folders
|
|
||||||
Perform a standalone sync using the following command: `onedrive --synchronize --sync-shared-folders --verbose`:
|
|
||||||
```text
|
|
||||||
onedrive --synchronize --sync-shared-folders --verbose
|
|
||||||
Using 'user' Config Dir: /home/alex/.config/onedrive-business/
|
|
||||||
Using 'system' Config Dir:
|
|
||||||
Configuration file successfully loaded
|
|
||||||
Initializing the OneDrive API ...
|
|
||||||
Configuring Global Azure AD Endpoints
|
|
||||||
Opening the item database ...
|
|
||||||
All operations will be performed in: /home/alex/OneDriveBusiness
|
|
||||||
Application version: v2.4.3
|
|
||||||
Account Type: business
|
|
||||||
Default Drive ID: b!bO8V7s9SSk6r7mWHpIjURotN33W1W2tEv3OXV_oFIdQimEdOHR-1So7CqeT1MfHA
|
|
||||||
Default Root ID: 01WIXGO5V6Y2GOVW7725BZO354PWSELRRZ
|
|
||||||
Remaining Free Space: 1098316220277
|
|
||||||
Fetching details for OneDrive Root
|
|
||||||
OneDrive Root exists in the database
|
|
||||||
Initializing the Synchronization Engine ...
|
|
||||||
Syncing changes from OneDrive ...
|
|
||||||
Applying changes of Path ID: 01WIXGO5V6Y2GOVW7725BZO354PWSELRRZ
|
|
||||||
Number of items from OneDrive to process: 0
|
|
||||||
Attempting to sync OneDrive Business Shared Folders
|
|
||||||
Syncing this OneDrive Business Shared Folder: Child Shared Folder
|
|
||||||
OneDrive Business Shared Folder - Shared By: test user
|
|
||||||
Applying changes of Path ID: 01JRXHEZMREEB3EJVHNVHKNN454Q7DFXPR
|
|
||||||
Adding OneDrive root details for processing
|
|
||||||
Adding OneDrive folder details for processing
|
|
||||||
Adding 4 OneDrive items for processing from OneDrive folder
|
|
||||||
Adding 2 OneDrive items for processing from /Child Shared Folder/Cisco VDI Whitepaper
|
|
||||||
Adding 2 OneDrive items for processing from /Child Shared Folder/SMPP_Shared
|
|
||||||
Processing 11 OneDrive items to ensure consistent local state
|
|
||||||
Syncing this OneDrive Business Shared Folder: Top Level to Share
|
|
||||||
OneDrive Business Shared Folder - Shared By: test user (testuser@mynasau3.onmicrosoft.com)
|
|
||||||
Applying changes of Path ID: 01JRXHEZLRMXHKBYZNOBF3TQOPBXS3VZMA
|
|
||||||
Adding OneDrive root details for processing
|
|
||||||
Adding OneDrive folder details for processing
|
|
||||||
Adding 4 OneDrive items for processing from OneDrive folder
|
|
||||||
Adding 3 OneDrive items for processing from /Top Level to Share/10-Files
|
|
||||||
Adding 2 OneDrive items for processing from /Top Level to Share/10-Files/Cisco VDI Whitepaper
|
|
||||||
Adding 2 OneDrive items for processing from /Top Level to Share/10-Files/Images
|
|
||||||
Adding 8 OneDrive items for processing from /Top Level to Share/10-Files/Images/JPG
|
|
||||||
Adding 8 OneDrive items for processing from /Top Level to Share/10-Files/Images/PNG
|
|
||||||
Adding 2 OneDrive items for processing from /Top Level to Share/10-Files/SMPP
|
|
||||||
Processing 31 OneDrive items to ensure consistent local state
|
|
||||||
Uploading differences of ~/OneDriveBusiness
|
|
||||||
Processing root
|
|
||||||
The directory has not changed
|
|
||||||
Processing SMPP_Local
|
|
||||||
The directory has not changed
|
|
||||||
Processing SMPP-IF-SPEC_v3_3-24858.pdf
|
|
||||||
The file has not changed
|
|
||||||
Processing SMPP_v3_4_Issue1_2-24857.pdf
|
|
||||||
The file has not changed
|
|
||||||
Processing new_local_file.txt
|
|
||||||
The file has not changed
|
|
||||||
Processing root
|
|
||||||
The directory has not changed
|
|
||||||
...
|
|
||||||
The directory has not changed
|
|
||||||
Processing week02-03-Combinational_Logic-v1.pptx
|
|
||||||
The file has not changed
|
|
||||||
Uploading new items of ~/OneDriveBusiness
|
|
||||||
Applying changes of Path ID: 01WIXGO5V6Y2GOVW7725BZO354PWSELRRZ
|
|
||||||
Number of items from OneDrive to process: 0
|
|
||||||
Attempting to sync OneDrive Business Shared Folders
|
|
||||||
Syncing this OneDrive Business Shared Folder: Child Shared Folder
|
|
||||||
OneDrive Business Shared Folder - Shared By: test user
|
|
||||||
Applying changes of Path ID: 01JRXHEZMREEB3EJVHNVHKNN454Q7DFXPR
|
|
||||||
Adding OneDrive root details for processing
|
|
||||||
Adding OneDrive folder details for processing
|
|
||||||
Adding 4 OneDrive items for processing from OneDrive folder
|
|
||||||
Adding 2 OneDrive items for processing from /Child Shared Folder/Cisco VDI Whitepaper
|
|
||||||
Adding 2 OneDrive items for processing from /Child Shared Folder/SMPP_Shared
|
|
||||||
Processing 11 OneDrive items to ensure consistent local state
|
|
||||||
Syncing this OneDrive Business Shared Folder: Top Level to Share
|
|
||||||
OneDrive Business Shared Folder - Shared By: test user (testuser@mynasau3.onmicrosoft.com)
|
|
||||||
Applying changes of Path ID: 01JRXHEZLRMXHKBYZNOBF3TQOPBXS3VZMA
|
|
||||||
Adding OneDrive root details for processing
|
|
||||||
Adding OneDrive folder details for processing
|
|
||||||
Adding 4 OneDrive items for processing from OneDrive folder
|
|
||||||
Adding 3 OneDrive items for processing from /Top Level to Share/10-Files
|
|
||||||
Adding 2 OneDrive items for processing from /Top Level to Share/10-Files/Cisco VDI Whitepaper
|
|
||||||
Adding 2 OneDrive items for processing from /Top Level to Share/10-Files/Images
|
|
||||||
Adding 8 OneDrive items for processing from /Top Level to Share/10-Files/Images/JPG
|
|
||||||
Adding 8 OneDrive items for processing from /Top Level to Share/10-Files/Images/PNG
|
|
||||||
Adding 2 OneDrive items for processing from /Top Level to Share/10-Files/SMPP
|
|
||||||
Processing 31 OneDrive items to ensure consistent local state
|
|
||||||
```
|
|
||||||
|
|
||||||
**Note:** Whenever you modify the `business_shared_folders` file you must perform a `--resync` of your database to clean up stale entries due to changes in your configuration.
|
|
||||||
|
|
||||||
## Enable / Disable syncing of OneDrive Business Shared Folders
|
|
||||||
Performing a sync of the configured OneDrive Business Shared Folders can be enabled / disabled via adding the following to your configuration file.
|
|
||||||
|
|
||||||
### Enable syncing of OneDrive Business Shared Folders via config file
|
### Enable syncing of OneDrive Business Shared Folders via config file
|
||||||
```text
|
```text
|
||||||
sync_business_shared_folders = "true"
|
sync_business_shared_items = "true"
|
||||||
```
|
```
|
||||||
|
|
||||||
### Disable syncing of OneDrive Business Shared Folders via config file
|
### Disable syncing of OneDrive Business Shared Folders via config file
|
||||||
```text
|
```text
|
||||||
sync_business_shared_folders = "false"
|
sync_business_shared_items = "false"
|
||||||
```
|
```
|
||||||
|
|
||||||
## Known Issues
|
## Known Issues
|
||||||
|
|
Loading…
Reference in a new issue