Upgrade ENPS Mobile

This section covers upgrading to ENPS Mobile 9.5.

Preparation

Download Installer

Download the ENPS Mobile Platform Installer:

  1. Open the ENPS Downloads site.

    Contact Us if you need a link for the download site. Include your name and the name of your organization with your request.

  2. Log in using your ENPS Downloads site account.

    If you haven't yet registered, click Register and enter your details. You will receive a confirmation email confirming your account. Please allow one business day to gain access.

    If you've forgotten your password, click Lost your password? and follow the instructions to recover your account.

  3. Navigate to the ENPS Mobile page on the site.

  4. Download the ENPS Mobile Platform Installer zip file for version 9.5.

  5. Save the installer zip file on your Mobile Server.

Upgrade

Run the ENPS Mobile Platform Installer to upgrade ENPS Mobile:

  1. Unzip and run the ENPS Mobile Platform Installer.

    If you are unable to run the Mobile Platform Installer, do the following and retry unzipping and running the installer:

    • Right-click the installer zip file and select Properties.

    • Ensure that the General > Unblock box is ticked.

  2. Follow these instructions on each screen:

    Platform Installer screen

     

    Instructions

    Password Protection

    Enter the installation password.

    Contact Us if you cannot find the installation password.

    Server Type

    Select ENPS Web Applications Server (UPDATE AVAILABLE).

     

    Product Selection

    Select both products to upgrade by ticking the Upgrade boxes:

    • ENPS Web Access - upgrades ENPS Mobile.

    • ENPS JSON Web Service- upgrade required for ENPS web server.

    Prerequisites

     

    Click Install Prerequisites to install any missing prerequisites.

    End User License Agreement

    Read the agreement and select I accept the terms of the license agreement.

    Configuration

    (ENPS Web Access)

    Click Next Step after completing each screen.

    IIS Settings

    Set each field:

    • ISS Settings - Enter Default Web Site.

    • Virtual Directory - Enter ENPSWebAccess3.

    • Application Pool - Enter ENPSWebAccess3AppPool.

    • JSON Web Services Address - Enter your server name followed by /NOMWebServices3JSON.

      For example, if your JSON Web Services server is located at https://servername.site.com, enter https://servername.site.com/NOMWebServices3JSON.

    • JSON Web Services Backup Address - If the site has a backup JSON address then enter it in this field. Otherwise, enter the same address as the main JSON Web Services Address entered above.

    Configuration

    (ENPS JSON Web Service)

    Click Next Step after completing each screen.

    IIS Settings

    Set each field:

    • ISS Settings - Enter Default Web Site.

    • Virtual Directory - Enter NOMWebservices3JSON.

    • Application Pool - Enter NOMWebServiceAppPool.

    • Central Server Name - Enter the name of your Central Server. If your enterprise uses only a single Primary-Buddy pair, this is the Primary Server.

    • Central Server Backup Name - Name or IP address of another ENPS server in your enterprise. This should be an ENPS server local to the site where ENPS Mobile is being installed.

    Incorrectly setting the Central Server Name and Central Server Backup Name can cause significant issues in the event of the Central Server failing.

    Contact Us if you are not sure that you have entered the correct values in these two fields.

    Confirmation

    Click Continue to begin upgrading the displayed components.

    Installation Progress

    Wait for upgrade to complete.

    Click Install Details.

    Finish

    Click Finish if all products have upgraded successfully.

Post-Upgrade

Application Pools (Advanced)

Ensure the Application Pool advanced settings are correctly configured.

ENPS Web Access Application Pool Advanced Settings

Configure the ENPS Web Access Application Pool's advanced settings:

  1. Open Server Manager.

  2. Select Tools > Internet Information Services (IIS) Manager.

  3. Expand the server name in the Connections pane.

  4. Select Application Pools.

  5. Right-click ENPSWebAccess3AppPool in the Features View on the right, and select Advanced Settings.

    The Advanced Settings popup will appear.

  6. Ensure Process Model > Idle Time-out (minutes) is set to 0.

  7. Click OK.

NOM Web Service Application Pool Advanced Settings

Configure the NOM Web Service Application Pool's advanced settings:

  1. Open Server Manager.

  2. Select Tools > Internet Information Services (IIS) Manager.

  3. Expand the server name in the Connections pane.

  4. Select Application Pools.

  5. Right-click NOMWebServiceAppPool in the Features View on the right, and select Advanced Settings.

    The Advanced Settings popup will appear.

  6. Ensure Process Model > Idle Time-out (minutes) is set to 0.

  7. Click OK.

Web Service Host

Test the Web Service Host:

  1. Open a browser and open the following URL.

    Change the URL to http if you are not using SSL.

    https://<NameOfYourMobileServer>/NomWebServices3JSOn/NomWebService.svc

  2. Check that the following page loads properly:

    If this page does not load, verify that all previous ENPS Mobile upgrade steps have been carried out correctly.

    If you continue to have difficulty, refer to the Troubleshooting steps or Contact Us.

  3. Test the Mobile Gateway by opening a browser and opening the following URL:

    Change the URL to http if you are not using SSL.

    https://<NameOfYourMobileServer>/enpswebaccess3

    If this page does not load, verify that all previous ENPS Mobile upgrade steps have been carried out correctly.

    If you continue to have difficulty, refer to the Troubleshooting steps or Contact Us.

Do not test logging in without first updating the defaultDomain and serviceAddress settings as noted in the next chapter.