Installation and Deployment > How to Install Update HOPEX V2R1 U3 > Upgrading HOPEX programs
Upgrading HOPEX programs
 
Upgrading Web Front-end
Upgrading Windows Front-end
Note that from HOPEX V2R1 Update 2, the component Microsoft URL Rewrite Module 2.0 is required. You need to
• Download it from Microsoft web site.
Ex: https://www.microsoft.com/en-us/download/details.aspx?id=47337
• Install it manually on each target machine.
 
The update installation program is an .EXE file.
For example: HOPEX_V2R1_U01.0.exe
 
The procedure varies with the front-ends that you may use:
o Web Front-end: an IIS web server is used, a specific SSP service (1) is used
o Windows Front-end: no web server is used; no service is used.
 
As a consequence, it is very important that you identify the front-ends deployed and the target machines.
 
 
Front-end
Deployment
Target machine
Web Front-end
Web standalone deployment
Unique Server where HOPEX programs are installed
Web Front-end
Web cluster deployment
Each application server of the cluster where HOPEX programs are installed
• HOPEX Front-end
• HOPEX Back-end
• SSP
Windows Front-end
 
Windows standard deployment
Each workstation where HOPEX programs are installed
Windows Front-end
 
Windows Citrix/Terminal Server deployment
Each Citrix/TSE application server where HOPEX programs are installed
 
Deployment
Machine
Windows Service
IIS Web site (1)
HOPEX processes
Web standalone deployment
Unique server
Yes
Yes
Yes
Web cluster deployment
Server running SSP
Yes
 
Yes
Web cluster deployment
Server running HOPEX Back-end
Server running HOPEX Front-end
Yes
 
Yes
Windows Citrix/Terminal Server deployment
Each workstation
No
 
Yes
Windows standard deployment
Each Citrix/TSE application server
No
 
Yes
 
(1) By default, an application 'HOPEX' is configured for 'Default Web Site'.
 
Upgrading Web Front-end
 
Pre-install:
1. Identify the target machine(s).
The machine varies with the chosen deployment: see above table.
2. Archive key configuration file of IIS application (web.config file) and HOPEX installation (Megasite.ini).
3. Login in as administrator of the machine.
4. Verify ‘Control Panel > Administrative tools > Services'.
The service HOPEX Site Service Provider must be set to 'Stopped'.
The service HOPEX Service Watchdog must be set to 'Stopped'.
5. Verify ‘Internet Information Services (IIS) Manager'.
The web site hosting the IIS applications (by default it is 'Default Web Site') must be stopped.
6. Verify the Task Manager.
No HOPEX process (mgw*.exe or HOPEX*.exe) must be running.
7. Check that Microsoft URL Rewrite Module 2.0 is installed
You can download it from Microsoft web sites.
8. Verify ‘Control Panel > Add or Remove programs'.
The required update level must be installed.
Ex: HOPEX V2R1 U01 (HOPEX V2R1 Update 1) is a requirement before installing HOPEX V2R1 U02 ((HOPEX V2R1 Update 2).
 
Note: you can also use the utility Hopex Server Supervisor and R click > HOPEX > Stop HOPEX Processes Services and Web Application.
 
Procedure:
For each machine:
1. Select the .EXE file of the update.
Example: Select HOPEX_V2R1_U02.0.exe
2. R click > Run as administrator
The wizard can take more than 1 min to load.
3. Click Update >.
The installation process can take a minute to initialize.
Wait until the processing is complete.
4. Click Finish.
 
Post-install:
o Verify ‘Control Panel > Administrative tools > Services'.
The service HOPEX Site Service Provider must be set back to 'Automatic (Delayed Start)' and be started.
The service HOPEX Service Watchdog must be set back to 'Automatic (Delayed Start)' and be started.
o Verify ‘Internet Information Services (IIS) Manager'.
The web site hosting the IIS applications (by default it is 'Default Web Site') must be started.
 
Notes:
o You can also use the utility Hopex Server Supervisor and R click > HOPEX > Restart HOPEX Processes Services and Web Application to restart installation.
o The location of the installation folder can be found after a search is conducted in the machine registry. This location is not visible on the machine during installation or in the control panel.
o If the expected update level is not identified for the HOPEX programs registered on the machine, an error is displayed.
Upgrading Windows Front-end
 
Pre-install:
1. Identify the target machine(s).
The machine varies with the chosen deployment: see above table.
2. Archive key configuration file of IIS application (file web.config) and HOPEX installation (Megasite.ini).
3. Login in as administrator of the machine.
4. Verify the Task Manager.
No HOPEX process (mgwmapp.exe or HOPEX*.exe) must be running.
5. Verify ‘Control Panel > Add or Remove programs'.
The required update level must be installed.
For example, HOPEX V2R1 U07.0 is a requirement before installing HOPEX V2R1 U08.0.
 
Procedure:
For each machine:
1. Select the .EXE file of the update.
Example: Select HOPEX_V2R1_U01.0.exe
2. R click > Run as administrator
The wizard can take more than 1 min to load.
3. Click Update >.
The installation process can take a minute to initialize.
Wait until the processing is complete.
4. Click Finish.