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 with 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 Tracker 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
- 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
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