Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  1. Fotoware Alto
    • 11.15 Monte Zucchero
    • Terminology
    • Solutions
    • User Guide - Deutsch
    • User Guide - English
    • API Changelog
  2. Fotoware Veloz
    • Managing users and groups
    • Configuring archives
    • Configuring workflows
    • Configuring site behavior
    • Navigating and searching to find your assets
    • Working with your assets
    • Editing asset metadata
    • Uploading files
    • Version Control in Fotoware
    • Albums - Creating and sharing collections
    • Placing assets in a CMS
    • Working with the Fotoware Pro interface
    • Using the Fotoware plugins
    • Consent management
    • User guide to FotoWeb for iPad (Legacy)
    • Picture conferencing with FotoWeb Screens (Legacy)
    • What's what in Fotoware
    • GDPR
    • Fotoware Veloz releases
    • Activity Exports
    • Fotoware Example Workflows
  3. Fotostation
    • Getting started with Fotostation
    • Viewing, selecting and sorting files
    • Managing your assets with archives
    • Adding metadata to assets
    • Searching for assets
    • Working with your assets
    • Version Control in Fotostation
    • Automating tasks with Actions
    • Configuring metadata fields and editors
    • Configuring Fotostation
    • Configuring Fotostation for multi-user environments
    • Troubleshooting Fotostation
  4. Fotoware Flow
    • What is Flow?
    • Getting started
    • Flow dictionary
  5. Fotoware On-Premises
    • Getting started
    • Index Manager
    • FotoWeb
    • Color Factory
    • Connect
    • Operations Center Guide
  6. Integrations and APIs (Fotoware Veloz & On-Premises)
    • The Fotoware API
    • Creating integrations using embeddable widgets
    • Authorizing applications using OAuth
    • Auto-tagging
    • FotoWeb Drag and Drop export
    • Integration using webhooks
    • Optimizely and Episerver plugin documentation
    • User Interface Integrations
  7. Fotoware Mobile
    • User guide for Fotoware Mobile for iPhone and Android
    • User guide to FotoWeb for iPad (Legacy)
    • User guide to FotoWeb for iPhone and Android (Legacy)

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

Support

Table of Contents

Upgrading from Feature Release 19 to Feature Release 20 Note Prerequisite Uninstalling the FotoWeb MongoDB service Uninstalling Feature Release 19 Upgrading MongoDB version from 4.4 to version 8.x Scripted upgradeThis zip file contains the upgrade plus the script to do the upgrade. For more information, see Readme.md in the zip file. Manual upgrade Configuring FotoWeb Note Installing the new Feature Release software
  • Home
  • Fotoware On-Premises
  • FotoWeb
  • Installing FotoWeb (On-Premises)

Upgrading from Feature Release 19 to Feature Release 20

Draft article explaining how to upgrade from Feature Release 29 to Feature Release 20.

26. May 2025

Elaine Foley

Table of Contents

Upgrading from Feature Release 19 to Feature Release 20 Note Prerequisite Uninstalling the FotoWeb MongoDB service Uninstalling Feature Release 19 Upgrading MongoDB version from 4.4 to version 8.x Scripted upgradeThis zip file contains the upgrade plus the script to do the upgrade. For more information, see Readme.md in the zip file. Manual upgrade Configuring FotoWeb Note Installing the new Feature Release software

Upgrading from Feature Release 19 to Feature Release 20

Note

This is a draft article that is subject to change. 

 

 

Prerequisite

Backup customer data (typically everything at C:\ProgramData\Fotoware) before starting the upgrade. For more information, see Backing up the FotoWeb databases.

Uninstalling the FotoWeb MongoDB service

  1. Stop the existing MongoDB service by running net stop fwmongodb. 
  2. Remove the FotoWeb MongoDB service using the Windows service, services.msc.
  3. If you are using an external MongoDB service, you must stop it manually.
     

Uninstalling Feature Release 19

Uninstall Feature Release 19 software using the standard installer, for example, in Windows Control Panel. The uninstaller stops all FotoWeb services, including the FotoWeb MongoDB server.
 

Upgrading MongoDB version from 4.4 to version 8.x


Scripted upgrade

This zip file contains the upgrade plus the script to do the upgrade. For more information, see Readme.md in the zip file.
 

Manual upgrade

  1. Download zip packages of MongoDB versions 5, 6, and 7 from https://www.mongodb.com/try/download/community. 
    Direct links: 
    Version 5: https://fastdl.mongodb.org/windows/mongodb-windows-x86_64-5.0.30.zip
    Version 6: https://fastdl.mongodb.org/windows/mongodb-windows-x86_64-6.0.18.zip
    Version 7: https://fastdl.mongodb.org/windows/mongodb-windows-x86_64-7.0.16.zip
  2. Download the MSI installer of MongoDB version 8 for Windows x64 platform from  Download MongoDB Community Server. 
  3. Extract the files from the zip packages of MongoDB versions 5, 6, and 7 to any destination.
  4. Install MongoDB version 5 without installing it as a Windows Service.
  • In a cmd shell, run: 
