Important
Before initiating the migration, it is essential to validate all the points listed below to ensure a smooth transition without any service interruption.
For any questions or technical support needs, our team remains at your disposal

Introduction

This document outlines the procedure for migrating Gespage from version v9.2 to version v9.3, along with the checks and precautions to take before any update.

We recommend reviewing the release notes for the version before reading this article (see Release Notes 9.3).

If your current version is earlier than 9.2, we recommend consulting the dedicated migration articles beforehand.

Important Informations Regarding the Update

Below are some specific operations to be performed during this update: 

• User Interface 
  • Due to numerous changes made to the user interface configuration, it is necessary to fully reconfigure it after the update.
    
  • For On-Premise installations, the user interface port is changed to port 7143 after the update. We recommend anticipating the impact on your network traffic rules and updating the site link provided to users accordingly.
• Web payment
  • The configuration in the Worldline portal must be updated to activate the new integration mode (Worldline Direct API).
    
  • For more information on web payment configuration, please refer to the dedicated article: Web Payment Configuration. 
• Xerox eTerminal 
  • Each Xerox eTerminal must be pushed again after the update to Gespage version 9.3.
    
  • This new version enables the use of Gespage scan, which requires configuration of Gespage advanced scan settings (see Gespage v9 manual and Xerox eTerminal manual).
  • A firmware update of the MFP may be required to ensure compatibility. 
• Canon eTerminal
  • This new version enables the use of Gespage scan, which requires configuration of Gespage advanced scan settings (see Gespage v9 manual) and deployment of the new GespageScan application (see Canon eTerminal manual).
• System
  • The upgrade of PostgreSQL requires reinstallation of the database. cf : PostgreSQL Update Procedure : Gespage 
• Linux
  • After upgraded the Gespage Linux version, please restart Gespage application server with the command line below: 

    sudo systemctl restart gespage-server.service

    
    

    
    

Limitations

The following features are not yet supported in version 9.3.0.
We recommend postponing your update if you rely on them. 

• User interface
  • SSO login (with a CAS server) is not yet available
• Web Payment
  • Paypal Integration : Payment via the Paypal gateway is not yet available
• eTerminal Xerox
  • Access rights management is not yet available

Deprecated Features

The following features have been deprecated.

If you have questions about their alternatives, please contact Gespage support.

• User interface
  • Anonymous login mode is deprecated. A Gespage account is now required to print via the user interface.
  • User interface display: Menu customization is deprecated.
    
• Xerox eTerminal
  • The custom Gespage login screen is deprecated