When opting to switch from using Enterprise Studio Online to an Enterprise Studio on-premise client, you should address or consider the following items to avoid usage experience pitfalls. When switching, you keep using the same Team Server.
To avoid encountering model package and project conflicts and random hangs when opening them on the target client, it is important to suspend contributing to all Team Server model packages and projects on the current client being used.
Before suspending contributing, ensure that you have saved all uncommitted work by committing it before suspending. If you are not ready to commit your work yet, you can alternatively choose to save the model package or project as an XMAM file. After you have moved to Enterprise Studio on-premise, you can open the model package or project again from the Team Server and open the XMAM file, and then copy you uncommitted work from the XMAM to the Team Server model package or project. After that, you continue working on the model package or project.
- In Enterprise Studio, go to File > Open, and then click the Team Server where the model packages and projects are located.
- Click OK.
Perform the above steps for each model package and project in the list until they all have been suspended.
Securing other model packages and work files
If you have created XMAM files before suspending your model packages and projects and/or if you have other work files stored in your Home folder or Temporary Files folder like reports and import/export files, secure them by downloading them from your hosted environment and store them somewhere local. You may need these files when you continue working on-premise.
If you have model packages stored in you personal storage, they will not be automatically migrated. There are two ways of securing them. Please take note that these model packages will lose their history, regardless of the solution you choose.
- Open the model packages one by one and save them as XMAM files. Store them in the Home folder or Temporary Files folder.
- Download the model packages from your hosted environment and store them somewhere local in your on-premise environment. How?
- Start your on-premise Enterprise Studio, open the model packages one by one, and save them into your personal storage.
- Save the model packages from your personal storage one by one to the Team Server.
- Start your on-premise Enterprise Studio, open the model packages from the Team Server, and store them into your personal storage.
There is no additional license seat required when switching between Enterprise Studio Online and Enterprise Studio on-premise client if you already have Designer seats. A seat can be used with an on-premise installation of Enterprise Studio as well as the cloud solution, regardless of the Team Server installation (on-premise or hosted).
When switching from Enterprise Studio Online to Enterprise Studio on-premise client, you need to retrieve the license to activate the Enterprise Studio on-premise installation from your hosted Team Server. This is a one-time operation when starting Enterprise Studio on-premise for the first time. To do this, follow these steps:
- Start the Enterprise Studio on-premise client. The following message appears:
- Click OK, go to File > Open, and click Add storage place.
- In the Add Storage Place wizard, in Server, specify the URL of your Team Server (which has the form:
- Click Next, and then Finish.
- A pop-up window of the Activity Console appears, in which you need to authenticate. Proceed to authenticate the way you normally do when accessing your hosted environment to launch Enterprise Studio Online. Example:
This includes authentication via single sign-on. Single sign-on (SSO) with your hosted environment is possible when installing Enterprise Studio on-premise because the HTTP client in the Activity Console supports SSO authentication. After authenticating, Enterprise Studio on-premise will retrieve the license from the Team Server accordingly.
- If authentication is successful, the pop-up window will automatically close. Click Finish to complete.
Your on-premise installation of Enterprise Studio is now licensed.