org.mbs.services.cup.radmin (Bosch IoT Remote Manager 7.1 System Package API)

Interface Summary
Interface	Description
RemoteControlConstants
RemoteCUAdmin	Remote representation of the `ControlUnitAdmin` service aiming to provide the ability for control units to be remotely managed in the same manner as if they were managed on their local OSGi framework.

Package org.mbs.services.cup.radmin Description

Defines API implemented over the Control Unit Protocol and representing the local framework's model for control units administration. This API could be used by applications that need transparency when managing control units remotely or in local framework. The main interface RemoteCUAdmin is provided in mPRM for management of three conceptually different control unit targets:

system control units
These are control units exported on the backend frameworks and providing backend-system resources as manageable control unit representations. Refer to the bottom of the page to see how to obtain instance of the start point service RemoteCUAdmin.

control units on managed devices
This conception is exported by the Generic Device Management package, which provides the ability for creating instance of the RemoteCUAdmin for management of component control units provided on any particular device managed in mPRM.

control units on remote osgi framework via com.prosyst.mprm.net.message.Connection
The service factory is org.mbs.services.cup.radmin.factory.RemoteCUAdminFactory (currently not provided in mPRM). Can be used by standalone applications to manage control units on any remote osgi framework with enabled messaging.

Instance of the RemoteCUAdmin for management of system control units could be accessed in two ways:

as a service on the backend framework and it is accessible to the other bundles through methods defined by the OSGi Framework specification.

Example :

import org.mbs.services.cup.radmin.RemoteCUAdmin;
import org.osgi.framework.BundleContext;
import org.osgi.framework.ServiceReference;

.....

  public RemoteCUAdmin getRemoteCUAdmin(BundleContext context) {
    RemoteCUAdmin cuAdmin = null;
    ServiceReference cuadminRef = context.getServiceReference(RemoteCUAdmin.class.getName());
    if (cuadminRef != null) {
      cuAdmin = (RemoteCUAdmin)context.getService(cuadminRef);
    }
    return cuAdmin;
  }

.....

as a stand-alone application, not depending on OSGi Framework, by using com.prosyst.mprm.rac.RemoteAccessClient. An external stand-alone application can use this package by including system-rac.jar in its classpath.

Example :

import org.mbs.services.cup.radmin.RemoteCUAdmin;
import com.prosyst.mprm.rac.RemoteAccessClient;
import java.util.Hashtable;

.....

  public BackendControlUnitProxyFactory getRemoteCUAdmin(RemoteAccessClient rac) {
    RemoteCUAdmin cuAdmin = null;
    if (rac != null) {
      cuAdmin = (RemoteCUAdmin)rac.getService(RemoteCUAdmin.class.getName());
    }
    return cuAdmin;
  }

.....

  public static void main(String[] args) {

    //Open session using the system account.
    Hashtable credentials = new Hashtable();
    credentials.put(RemoteAccessClient.USER_PASSWORD, "system");
    RemoteAccessClient rac = RemoteAccessClient.connect("socket://mprm.acme.com:11449", "system", credentials, null);
    ...

    //Now the application can access mPRM BackendControlUnitProxyFactory service
    RemoteCUAdmin cuAdmin = getRemoteCUAdmin(rac);

    ...
    //closing session
    rac.close();
  }

.....