Library upgrade required, but fails

Plex Media Server Metadata & Adding Files
1

Server Version#: 1.41.3.9292 in Docker on Ubuntu 24.
Player Version#: N/A

I have a video that the Plex agent refuses to recognize, and I was trying to change the agent to anything else. When I select, it shows a link showing “library upgrade required”. If I select it and click Upgrade on the dialog, it spins for a second and goes away. However, if I look at the library, the agent hasn’t been changed. In the logs, it looks like the change to the agent fails with a 404 before the upgrade is clicked.
com.plexapp.system_2024-12-23_11-34-31.log (10.3 KB)

2

Server Version#: 1.41.3.9314
Windows Server 2025
Player Version#: NA

I to also get this error on both my library’s. I want to change the Agent to The Movie Database but unable to do so.

Probably should have reported this sooner but, this has been going on for a while now.

3

Don’t switch agents willy-nilly, just because one file gives you trouble.
The legacy agents are deprecated and should no longer be used, as this will give you trouble in the not-so-far future.

Switching agents does have serious consequences for the whole library. Switching from the modern agent to the legacy is often unsuccessful. There have been cases where switching back and forth has irreparably damaged the database.
It should not even be attempted, IMHO.

If you cannot match one video, look first for possible reasons.

  1. ambiguous file naming, which can cause the file to get matched as a different version of an already existing movie. Use the “Duplicates” filter to find such files.
  2. the file is a concatenated mini-series. Plex’s agents will not match a mini-series as a movie. Nor will the reverse case work if your video is a special that belongs into a TV show.
    Research on IMDb.com and TheMovieDB.org whether that may be case with your file.
  3. the title isn’t listed at all on either IMDb.com, TheMovieDB.org, or TheTVDB.com
  4. the title is rated as “adult” content, but the matching of such content hasn’t been enabled in the properties of the library
  5. the file is in a mp4/m4v container and has embedded meta tags which throw off the matching.
  6. the file has been downloaded or ripped directly into the folder which is added to the Plex library. This can lead to Plex scanning an incomplete file, which in turn can cause Plex to mistake the file for another incomplete file it encountered before. In extreme cases, this can mean it will mistake all files of a certain format as the same movie.
4

I don’t need it to match automatically. I’ve seen stuff where it doesn’t match, and when you try to manually match, the plex agent won’t find the title when you type it in. But I can easily find the title on IMDB or TheMovieDB. It doesn’t happen very often, but it would help if we had the ability to search against another agent ad hoc.

5

This is not possible because you can only use one agent per library.

You pretty much want it to. Make precautions per file names and folder structure in order for this to work. It is the best method to avoid issues – now and in the future.

6

None of which is useful if the Plex Agent doesn’t have a match for my video.

7

What kind of video is it?
If it’s a movie or a tv show, what is its title?
What is the current file name?

8

99.9% of the time its a filename/year issue. Ive got a LOT of media following the plex naming schema, and pretty much everything matches correctly.

EDIT: your log snipit does not contain any useful info. a copy of your server logs may provide more info. The most common issue with library upgrades is either not giving it enough time, not refreshing the metadata, or you have a corrupt database.

9

I’ve been trying to get this update as, i do want to set my agent to the TMDB.

However I get the message about the libary upgrade and click it, nothing happens. Errors in the log are:

2024-12-31 09:54:59,920 (2070) :  ERROR (networking:197) - Error opening URL 'http://resources-cdn.plexapp.com/hashes.json'
2024-12-31 09:54:59,920 (2070) :  CRITICAL (core:574) - Exception getting hosted resource hashes (most recent call last):
  File "C:\Program Files\Plex\Plex Media Server\Resources\Plug-ins-a0bfb8370\Framework.bundle\Contents\Resources\Versions\2\Python\Framework\components\runtime.py", line 1291, in get_resource_hashes
    json = self._core.networking.http_request("http://resources-cdn.plexapp.com/hashes.json", timeout=5).content
  File "C:\Program Files\Plex\Plex Media Server\Resources\Plug-ins-a0bfb8370\Framework.bundle\Contents\Resources\Versions\2\Python\Framework\components\networking.py", line 243, in content
    return self.__str__()
  File "C:\Program Files\Plex\Plex Media Server\Resources\Plug-ins-a0bfb8370\Framework.bundle\Contents\Resources\Versions\2\Python\Framework\components\networking.py", line 221, in __str__
    self.load()
  File "C:\Program Files\Plex\Plex Media Server\Resources\Plug-ins-a0bfb8370\Framework.bundle\Contents\Resources\Versions\2\Python\Framework\components\networking.py", line 159, in load
    f = self._opener.open(req, timeout=self._timeout)
  File "C:\Program Files\Plex\Plex Media Server\python27.zip\urllib2.py", line 435, in open
    response = meth(req, response)
  File "C:\Program Files\Plex\Plex Media Server\python27.zip\urllib2.py", line 548, in http_response
    'http', request, response, code, msg, hdrs)
  File "C:\Program Files\Plex\Plex Media Server\python27.zip\urllib2.py", line 473, in error
    return self._call_chain(*args)
  File "C:\Program Files\Plex\Plex Media Server\python27.zip\urllib2.py", line 407, in _call_chain
    result = func(*args)
  File "C:\Program Files\Plex\Plex Media Server\python27.zip\urllib2.py", line 556, in http_error_default
    raise HTTPError(req.get_full_url(), code, msg, hdrs, fp)
HTTPError: HTTP Error 404: Not Found

com.plexapp.system.log (53.7 KB) - Full log here.

What needs to be done to get this upgraded. The same thing happens on my Movie Library as well.

10

I think I may have answeredmy qestion:

Movie Agents
Plex Movie the one we want, Plex Movie (Legacy) The Movie Database

TV Show Agents
Plex Series the one we want, TheTVDB (Legacy), The Movie Database (Legacy), soon to be retired and not in use.

11

This topic was automatically closed 90 days after the last reply. New replies are no longer allowed.