Develop, Deploy, Register and Release an application¶

This documentation provides information on application lifecycle. It provides information on creating an application using Java SDK and Web Components, registering it on Developer Cockpit and handing it over to Operator Cockpit.

Application Development¶

Developing Angular Application with Web Components¶

Web Components are ready-to-use building blocks for use in custom applications. They can easily be integrated into individual development code and customized to accelerate the application development process.

Prerequisites¶

• Nodejs
• Angular CLI installed globally (npm install-g @angular/cli)
• Angular application

Procedure¶

1. Integrate Web Components into the application by adding below script in index.html.

   <script id="mdsp-webcomponents-loader" type="text/javascript" src="https://static.{region}.{mindsphere-domain}/webcomponents/ v1/index.js"></script>
   

   After loading the source, Web Components can be integrated into web application by using the respective selectors.

2. Use the Web Components by adding the element selectors. For example, the Asset View Web Component selector can be used to display assets as a List.

   <mdsp-asset-view></mdsp-asset-view>
   

   
   

   Similarly, there are several Web Components available to integrate Angular UI. For more information refer Components and References.

3. Generate the artifact for the UI application.

Developing Java Backend application with Industrial IoT SDK¶

Prerequisites¶

• Java 8
• Gradle or Maven as a build tool
• Java web application

• Environment variable HOST_ENVIRONMENT is set to current region.

  header env: HOST_ENVIRONMENT: eu1

If not specified, HOST_ENVIRONMENT defaults to eu1.

Service credentials are of two types:

1. Application Credentials
2. Tenant Credentials

For application development, a developer can select between Application Credentials, Tenant Credentials or User Token.

For more information on how to procure the application credentials refer Application Credentials, and to set environment variables refer Environment variables.

For more information on how to procure the tenant credentials refer Tenant Specific Credentials, and to set environment variables refer Environment variables.

<settings>
  <proxies>
      <proxy>
        <id>http_proxy</id>
        <active>true</active>
        <protocol>http</protocol>
        <username>proxyuser</username>
        <password>proxypass</password>
        <host>{yourProxyIP}</host>
        <port>{yourProxyPort}</port>
        <nonProxyHosts>local.net|some.host.com</nonProxyHosts>
      </proxy>
      <proxy>
        <id>https_proxy</id>
        <active>true</active>
        <protocol>https</protocol>
        <username>proxyuser</username>
        <password>proxypass</password>
        <host>{yourProxyIP}</host>
        <port>{yourProxyPort}</port>
        <nonProxyHosts>local.net|some.host.com</nonProxyHosts>
      </proxy>
  </proxies>
</settings>

Adding Industrial IoT SDK as application dependencies¶

1. Download the Industrial IoT SDK for Java from the Siemens Industry Online Support (SIOS) Portal. The jar and pom files of the core module and the service modules have the following structure:

   Core ModuleService Modules

   com\siemens\mindsphere\mindsphere-sdk-java-core\{x.y.z}\mindsphere-sdk-java-core-{x.y.z}.jar
   com\siemens\mindsphere\mindsphere-sdk-java-core\{x.y.z}\mindsphere-sdk-java-core-javadoc.jar
   com\siemens\mindsphere\mindsphere-sdk-java-core\{x.y.z}\mindsphere-sdk-java-core.pom
   

   com\siemens\mindsphere\{service_name}-sdk\{x.y.z}\{service_name}-sdk-{x.y.z}.jar
   com\siemens\mindsphere\{service_name}-sdk\{x.y.z}\{service_name}-sdk-{x.y.z}-javadoc.jar
   com\siemens\mindsphere\{service_name}-sdk\{x.y.z}\{service_name}-sdk-{x.y.z}.pom
   

   Note

   • {x.y.z} is the version number of the Industrial IoT Core SDK for Java (e.g. 2.0.0).The file {service_name}-sdk-{x.y.z}.pom is required for downloading the transitive dependencies of the Industrial IoT Core SDK for Java.
   • {x.y} is the version number of the API Specification (e.g. 3.0). The file {service_name}-sdk-{x.y}.pom is required for downloading the transitive dependencies of the Industrial IoT Service SDK for Java.

