In order to work on the training exercises you will need a training slot on the virtual server we provide in the Azure cloud. The training slot setup is simply a way to provide you an updated and efficient training environment to learn about migFx.
To get a training slot you must first contact us on firstname.lastname@example.org. We will then provide you with the necessary credentials (username and password) for you to connect to your training slot via remote desktop.
Once connected, you have the entire migFx at your disposal in an your own, isolated sandbox. migFx comes with a default setup, but you must do some customization before starting the exercises.
Connect to your slot on the server
On your own Windows machine, you can start the Remote Desktop Client by searching for Remote Desktop Connection in the Windows Start menu. Use the address, username and password provided by hopp to connect to remote server.
For the rest of this section, and indeed for the entire remaining exercises, we assume that you are connected to your slot on our server.
From time to time, we at hopp will need to update migFx in the training environment. It is a great help to us if you sign off your Remote Desktop session, when you are not working on the exercises (as opposed to just disconnecting the session by closing the Remote Desktop window on your computer).
You sign off from the Windows Start Menu as shown below:
If we need to upgrade your training environment, we will always check if your are online before doing so. If you are online, we will contact you to coordinate. On the other hand, if your session is disconnected, we will simply close it and carry on. In order not to lose any work, please sign out as described instead of just disconnecting - or at the very least make sure your work is saved.
Prepare Studio Workshop projects
- Find and open the Studio application
Setup Workshop Source map
- Open the Workshop Source map from local folder
- Click the Open Project buttonin the Toolbar
- Navigate to folder Documents > MigFx > Mapping > Workshop > Source
- Locate and select the fileand click the Open button to open the project
- Add the Source Map to repository control
- Click the Add project to repositorybutton in the Toolbar and click the Ok button to add all your local files to the repository
Setup Workshop Target map
- Load Workshop Target map from local folder
- Click the Open Project buttonin the Toolbar:
- Navigate to folder Documents > MigFx > Mapping > Workshop > Target
- Locate and select the fileand click Open to open the project
- Add project to repository control
- Click the Add project to repository buttonin the Toolbar and click the Ok button to add all your local files to the repository
Your training environment includes 2 more sets (Source + Target map) of projects you might want to setup but this is not really required to complete the training exercises: WorkshopDemo source and target, and Sandbox source and target.
- WorkshopDemo is a suggested solution to the training exercises
- Sandbox is 'empty', setup for you to use if you want to try things out on a project of your own
- To setup these, repeat the above sections replacing Workshop with WorkshopDemo and Sandbox as needed
Check Visual Studio
Verify that Visual Studio is setup and ready.
In our training setup, Visual Studio should remain signed in to our MigFx Trainee account. We aim to refresh these credentials regularly, but Visual Studio may prompt you to reenter the credentials with a yellow warning triangle, like so:
Please refrain from doing so. Instead, please contact us on email@example.com and we will refresh the credentials for you.
- Find and open Visual Studio 2019 (please ensure that you are in fact starting Visual Studio 2019 (and not other versions of Visual Studio that may also be installed on the server))
- Open Workshop solution
- Click File > Open > Project/Solution
- Go to folder Documents > MigFx > VisualStudio > Workshop (full path: D:\MigFx\Training\Trainee\XX\MigFx\VisualStudio\Workshop, where XX is the trainee number)
- Locate an select Workshop.sln and click Open
- Solution Explorer should contain these projects:
If you check Help/About, you will notice you are using Visual Studio Community Edition. This is the free version of Visual Studio and it is perfectly sufficient for the needs of migFx.
Check that Director is available and the Service is running
The Director is available in the Windows notification area in the right-hand lower corner of your screen.
- Click on the Director iconto open the Director context menu
- Open Workshop -> Training (MigFx – Track 1)
You will get to the Director in later exercise. For now just verify that the Service is running (green dot vs red dot)
- The Service is started (green dot) for you when you sign on to the server. If the Service is not running, try to sign off and on again. If it is still not running, please contact Support
- The Track is most probably not running (red dot). Don't worry either way - that's something for later exercises
Verify that the Portal is available
- Locate and open Google Chrome
- We have set up Chrome with the Portal as your homepage, so it should show up automatically when you launch it. If not, you can navigate to this url: https://localhost:430XX, where XX is your Trainee number - 2 digits (for instance https://localhost:43001 for trainee 01)
- The Portal will most probably ask you to sign in (unless Remember me was checked not long ago)
- User: TraineeXX (for instance Trainee01)
- Password: 'password' without the quotes (note that this is a different password from your remote desktop login)
- You are welcome to let Chrome save your password (if this has not already been done)
- Once signed in the Portal shows up in all its glory
- If the Portal is not available, please contact Support
- That is it for now. The will be lots more on the Portal in later exercises
Necessary processes for user isolation
In a real setup, the necessary migFx services a hosted either as a Windows Services or by a Web Server (Internet Information Server).
But your Trainee slot is in fact a user session running on a server that your share with other trainee slots.
To ensure that the trainee slots remain isolated even though they run on the same server, each slot must run its own instance of the necessary migFx services.
This is why you in your Windows task bar will see 3 Windows Command Prompts running:
Please do not close any of these, it will cause either the Director Client or Runtime or the migFx Portal to stop working in your session (Studio will not be affected).
IISEpress - Director:
Runs an instance of IISExpress that hosts the SOAP Web Services called by the Director Client. Stopping this one causes the Director Client to stop working.
Runs an isolated instance of the Director Windows Service that detects Track start requests. If you stop this one, you will not be able to start Tracks in Director.
MigFx - Portal:
Runs a Kestrel Web Server instance that hosts the MigFx Portal. If you stop this one, the Portal will not work.
If you accidentally close one of the command prompts, the best remedy is simply to sign out from your Remote Desktop session and then sign in a again. The 3 command prompts are started when you sign in.
Congratulations! Now you have completed the initial setup of your migFx training slot
- You have added your mapping projects on your local disk to the repository
- You have verified your Visual Studio installation and located the Workshop Engine solution
- You have verified that you have access to the Director and the Workshop track and that the Director Service is up and running
- Finally you have verified that you have access to the Portal