Operating Topologies

Introduction

When a topology is declared as dynamic, several operating tasks can be done to modify the topology:

  • move a running container from a domain to another domain,
  • detach a running container from its current domain.

When a topology is declared as static, the topology can't be modified, but can be deleted from the registry cluster for administrative reasons.

Contributors
No contributors found for: authors on selected page(s)

Dynamic Topologies

Moving a container

Both a container of an autonomous topology and a container member of a more complex topology can be attached to another existing topology (aka domain).

Full Size
A Gliffy Diagram named: Moving a container standalone

The attachment is realized through the JMX API (or Petals CLI) of the container to move using the method 'attachContainerTo' of the MBean 'Topology' with the following parameters:

  • a container member of the target domain,
  • the topology pass-phrase of this remote container.

During the attachment process, the container attached is reconfigured to use the registry of the target domain. After the attachment, the endpoints of the container moved are available in the target topology, and not in the initial topology anymore.

Detaching a container

Any container member of a dynamic domain can be hot-detached at any moment. After detachment, the container is running in a dedicated standalone topology, i.e., in a dedicated domain.

Full Size
A Gliffy Diagram named: Detaching a container

The detachment is realized through the JMX API (or Petals CLI) of the container to detach using the method 'detachContainer' of the MBean 'Topology'.
After the detachment, the endpoints of the container are not available in the initial topology anymore and are moved to the new one.

Empty Topologies

When all container of a dynamic domain are detached from it, then the topology is empty.
In that case, the empty topology is automatically removed from the registry cluster.

Static Topologies

By definition, static topologies can't be modified once registered in a registry cluster the first time.

But for administrative reasons, it can be desired to clean a topology by deleting it from the registry cluster.
This can be done using the command 'delete-topology' of [Petals Registry CLI]).

Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.