2. Create a folder Repo to be marked as local Maven repository and copy the SDK artifacts to it.

   Info

   As SDKs are not available in maven repository, it is required to declare a local folder as maven repository and copy the SDK artifacts to it.

   Core ModuleService Modules

   $PATH\com\siemens\mindsphere\mindsphere-sdk-java-core\{x.y.z}\mindsphere-sdk-java-core-{x.y.z}.jar
   $PATH\com\siemens\mindsphere\mindsphere-sdk-java-core\{x.y.z}\mindsphere-sdk-java-core-javadoc.jar
   $PATH\com\siemens\mindsphere\mindsphere-sdk-java-core\{x.y.z}\mindsphere-sdk-java-core.pom
   

   $PATH\com\siemens\mindsphere\{service_name}-sdk\{x.y.z}\{service_name}-sdk-{x.y.z}.jar
   $PATH\com\siemens\mindsphere\{service_name}-sdk\{x.y.z}\{service_name}-sdk-{x.y.z}-javadoc.jar
   $PATH\com\siemens\mindsphere\{service_name}-sdk\{x.y.z}\{service_name}-sdk-{x.y.z}.pom
   

3. Register the repository and include dependencies in the build config file of your project.

   MavenGradle

   <!-- Modify the following sections of the pom.xml file -->
   <!-- 1. Register the repository in the repositories section -->
   <repositories>
         <repository>
             <id>maven-repository</id>
             <url>file:///{absolute_path_of_the_repository_folder}</url>
         </repository>
     </repositories>
   
   <!-- 2. Add Core dependency in the dependencies section (optional) -->
   <dependency>
       <groupId>com.siemens.mindsphere</groupId>
       <artifactId>mindsphere-sdk-java-core</artifactId>
       <version>{x.y.z}</version>
   </dependency>
   
   <!-- 3. Add Service dependency in the dependencies section -->
   <dependency>
       <groupId>com.siemens.mindsphere</groupId>
       <artifactId>{service_name}-sdk</artifactId>
       <version>{x.y.z}</version>
   </dependency>
   

   // Modify the following sections of the build.gradle file
   // 1. Register the repository in the repositories section
   repositories {
           maven {
             url file('{Absolute_path_of_the_created_repository_folder}')
           }
           mavenLocal()
           mavenCentral()
   }
   
   // 2. Add Core dependency in the dependencies section (optional)
   compile 'com.siemens.mindsphere:mindsphere-sdk-java-core:{x.y.z}'
   
   // 3. Add Service dependency in the dependencies section
   compile 'com.siemens.mindsphere:{service_name}-sdk:{x.y.z}'
   

4. Generate the artifact for the application.

   Code Sample:

   For example, use the ListAssetsRequest model to list the assets.

   // Construct the AssetsClient object 
   AssetsClient assetClient = AssetsClient.builder().build();
   
   ListAssetsRequest requestObject = new ListAssetsRequest();
   requestObject.setPage(<page>);
   requestObject.setSize(<size>);
   
   AssetListResource assets = null;
   try{
       assets = assetClient.listAssets(requestObject);
   } catch (MindsphereException e) {
       // Exception handling
   }
   

Configuring the manifest file¶

Defining random routes and explicit routes¶

You can use the routes attribute in the Manifest to define the route for your application. The preferred way for defining routes is using random routes that are generated automatically from the application name.

For example, below is the manifest file to configure UI application (frontenddemoapplication) and Backend application (backenddemoapplication) :

---
applications:
- name: frontenddemoapplication
  instances: 1
  path: ./DemoApp-UI/dist/
  memory: 1GB
  buildpack: staticfile_buildpack
  disk_quota: 1GB
  random-route: true
