This week is all about moving the content library to a remote location in Configuration Manager, version 1806. Moving the content library to a remote location is an important step in making a Configuration Manager hierarchy high available. Configuration Manager, version 1806, introduced site server high availability for a standalone primary site server role by installing an additional site server in passive mode. To complete that high available configuration it’s also smart to move the content library to a remote location. That will make sure that the content library is still available when the active site server went down. This post will provide the prerequisites for moving the content library, the steps to move the content library and the flow when moving the content library.
Before actually moving the content library to a remote location, make sure that the following prerequisites are in place:
- Create a folder on a network share that will be used as the location for the content library;
- Provide the site server account with read and write permissions to the created folder;
- Make sure that the site server doesn’t have the distribution point role.
Move content library
Now let’s have a look at actually moving the content library. This action is actually relatively simply and can be achieved by performing the following four steps.
Important to mention is that this action actually only copies the content library to the specified remote location. It doesn’t remove the content library from the old location. That would be a manual action.
Follow the flow
Let’s end this post by following the flow through the main log files and the Configuration Manager administration console. In my opinion always the most interesting part. I would like to divide this into three sections, 1) the actual trigger of the move content library action, 2) the start of the copy content action and 3) the end of the copy content action.
More information about the content library and the flowchart for managing content, please refer to the following articles:
- Flowchart – Manage content library: https://docs.microsoft.com/en-us/sccm/core/plan-design/hierarchy/manage-content-library-flowchart
- The content library in Configuration Manager: https://docs.microsoft.com/en-us/sccm/core/plan-design/hierarchy/the-content-library
22 thoughts on “Move the content library to a remote location”
There is an issue with the permissions when you move your content library to a remote share, when you create any new packages/applications/etc, it successfully creates a folder and .ini file inside the DataLib directory, however it strips off the permissions of the actual .ini file inside the reference folder.
This file has inheritance turned on, but only has the remote servers ‘Administrators’ and ‘Users’ group as rights. This would normally be fine when the content was stored locally on the primary site, however now that it is on a remote storage, this will result in the configmgr instance failing to gather and deploy content from this location.
The potential work around is to ensure your primary site computer account is included in the remote server being used for the shares local groups. But beware situations where this is not possible.
Thank you for sharing Mitch!
In addition to my comment above, after logging a premiere support ticket with Microsoft over the issue, it appears the permissions being set on the file is by design for legacy reasons for content on the distribution points, however it is applying to the primary site content library as well. There is a setting within the admin console that allows you to add an AD group to the permissions, however it is a setting PER app/package/driver/etc, which is not feasible to manage large scale. There is a ticket in for this to be fixed, or the ability to set it globally in a hotfix.
Thank you for the update, Mitch!
Well written article!
I haven’t had luck moving content library to DFS Namespace with replication enabled. Do know if this is supported? Any suggestions is appreciated. I would like to move content library to DFS for high availability too.
I haven’t read anything, yet, that it doesn’t work. What is the behavior that you’re seeing?
Nice organized article,
When I try “Manage Content Library” I find Current Location is empty, although Content Library is located on single Disk where SCCM installed,
What can be the issue and how to troubleshoot it?
Is that site server by any chance also running a DP?
Does anyone know what ports are required to be open between the site server and the remote content library and remote package share? I am in the process of configuring this however I need to document the ports required. Any help is appreciated?
All the required ports for ConfigMgr are documented here: https://docs.microsoft.com/en-us/sccm/core/plan-design/hierarchy/ports
You say for the content library to be moved you have to make sure the site server does not have the distribution point role installed. But in a single server hierarchy the primary site server always has that role installed. How are you to perform this process in that case?
In that case this won’t help you, as it won’t be possible if the distribution point is on the same server.
When I try “Manage Content Library” I have Current Location is empty and “Invalid location” error for any path in New Location.
Content Library is located on single Disk where SCCM installed. No DP on site server.
What can be the issue and how to troubleshoot it?
Can you provide some more details about what you’re trying to move from were to were (and the roles of those servers)?
I have the exact same issue as Andrew:
‘When I try “Manage Content Library” I have Current Location is empty and “Invalid location” error for any path in New Location.
Content Library is located on single Disk where SCCM installed. No DP on site server.’
I have two servers: primary site server without DP role, and a DP server. My primary site server’s Content Library is using 750 GB of space, while the sum of all my content is only about 400 GB. All my content is on the DP server.
Peter, does this issue make sense to you? I think my site server used to have the DP role on it, but it does not any more. Any idea how to go about cleaning up the content library on the site server without the DP role installed? It seems to me the Content Library Cleanup/Transfer tools won’t help and I am out of ideas!
Every site server also contains the content library. You might want to check the mentioned logs for the exact reason why it’s failing.
Thank you for your article, I found that the level of detail provided was very useful.
I had the same issue as Paul and found that the New Location required a sub-folder after the share name before it would allow me to proceed, the Current Location remained greyed out.
Thank you for the information, Arthur!
thank you for the informative article.
One additional question, is it possible to do this action during the normal working time or do we have to plan a downtime? I tried it already on our test environment and the copy action lasted 2 hours. If we scale the size of this contentlib to the one of our productive environment we would need something about 8 hours oO.
That depends the usage of the environment.
Hey. I made a mistake in typing the destination.
in distrmgr.log it said it could not reach the destination and it would try in an hour.
I filled in the correct destination, by moving it again and after an hour it went to the correct one.
Just leaving this here for people with the same issue 🙂
Thank you for that Martijn!