mirror of
https://github.com/abraunegg/onedrive
synced 2024-05-29 03:52:27 +02:00
5ee30ff623
* Update --get-O365-drive-id to avoid hitting the 'onedrive application is already running' error message
81 lines
3.7 KiB
Markdown
81 lines
3.7 KiB
Markdown
# How to configure OneDrive SharePoint Shared Library sync
|
|
Syncing a OneDrive SharePoint library requires additional configuration for your 'onedrive' client:
|
|
1. Login to OneDrive and under 'Shared Libraries' obtain the shared library name
|
|
2. Query that shared library name using the client to obtain the required configuration details
|
|
3. Create a unique local folder which will be the SharePoint Library 'root'
|
|
4. Configure the client's config file with the required 'drive_id'
|
|
5. Test the configuration using '--dry-run'
|
|
6. Sync the SharePoint Library as required
|
|
|
|
**Note:** The `--get-O365-drive-id` process below requires a fully configured 'onedrive' configuration so that the applicable Drive ID for the given Office 365 SharePoint Shared Library can be determined. It is highly recommended that you do not use the application 'default' configuration directory for any SharePoint Site, and configure separate items for each site you wish to use.
|
|
|
|
## Listing available OneDrive SharePoint Libraries
|
|
1. Login to the OneDrive web interface and determine which shared library you wish to configure the client for:
|
|
|
|
|
|
## Query that shared library name using the client to obtain the required configuration details
|
|
2. Run the following command using the 'onedrive' client
|
|
```text
|
|
onedrive --get-O365-drive-id '<your site name to search>'
|
|
```
|
|
This will return something similar to the following:
|
|
```text
|
|
Configuration file successfully loaded
|
|
Configuring Global Azure AD Endpoints
|
|
Initializing the Synchronization Engine ...
|
|
Office 365 Library Name Query: <your site name to search>
|
|
-----------------------------------------------
|
|
Site Name: <your site name>
|
|
Library Name: <your library name>
|
|
drive_id: b!6H_y8B...xU5
|
|
Library URL: <your library URL>
|
|
-----------------------------------------------
|
|
```
|
|
If there are no matches to the site you are attempting to search, the following will be displayed:
|
|
```text
|
|
Configuration file successfully loaded
|
|
Configuring Global Azure AD Endpoints
|
|
Initializing the Synchronization Engine ...
|
|
Office 365 Library Name Query: blah
|
|
|
|
ERROR: The requested SharePoint site could not be found. Please check it's name and your permissions to access the site.
|
|
|
|
The following SharePoint site names were returned:
|
|
* <site name 1>
|
|
* <site name 2>
|
|
...
|
|
* <site name X>
|
|
```
|
|
This list of site names can be used as a basis to search for the correct site for which you are searching
|
|
|
|
|
|
## Configure the client's config file with the required 'drive_id' & 'sync_dir' options
|
|
3. Create a new local folder to store the SharePoint Library data in
|
|
```text
|
|
mkdir ~/SharePoint_My_Library_Name
|
|
```
|
|
|
|
**Note:** Do not use spaces in the directory name, use '_' as a replacement
|
|
|
|
Update your 'onedrive' configuration file (`~/.config/onedrive/config`) with the following:
|
|
```text
|
|
sync_dir = "~/SharePoint_My_Library_Name"
|
|
```
|
|
|
|
4. Once you have obtained the 'drive_id' above, add to your 'onedrive' configuration file (`~/.config/onedrive/config`) the following:
|
|
```text
|
|
drive_id = "insert the drive_id value from above here"
|
|
```
|
|
The OneDrive client will now be configured to sync this SharePoint shared library to your local system.
|
|
|
|
**Note:** After changing `drive_id`, you must perform a full re-synchronization by adding `--resync` to your existing command line.
|
|
|
|
## Test the configuration using '--dry-run'
|
|
5. Test your new configuration using the `--dry-run` option to validate the the new configuration
|
|
|
|
## Sync the SharePoint Library as required
|
|
6. Sync the SharePoint Library to your system with either `--synchronize` or `--monitor` operations
|
|
|
|
# How to configure multiple OneDrive SharePoint Shared Library sync
|
|
Refer to [./advanced-usage.md](advanced-usage.md) for configuration assistance.
|