The BlackBerry® Administration API manages some BlackBerry® Enterprise Server components using objects called host services and core services. Each host service instance is a container for one or more core service instances.
You can use host services and core services to manage the BlackBerry Enterprise Server components that support high availability. You configure a component for high availability to allow manual or automatic failover to a standby instance if the primary instance becomes unavailable.
A component that is configured for high availability has one host service instance and two or more core service instances. A component that can support high availability, but is not configured to support high availability in your organization's environment, has one host service instance and one core service instance. A component that cannot support high availability has one service instance.
You can assign the properties of a component to either the host service instance or the core service instances contained within the host service instance. Properties that apply to all instances of a component are assigned to the host service instance. Properties that might be different for each component instance are assigned individually to the corresponding core service instances. For example, for a pair of high availability components, one core service instance is assigned as the primary instance and one is assigned as the standby instance.
To find all of the services that exist on your BlackBerry Enterprise Server, you can use the findServices() method in the core web service. To find all the service instances, including host service instances and core services instances, associated with a service on your BlackBerry Enterprise Server, you can use the findServiceInstancesByService() method. Service instances in the BlackBerry Administration API do not correspond to the Windows® services on the computer that hosts the BlackBerry Enterprise Server.