- name: backenddemoapplication
  instances: 1
  memory: 1GB
  path: ./DemoApp/demo-app-1.0.0-SNAPSHOT.jar
  buildpack: java_buildpack
  disk_quota: 1GB
  random-route: true

# To use Application Specific Service Credentials, uncomment below variables and add corresponding values
#MDSP_KEY_STORE_CLIENT_ID=
#MDSP_KEY_STORE_CLIENT_SECRET=
#MDSP_OS_VM_APP_NAME=
#MDSP_OS_VM_APP_VERSION=
#MDSP_HOST_TENANT=
#MDSP_USER_TENANT=

# To use Tenant Specific Service Credentials, uncomment below variables and add corresponding values
#MINDSPHERE_CLIENT_ID=
#MINDSPHERE_CLIENT_SECRET=
#MINDSPHERE_TENANT=

The generated routes are used to configure the components in Developer Cockpit.

Directory Structure¶

It is recommended to use a directory structure in which each application resides in a sub-directory. You can use the path attribute to point to the correct directory for each application. The example route configuration is shown below:

├───DemoApp
│   └── build
│      └── libs
│            └── demo-app-1.0.0-SNAPSHOT.jar
├───DemoApp-UI
│   └── dist
└───manifest.yml

Registering an application¶

Follow these steps to register the application in Developer Cockpit:

1. Open "Developer Cockpit" from Launchpad and select the "Dashboard" tab.
2. Click "Create new application".
3. Select "Type" as Standard and "Infrastructure" as Self Hosted.

4. Enter an arbitrary "Display Name" and an "Internal Name" which will be part of the application URL. The "Internal Name" cannot be changed after initial creation.

   

5. Set the content-security-policy according to the examples:

   Europe 1China 1

   default-src 'self' *.eu1.mindsphere.io; style-src * 'unsafe-inline'; script-src 'self' 'unsafe-inline' *.eu1.mindsphere.io; img-src * data:;
   

   default-src 'self' static.cn1.mindsphere-in.cn *.amap.com *.is.autonavi.com; style-src * 'unsafe-inline'; script-src 'self' 'unsafe-inline' 'unsafe-eval' static.cn1.mindsphere-in.cn *.amap.com *.is.autonavi.com; worker-src blob:; img-src * data:;
   

6. Enter the version number and upload an icon for the application.

7. Enter the component name and URL for frontend component and backend component.

   Note

   While registering endpoints for components, it is ideal to configure specific path for Backend component and generic path for UI component.

8. Enter the endpoints for frontend and backend components.

   
   

9. Click "Save".

10. Configure the application roles and scopes. For more information on assigning roles and scopes to the application, refer to Configure the Application Roles and Scopes.

11. The application is in the "In-Development" state and is ready for registration in Industrial IoT Gateway. For more information on registering the application, refer to Register the Application.
    

12. Assign the Application Roles to users. For more information, refer to Assign the Application Roles.

The application is now available in the user's Launchpad.

Prepare the Application for Release¶

Prerequisites¶

• The application fulfills the requirements to publish.
• You have the role mdsp:core:DeveloperAdmin.

Handover the Application to the Operator environment (Tenant)¶

1. Open the details view of the application on the "Dashboard" of Developer Cockpit.
2. Click "Approve Upload".
3. Enter the e-mail address of the substitute.
4. Read and accept the IMPORTANT NOTICE information.
5. Click "Approve".

The status of the application changes to "UPLOAD-IN-PROGRESS" and it has been successfully submitted to the application repository. You will be notified once the application is ready for assignment. It may take upto 24hours.

Assign the Operator¶

1. Open the detail view of the application in the "Promoted Apps" of Developer Cockpit.
2. Enter the operator details.
3. Click "Add Assignment".
4. Wait for the operator to accept the plugin.
5. Click "Grant". The operator can now deploy and publish the application.

Except where otherwise noted, content on this site is licensed under the Development License Agreement.