xUML services normally are deployed via the Builder for MagicDraw. In the component diagram of a UML model in MagicDraw™, you define the control port number and the Bridge node instance, to which the composite of the service will be deployed. Then, you can compile and deploy the service to the defined node instance with the E2E xUML Model Compiler.
You can also directly deploy the repository of a compiled composite to a node instance via the Bridge.
Notetip |
---|
|
How to manage service repositories for different environments like Development, Test, or Production is explained in detail in Configuration Management. |
The control port is defined in the component diagram and is used for the communication between the console and the server component. If a compiled composite is deployed to a server, the Bridge will check whether the xUML service is already existing on the Bridge. If you have chosen the option to overwrite the xUML service, and existing (old) xUML service will be overwritten. If the control port has changed, the new control port will be used. The old control port will be released.
If you have not chosen to overwrite the composite, the Bridge will report an error, because composite names of a node instance must be unique.
Noteinfo |
---|
|
It is possible to deploy two different xUML services with the same control port. However, if the control port is already used by one composite, the other composite cannot be started unless the first composite is stopped. |
...
Locate and select the REP file by clicking Browse….
Notetip |
---|
|
The REP file is located in the repository directory as defined in the Builder project settings. Start the Builder, open the Builder project settings, and switch to the tab General to look up this directory. |
Click Upload ... to proceed with uploading the repository and setting the deployment options.
Image Modified | Image Modified |
Two tables show an overview on the details of the service to be deployed:
Name | Description |
---|
xUML Repository | File name of the service repository. |
Service Name | Name of the service component. |
Service Version | Service version as specified on the service component (see Frontend Components). |
Compiler Version | Version of the compiler the service has been compiled with. |
Build Time | Build time of the service repository. |
If the service has been deployed to this node instance before, you can compare the details of the new and the existing service here.
...
After you have set all options, deploy the composite by clicking Deploy. If the service already exists, the button will read Overwrite.
If you have deployed a new xUML service, it will be displayed in the navigation, below the node instance, to which it has been deployed.
...
The target node instance, to which the xUML service will be deployed, is specified in the component diagram of the UML model in the Builder and is stored in the deployment descriptor of the repository files.
Info |
---|
|
Additionally, a backup copy of the deployed service will be made to <your Bridge data directory>/backup . This backup includes the service settings as present on the Bridge after deployment - depending on what you specified for option Deploy Settings and Preferences from Repository. |
Deployment of xUML Services on Bridge 6
Versiondiv |
---|
|
| Bridge 6 |
| Click here to read the documentation of service deployment on Bridges before Bridge 7... | If a composite has already been compiled in the Builder, you can select and deploy the generated REP file that contains the repository files and the WSDL file. Select the navigation item Deployment in the Domain section of the navigation on the left to deploy a new xUML service or overwrite an existing one. Image Modified Locate and select the REP file by clicking Browse…. The REP file is located in the repository directory as defined in the Builder project settings. Start the Builder, open the Builder project settings, and switch to the tab General to look up this directory. Click Select ... to proceed with uploading the repository and set the deployment options. > Image Modified |
Option | Description |
---|
Overwrite Service | If the xUML service you want to deploy already exists, check this option, if you want to overwrite it. | Overwrite Settings and Preferences | Check this option, if you want to overwrite the local settings and preferences of an existing xUML service on deployment. If you are overwriting an existing xUML service, settings and preferences will be added from the repository – all locally changed settings will get overwritten. This can be either default settings defined in the xUML service model, or settings coming from an xUML service export (see xUML Service Details). | |
| Overwrite = No | Overwrite = Yes |
---|
|
| |
---|
| Builder Repository | Exported Repository | Builder Repository | Exported Repository |
---|
Settings | | no change of locally changed settings | all settings (including locally changed) will get overwritten with the default settings coming from the model | all settings (including locally changed) will get overwritten with the settings coming from the exported repository | Preferences | no change | no change | no change | exported preferences applied |
| Startup Service | To run, the xUML service has to be started. Select this option, if you want the xUML service to be started automatically right after its deployment. |
After you have set all options, deploy the composite by clicking Upload. If you have deployed a new xUML service, it will be displayed in the navigation, below the node instance, to which it has been deployed. The target node instance, to which the xUML service will be deployed, is specified in the component diagram of the UML model in the Builder and is stored in the deployment descriptor of the repository files. |
|