"<uzipped_folder_of_mongodb5>\bin\mongod.exe" --dbpath=c:\ProgramData\FotoWare\FotoWeb\Operations\MongoDBData\
  • In mongo.exe/Robo 3T/Compass, run the following command to update the version to 5.0 (in Robo 3T/Compass, creating a new connection to localhost:27017 is required as the default port number was changed in version 5) :
db.adminCommand( { setFeatureCompatibilityVersion: "5.0" } )
  • Close Robo 3T/Compass. 
  • Return to the open cmd session and stop the mongod.exe process by selecting Ctrl+C.
  1. Repeat the steps above with MongoDB version 6. Remember to change the path and version numbers. 
"<uzipped_folder_of_mongodb6>\bin\mongod.exe" --dbpath=c:\ProgramData\FotoWare\FotoWeb\Operations\MongoDBData\
db.adminCommand( { setFeatureCompatibilityVersion: "6.0" } )

Repeat the steps above for MongoDB version 7. Remember to change the path, and note that the command for version 7 is different: 

"<uzipped_folder_of_mongodb7>\bin\mongod.exe" --dbpath=c:\ProgramData\FotoWare\FotoWeb\Operations\MongoDBData\
db.adminCommand( { setFeatureCompatibilityVersion: "7.0", confirm: true } )
  1. Stop the mongod.exe process by selecting Ctrl+C in the open cmd session and close Robo 3T/Compass.
  2. You can now delete the folders with the extracted zip files for MongoDB versions 5, 6, and 7. 
  3. Run the MSI installer of MongoDB version 8. Select Complete Installation and Install MongoDB as a Service.
  • Keep the service name as MongoDB. 
  • Data Directory and Log Directory can be set to the default values or another location not pointing to C:\ProgramData\FotoWare…
  • If you set MongoDB Windows service account to something other than the default Network Service, ensure it has full permission on the Data Directory and Log Directory. 
  1. Finish the installation using the installation wizard.
  2. Open Windows Services, for example, by going to Control Panel > Administration Tools, and start the MongoDB Server (MongoDB) service.
  3. In mongo.exe/Robo 3T/Compass, run the following command to update the version to 8.0:
 db.adminCommand( { setFeatureCompatibilityVersion: "8.0", confirm: true } )
  1. As a test, run the following command in the MongoDB shell or Robo 3T/Compass and ensure it outputs version 8, for example,8.0.6:
db.version()
  1. Stop MongoDB service.
  2. Copy the files from C:\ProgramData\FotoWare\FotoWeb\Operations\MongoDBData to the path set for Data Directory.
  3. Copy the files from  C:\ProgramData\FotoWare\FotoWeb\Operations\Logs\MongoDB to the path Log Directory.
  4. Run MongoDB service.


Configuring FotoWeb 

In  C:\ProgramData\FotoWare\FotoWeb\ServerSettings\Configuration\System.settings file, set MongoDBPort to 27017 for the following two settings, and save the file:

  • <ServerDatabaseSettings>
  • <FotoWareDatabaseSettings>

We recommend using the default port  27017 or an alternative port. The legacy FotoWeb port 7200 is no longer allowed, and we recommend avoiding well-known ports.

Note

If you skip this step and leave the old ports in the system.settings file, the upgrade wizard will display the following error message and will not run. 

In this case, after fixing the port numbers, the upgrade wizard can be run manually via cmd: 

"C:\Program Files\FotoWare\FotoWeb\fwsetup.exe" -installModeReal
 

 

Installing the new Feature Release software

  1. Upgrade to the latest version of Index Manager.
  2. In the Index Manager Settings app, go to General  > Indexes and make sure the MongoDB host is updated to the new port number 27017 if you are using the Push metadata to FotoWeb server option.
     

 

  1. Install the FotoWeb FR20 release using the FotoWeb installer and following the upgrade process. FotoWeb FR 20 has x64 architecture and installs files to C:\Program Files\FotoWare\FotoWeb.
  2. Install FFmpeg. For more information, see How to install FFmpeg for Fotoweb, Index Manager, and Color Factory.
  3. FotoWeb is proven to work with FFmpeg 4.4.1; new versions are not supported. Index Manager supports the new FFmpeg version 7.1.1.
updating transitioning

Was this article helpful?

Yes
No
Give feedback about this article

Related Articles

  • Refreshing tokens
  • Handling OAuth 2.0 errors
  • Good practice for requesting access tokens
eco-lighthouse-miljøfyrtårn

Company

  • About us
  • Resellers
  • Careers
  • Contact us

Help & support

  • Support center
  • Consultancy
  • Tech partners
  • Fotostation
  • System status

Trust Center

  • Legal
  • Security
  • Sustainability & ESG

Locations

Fotoware AS (HQ)
Tollbugata 35
0157 OSLO
Norway
FotoWare Switzerland AG
Industriestrasse 25
5033 Buchs (AG)
Switzerland

Copyright 2025 Fotoware All rights reserved.

  • Terms of service
  • Privacy policy
  • Cookie policy

Knowledge Base Software powered by Helpjuice

Expand