Skip to main content
Version: v2.6

Deployment Notes 2.6.8

Introduction​

Artifacts can be downloaded from the download page.

The following sections outline the deployment actions for this release.

Database Migration​

Important

Please back up all databases before running refactor scripts

Redeploy Portal​

  1. Download the appropriate zip file from the download page depending on your installation
    1. If you are using the Portal including all modules (Item Manager and Planning), download portalwithmodules.zip
    2. Otherwise, download portal.zip and - if relevant - ext-itemmgr.zip or ext-planning.zip
  2. Redeploy the Portal web application.
    1. Preserve and re-establish the appsettings.json file
    2. If you are hosting the Portal in an IIS sub-folder, you should also preserve and re-establish the <base> tag in the wwwroot/index.html file

If you are selectively deploying the Item Manager or Planning modules, you need to copy the contents of the Server and Client folders from the zip file to their respective locations in the Extensions folder under the Portal application folder

Upload new runtime to the Portal​

  1. Download the runtime.zip from the download page
  2. Upload new runtime.zip to the Portal (Configuration → Operations → Runtime → Upload)
  3. Set the new runtime version active

Execution Servers​

Reinstall Hopp Agent Service​

Reinstall the Hopp Agent Service:

note

Make sure you have the application credentials (UserId/Password) ready for the Hopp Service account

  1. Download the Hopp.Director.Agent.msi installer from the download page
  2. Stop the Hopp Agent Service before uninstall
    1. Open the Services Control Panel Add On - search for 'services' in the Windows Start Menu
    2. Locate and stop the Hopp Agent Service
  3. Preserve the MigFx.Agent.dll.config file in the installation folder (normally C:\Program Files\HoppTech\migFx\Agent)
  4. Run the Hopp Agent Service installer
  5. Re-establish the MigFx.Agent.dll.config file
  6. Re-enter the application credentials as logon for the Hopp Agent Service
  7. Start the Hopp Agent Service

Workstations​

Reinstall Visual Studio Extension​

  1. Make sure you have at least Visual Studio 2022 version 17.4 installed
  2. Open Visual Studio and in Extensions → Manage Extensions, mark the installed Hopp Migration extension for un-install
  3. Close Visual Studio. The Microsoft Visual Studio extension installer will launch to uninstall the previous version. Follow the guidance in the installer
  4. Install the Hopp Visual Studio extension (double-click VsExtension.2022.vsix)
  5. Follow the guidance in the installer

Update Engine Generator​

  • If using Nuget

    • Update the Hopp.Generator tool dotnet tool update hopp.tools.enginegenerator --global

  • If using local libraries

    • Reinstall MigFx.EngineGenerator from download page