Affected versions
This article applies to all versions of Portfolio 4. These steps do not apply to vault catalogs.
Solution
Create a backup
Before making a change like this it's best to create a backup beforehand so that should any mistakes are made, you can always roll back to the previous version of the database
Removing the watched folder
Log in to the Portfolio Web client as the default administrator, or as a user with the Catalog Administrator permission.
Select the catalog to be updated. Select the old watched folder in the folder pane and click the minus (–) button.
A dialog appears asking you to confirm. Leave the Remove Assets from Catalog checkbox unchecked; checking that checkbox will cause Portfolio to delete the records to be updated. Click Remove.
Updating the paths using the update-paths script example:
On Windows, open a Command Prompt window and change to Portfolio's applications subfolder. (cd C:\Program Files (x86)\Extensis\Portfolio Server\applications
)
To change the path name from using "Images" to "Digital Assets" in the catalog "Assets":
update-paths.cmd -u administrator -p <password> -c "Assets" -o "::Portfolio:Portfolio:Users:Shared:Portfolio:Images:" -n "::Portfolio:Portfolio:Users:Shared:Portfolio:Digital Assets:"
On macOS, open the Terminal window and change to Portfolio's application subfolder (cd "/Applications/Extensis/Portfolio Server/applications/"
).
To change the path name from using "Images" to "Digital Assets" in the catalog "Assets":
./update-paths.sh -u administrator -p <password> -c "Assets" -o "::Portfolio:Portfolio:Users:Shared:Portfolio:Images:" -n "::Portfolio:Portfolio:Users:Shared:Portfolio:Digital Assets:"
Substitute the above information with the values in your instance. You can change the server name, the network share name, the folder path, or any combination of the above when updating the path.
NOTE: The new path value and the path when you add the folder in the next step must match exactly. If they do not you run the risk of record duplication. You may want to try adding the watchfolder into a test catalog first, and then copy the path directly from that watchfolder into the script.
Adding the new watched folder
After the paths have been updated, you will add the new watched folder to your catalog.
Click the plus (+) button in the lower-left corner of the folders pane and choose New Watch Folder.
Select the path to the new folder. If the folder resides on a network share, enter the path in the Folder Path field at the top of the New Watch Folder dialog.
Once the new watched folder has been added, Portfolio will check for new and missing files.
Double check your work afterwards by making sure there are no duplicate records in the catalog after the script has run.