MindSphere – MindAccess Developer (Release July 2017) Data Sheet
MindAccess Developer provides you with access to a Development System for developing and testing of applications. Depending on the ordered package, MindAccess Developer also enables you to provide the application on a Productive System.
Preconditions
Web-browser A state-of-the art HTML5 capable internet browser is
required (e.g. Mozilla Firefox, Google Chrome or Microsoft Internet Explorer). For security reasons, the browser has to be updated and patched to the latest level. The recommended screen resolution is 1024x768 or more.
Development environment PC with Windows or Linux and development environment, including CF Command Line Interface (CLI) from cloudfoundry.org.
Internet connection Performance of usage of MindSphere depends on the bandwidth of your internet connection.
Cell phone for 2-factor authentication You need a smart phone to run the 2-factor authentication app in order to log in to CF Cockpit.
Further details can be found in the MindAccess Developer Tutorials.
Data import For your data import, onto the MindSphere Platform, it is necessary to install and configure a MindConnect product from Siemens (e.g. MindConnect Nano) or a third party custom agent for connection to MindSphere in accordance with the applicable instructions.
Such MindConnect products and custom agents, including any software, have to be kept up-to-date at all times.
If an earlier version is no longer supported, you have to upgrade to a current approved version.
We reserve the right to disallow the connection of MindConnect products or custom agents with outdated or otherwise potentially unstable or unsecure
components to MindSphere.
Definitions
Backing Service A backing service is any service the app consumes over the network as part of its normal operation. Examples include data stores (such as PostgreSQL),
messaging/queueing systems (such as RabbitMQ), and caching systems (such as Redis).
Cloud Foundry Org (CF Org) A CF Org is an environment to test and operate applications. Developers and users share limits, resources and applications.
Development System
(Productive/commercial use is not permitted)
A CF Org specifically dedicated for development and test purposes.
Productive System
(Productive/commercial use permitted. Not included in all MindSphere Developer packages)
A CF Org specifically dedicated for productive/commercial use.
URL of the Productive System distinctly differs from Development System’s URL.
Developer Individual person that writes code, deploys it to the
Development System in order to test it or (depending on the package) deploys it to the Productive System. The developer may provide access to the resulting
application running on the Productive System to Users.
Asset An “Asset” is a logical representation of a thing which
can be a machine or an automation system with one or multiple automation units (e.g. PLC) or even a factory site. You define an Asset with the “Asset Configuration”
as part of the “IoT Data Modeler” application (see chapter “Asset Configuration”).
Core Component “Core Components” are Applications that are accessible to any MindSphere customer by default (e.g.
FleetManager). They may be priced separately and may come with Specific Terms and Data Sheets.
Additional definitions All other capitalized terms in this document shall have the definition ascribed to such terms herein, or in the MMA or the applicable Order Form.
MindAccess Developer Packages
General Different packages are available that differ in
functionality and capabilities, e.g. number of developers, resources. See also table below.
Use MindAccess Developer S to develop and test applications on the Development System.
Use MindAccess Developer M and L to develop and test applications on the Development System. In addition to that, the packages M and L also allow to deploy applications to the Productive System and provide them for productive/commercial use.
Common functionality of all MindAccess Developer packages
Access to CF Org for developing and testing applications
Access to MindSphere Launchpad with configuration tools for projects and apps (see below)
Inbound data traffic for testing and development and data storage 3 (three) month
Access to and use of standard MindSphere APIs (see below)
Usage of Fleet Manager
Usage of TIBCO Jaspersoft™ ServiceAccess, configuration and use of Developer and Productive System
Account information Account information for your development environment and cockpit will be provided after ordering MindAccess Developer.
Access your systems You can access the Developer and Productive System on the MindSphere Platform via the respective URLs provided by us.
For every User of any Service or Application, an individual login is required. Every User will receive an email with its personalized log-in credentials.
Configuration tools For the configuration of your systems on the MindSphere Launchpad, three tools are available to you by default:
MindSphere IoT Data Modeler
MindSphere Application Manager
Usage Transparency IoT Data Modeler
General For the configuration of your system, the “IoT Data
Modeler” application is available supporting the following functionality:
User Management
Customer Management
Asset ConfigurationMindAccess Developer Overview
MindAccess Developer Packages S M L
Included number of Developers
5 10 20
Cloud Foundry resources (Development System)
(RAM)
8 GB 16 GB 32 GB
Cloud Foundry resources (Productive System) (RAM)
n/a 16 GB 32 GB
BETA -Backing Services included (Docker based)
yes 16 GB 32 GB
Managed Backing Services for Productive System
(subject to separate subscription)
no yes yes
Maximal number of routes
1000 1000 1000
Included number of Users in Productive System
n/a 50 100
User Management (as part of IoT Data Modeler)ration tools
General With the User Management, an Admin can create, edit
and delete access credentials for Users in its own organization.
All defined Users of the Account can see all Assets of this Account.
User Management is the tool to manage Users rights and roles. A User for example can have the role of an
“Admin” as well.
User Groups Admin: The Admin has full rights to configure the
Service and to onboard MindConnect Elements, see chapter “Asset Configuration”).
User: The User can only change basic settings for an Asset, e.g. location and network settings. The User can also onboard MindConnect products. The User can see all Assets of the Account to which it has access.
Customer Management (as part of IoT Data Modeler)
General Customer Management is the tool to manage your End
Customers and the End Customers’ Users. End Customers’ Users can only access and configure the Assets which are assigned to the respective End Customer.
Only you can create a User for Your End Customers.
This User can only change basic settings for an Asset (see chapter “Asset Configuration” and “Rights of User”).
User Groups Role “User” only, no Admin.
Asset Configuration (as part of IoT Data Modeler)
General The Asset Configuration tool can be used to manage
your Assets and to onboard MindConnect Element to the MindSphere Platform. The following configuration settings are available:
General Configuration: Define name, description and location for each Asset.
Data Sources: you have to specify the source of the data that you import to the MindSphere Platform.
Asset Aspects: Aspects of an Asset describes the context of the imported data (e.g. contamination).
Network Settings: Define the network and proxy settings for a MindConnect Element or another authorized client.
Onboarding: The onboarding procedure is described in the respective manual of the MindConnect Element (e.g. MindConnect Nano).
Assign Assets to customers: you can assign Assets to your customers and customers´ Users, if any.
Only Assets which are assigned to an end customer can be accessed by the Users of the respective end customer. If you grant End Customers access to your Account, you have to comply with the applicable Service Provider Terms.
Rights of Admin Create, change, duplicate and delete Assets
Common Information: name, type, description
On-/off-board
Location: address and/or GPRS coordinates
Create, edit, delete data sources – connected via Ethernet
Network setting
Assign Assets to an End Customer
Delete data of an Asset before assigning it to an End Customer
o Create, edit and delete Asset aspects (e.g.
contamination, efficiency, etc.) o Create corresponding variables (e.g.
temperature, speed of rotation)
o Define reading cycle for data acquisition from 1 second up to daily (in predefined time ranges)
o Map variable with data source
o Accept MindSphere Units which will be the base for invoicing (see “Fees and
MindSphere Units” below)
Rights of User Open Asset for editing
On-/offboard
Change location settings of Asset
Change IP and Proxy Settings
Cannot see MindSphere Units
Supported MindConnect products and custom agents Each Asset requires a MindConnect Element or custom agent.
Recommended Quantity Structure 10,000 Assets or less MindSphere App Manager
General The App Manager is necessary for the following tasks
during development and deployment of Applications:
Create and download project templates with common coding frameworks & build tools to write applications
Set route for new applications
Assign applications to sub-accounts and users
Create application tiles on the MindSphere Launchpad
This application is visible on the dashboard when logged in as Developer.
MindSphere Usage Transparency
General MindSphere Usage Transparency is a Core Component.
It gives you information about the use of
API calls
Used Services
Deployed Apps
Number of Users
Numbers of connected Assets (applies to Assets connected via MindConnect FB/LIB)
Usage statistics can be exported or printed.
Standard MindSphere APIs
General The following MindSphere APIs are available for
developing Applications. For a detailed API documentation refer to “Developer Guideline” with information about system, code, deployment, samples etc.
Refer to “App Dev Tutorial” for a step-by-step instruction from developing, testing up to registering MindSphere applications.
BETA - Backing Services (Docker based)
Limitations (Free of Charge BETA version) Backing Services (Docker based) are available as Free of Charge Services in a BETA version. In addition to restrictions applicable to all Free of Charge Services, Backing Services (Docker based) come with the following further restrictions:
Variable performance
No backup
No automatic data migration between major software updates.
No guaranteed memory size.
The use of Backing Services (Docker based) BETA is limited the Development System. Productive/commercial data must not be transferred to the Back Services (Docker based).
General Four different Backing Services (Docker based) BETA
are available.
MongoDB-dev MongoDB is cross-platform document-oriented database
program. Classified as a NoSQL database program, MongoDB uses JSON-like documents with schemas.
Included resources:
128 MB RAM
750 MB disk
PostgreSQL-dev PostgreSQL is an object-relational database
management system (ORDBMS). As a database server, its primary functions are to store data and return that data in response to requests from other software applications.
Included resources:
256 MB RAM
750 MB disk
RabbitMQ-dev RabbitMQ is a message broker software that implements
the Advanced Message Queuing Protocol (AMQP).
Included resources:
256 MB RAM
500 MB disk
Redis-dev Redis is an in-memory data structure store, used as a
database, cache and message broker. It supports data structures such as strings, hashes, lists, sets, sorted sets
Managed Backing Services
General Four different managed Backing Services (fees apply)
are available for development and productive use.
The Fees are set forth in the Order Form.
Redis Redis is an in-memory data structure store, used as a
database, cache and message broker. It supports data structures such as strings, hashes, lists, sets, sorted sets with range queries, bitmaps, hyperloglogs and geospatial indexes with radius queries.
Included resources (Single node)
1 CPU: 2GB RAM, 4GB Storage
Rabbit RabbitMQ is a message broker software that implements
the Advanced Message Queuing Protocol (AMQP).
Included resources (Multi node)
1 master
2 Slaves: each 1 CPU, 1GB RAM, 10GB storage
1 HA Proxy: 1 CPU, 1GB RAM
MongoDB MongoDB is cross-platform document-oriented database
program. Classified as a NoSQL database program, MongoDB uses JSON-like documents with schemas.
Included resource (Multi node)
1 master
2 Slaves: each 2 CPUs, 4GB RAM, 40GB storage
PostgreSQL PostgreSQL, is an object-relational database
management system (ORDBMS). As a database server, its primary functions are to store data and return that data in response to requests from other software applications.
Included resource (Multi node)
1 master
1 slave: each 2 CPUs, 4GB RAM, 200GB storage Further MindAccess Developer Offerings
Further APIs There are additional APIs available to enhance
Applications’ functionalities. For available APIs and Services, please refer to the API references (provided in SIOS), the API’s or Service’s individual Data Sheets and to the Supplemental Terms.
Further APIs include:
Notification Service (see individual Data Sheet)
Weather Service (see individual Data Sheet)
Managed Backing Services for Productive System (upon paid subscription)
See respective data sheets for available Managed Backing Services as Redis, Rabbit MQ, PostgreSQL or MongoDB.
MindAccess Developer Additional Developers The MindAccess Developer packages come with a defined number of included developer accounts.
MindAccess Developer Additional Developers increases the number of developer accounts by 1 (one).
MindAccess Developer Package Upgrade Use MindAccess Developer Package Upgrade to upgrade your purchased Packet (from S to M, from M to L) or increase the compute resources of your L Package by 16GB RAM of the Development and Productive
Limited Usage Policy when using MindSphere Developer
General To ensure that resources, services and bandwidth are
shared fairly, we operate on a Limited Usage Policy.
Average development and productive use of MindSphere Developer does require a certain amount of API calls and inbound / outbound traffic.
To ensure that resources, services and bandwidth are shared fairly among all MindAccess Developer customers and only upon continued massive exceedance of the below mentioned Limited Usage Policy limits, we reserve the right to disallow the use of the service for a reasonable period. Such temporary suspension is subject to (i) your prior notification of a massive usage exceedance by us and (ii) your continued massive exceedance after receipt of such notification. In case of such continued massive exceedance, we may in our sole discretion offer you an increase of usage capacities, which may be subject to additional fees.
General API Calls 2 million API calls / month per Org
Outbound traffic 10GB/20GB/40GB (MindAccess Developer S/M/L)
outbound traffic / month per Org
File transfer & storage in productive system
Transfer: 20GB/40GB / month (Mind Access Developer M / L) File in-/ outbound / month (in total) and max. 100 transfers / day
Storage: 20GB/40GB (in total) (Mind Access Developer M / L)
Events 1000 Events / day
Inbound/outbound traffic into Developer System 1GB / month incl. 3 month storage
Fees and MindSphere Units
Fees The fees applicable for MindAccess Developer consist
of:
”MindAccess Developer Fee” (fixed fee depending on package)
Fees resulting from additional services in the Developer Environment (including MindAccess Developer Additional Developers and MindAccess Developer Package Upgrade)
Fees for platform usage based on productive data ingest & storage
In relation to Applications, additional fees may apply in accordance with the terms and conditions governing the access to such Applications.
The Fees are set forth in the Order Form.
Invoicing The fixed fee for MindAccess Developer is invoiced
monthly in advance and is not refundable.
The fee for additional User and the MindSphere Data Model Fee are invoiced monthly in arrears, based on the calculation of the underlying usage.
Fees resulting from additional services in the Developer Environment
MindAccess Developer Additional Developers The MindAccess Developer packages come with a defined number of included developer accounts.
MindAccess Developer Additional Developers increases the number of developer accounts by 1 (one). The Fees are set forth in the Order Form.
MindAccess Developer Package Upgrade Use MindAccess Developer Package Upgrade to upgrade your purchased Packet (from S to M, from M to L) or increase the compute resources of your L Package by 16GB RAM of the development and Productive System. The Fees are set forth in the Order Form.
Additional fees coming from ordered Managed Backing Services
The Fees are set forth in the Order Form.
Fees coming from the use of the MindSphere Productive System
General Included in MindAccess Developer M and L.
The fees applicable for the Productive System consist of:
MindSphere additional Users Fee
“MindSphere Data Model Fee” (depending on the Asset configuration of the Service); such fee is currently calculated based on MindSphere Units.
In relation to Applications, additional fees may apply in accordance with the terms and conditions governing the access to such Applications.
MindSphere Additional Users Fee When exceeding 50 or 100 Users of the MindAccess Developer M or L package, for every additional User of any type (see chapter “User Management” and
“Customer Management”) that you define and that is not already included in the Service as set out in the
applicable Order Form, 30 MindSphere Units are counted for a full month.
MindSphere Data Model Fee Initial onboarding of Assets in the Productive System will immediately result in costs which will be charged to you.
The fees are calculated based on the data model created with the Asset Configuration tool.
The amount of fees varies depending on different factors, including the amount and type of variables, the reading cycles, and the duration of data storage. To the extent that fees are based on MindSphere Units, the MindSphere Units applicable to the data model that you created are shown in the dialog “Asset Aspects” under
“Asset Configuration”.
MindSphere Units To the extent fees are calculated based on MindSphere Units, the following applies:
MindSphere Units are a measuring tool designed to help you keep track of your usage and the applicable amount of fees.
MindSphere Units are calculated, based on your configurations under your Account. The amount of MindSphere Units depends on the number of Users that you define the configuration of your data model.
MindSphere Units are accumulated over the month of usage, and any change of the configuration is tracked on a per minute basis and reflected in the calculation of MindSphere Units.
Support
Free Online Support Siemens provides support free of charge on the MindSphere web portal (https://www.mindsphere.io), in particular information and downloads from Siemens for the MindSphere Services.
This includes, for example:
The most important and most frequently asked questions from the technical support area (FAQs)
Latest MindSphere Services information
Technical data, CAx data and compatibility information (if available)
Downloadable updates/upgrades, service packs and support tools (mostly free of charge)
Manuals and operating instructions for downloading
Approvals and certificates
Such online support is subject to the terms and conditions of use of the Internet platform and forum:
http://www.siemens.com/corp/en/index/terms_of_use.ht ml
https://support.industry.siemens.com/tf/ww/en/site/forumr ules
MindSphere Helpdesk Siemens is available to the customer for MindSphere Services-related queries (preferably via the Internet in the form of a support request) concerning functions and handling of the MindSphere Services.
Usual local working hours in Germany are Monday through Friday, 8am to 5pm, excluding national and local holidays. Support is provided by phone or e-mail. Unless explicitly stated otherwise, the support will be provided in the form of remote access.
Support is available for our customers for handling requests up to one hour per request and for incident inquiries, free of charge. The access to the helpdesk shall be initiated by creating a support ticket via the following support request link:
https://support.industry.siemens.com/cs/sc/2100/support- request?lc=en-WW
Contact to the experts in Germany is possible via the following telephone number +49 (911) 895-7272. All other service queries should be directed exclusively to the specialist control centers in the respective regions.
The contact data can be found in the Siemens Contact Person Database:
https://www.automation.siemens.com/aspa_app/?HTTP S=REDIR&ci=yes&lang=en®id=WW&comptcid=o
Security Information
Access Credentials Authentication and authorization on User level based on username and password.
Data Transfer SSL/TLS encryption of data in transit from MindSphere
to the browser of the User.
General In order to protect plants, systems, machines and
Delivery Information / Export Control Regulations
AL N
ECC EAR99