Setting up a Workstation

It is quite simple to set up the Workstation of a Hopp developer.

On the Workstation, the Hopp Developer needs Microsoft Visual Studio and the Hopp Studio application. Though not strictly required by Hopp, for all intents and purposes the developer will also need Microsoft Sql Server Management Studio to be able to inspect and analyse the data provided by Hopp in the Staging Databases.

In addition, the developer needs both the Engine Generator tool on order to be able to generate the Source- and Target Engines from the mapping produced in Hopp Studio and also the Hopp base libraries referenced by the generated engines.

These assets are made available by Hopp in the NuGet gallery, and it is recommended to get them from there.

In some cases, due to the sensitivity of the data being migrated, Hopp is installed on servers and work stations in a closely ring-fenced environment where external internet access - and thus NuGet - is not available. 

In such environments, Hopp provides the Generator tool and the libraries as stand-alone installers that can be installed manually. 

Another (more advanced) option is to download and place the NuGet assets on an internal file share and add the file-share as a NuGet source on workstations. 

Visual Studio

• Minimum Visual Studio 2022 any edition, Community Edition is sufficient
  
  
• At least include the .NET desktop development workload
  1. After install of Visual Studio, install the MigFx Visual Studio extension VsExtension.2022.vsix
     
     
• Git or other source control infrastructure
  
  

Sql Server Management Studio

Install Hopp Components

• Run the MigFx.Studio.exe setup bootstrapper
  1. The bootstrapper will install any missing prerequisites (SAP Crystal Reports and Sql Server LocalDb) and migFx Studio
     
     
• If in a ring-fenced environment, where access to NuGet is not available
  • Run the MigFx.Libraries.msi installer
  • Run the MigFx.EngineFramework.msi installer
    
    
• If access to NuGet is available
  • (the engine projects will reference the libraries directly from NuGet, no installation necessary)
  • Install the Hopp generator tool from NuGet with this command from an elevated command prompt (or PowerShell)

    dotnet tool install --global Hopp.Tools.EngineGenerator