akka.remote.testconductor

Conductor

trait Conductor extends AnyRef

The conductor is the one orchestrating the test: it governs the akka.remote.testconductor.Controller’s port to which all akka.remote.testconductor.Players connect, it issues commands to their akka.remote.testconductor.NetworkFailureInjector and provides support for barriers using the akka.remote.testconductor.BarrierCoordinator. All of this is bundled inside the akka.remote.testconductor.TestConductorExt extension.

Self Type
TestConductorExt
Linear Supertypes
AnyRef, Any
Known Subclasses
Type Hierarchy Learn more about scaladoc diagrams
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. Conductor
  2. AnyRef
  3. Any
Implicitly
  1. by any2stringadd
  2. by any2stringfmt
  3. by any2ArrowAssoc
  4. by any2Ensuring
  1. Hide All
  2. Show all
Learn more about member selection
Visibility
  1. Public
  2. All

Value Members

  1. final def !=(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  2. final def !=(arg0: Any): Boolean

    Definition Classes
    Any
  3. final def ##(): Int

    Definition Classes
    AnyRef → Any
  4. def +(other: String): String

    Implicit information
    This member is added by an implicit conversion from Conductor to StringAdd performed by method any2stringadd in scala.Predef.
    Definition Classes
    StringAdd
  5. def ->[B](y: B): (Conductor, B)

    Implicit information
    This member is added by an implicit conversion from Conductor to ArrowAssoc[Conductor] performed by method any2ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc
    Annotations
    @inline()
  6. final def ==(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  7. final def ==(arg0: Any): Boolean

    Definition Classes
    Any
  8. def abort(node: RoleName, target: RoleName): Future[Done]

    Tell the remote support to TCP_RESET the connection to the given remote peer.

    Tell the remote support to TCP_RESET the connection to the given remote peer. It works regardless of whether the recipient was initiator or responder.

    node

    is the symbolic name of the node which is to be affected

    target

    is the symbolic name of the other node to which connectivity shall be impeded

  9. final def asInstanceOf[T0]: T0

    Definition Classes
    Any
  10. def blackhole(node: RoleName, target: RoleName, direction: Direction): Future[Done]

    Switch the Netty pipeline of the remote support into blackhole mode for sending and/or receiving: it will just drop all messages right before submitting them to the Socket or right after receiving them from the Socket.

    Switch the Netty pipeline of the remote support into blackhole mode for sending and/or receiving: it will just drop all messages right before submitting them to the Socket or right after receiving them from the Socket.

    Note

    To use this feature you must activate the failure injector and throttler transport adapters by specifying testTransport(on = true) in your MultiNodeConfig.

    node

    is the symbolic name of the node which is to be affected

    target

    is the symbolic name of the other node to which connectivity shall be impeded

    direction

    can be either Direction.Send, Direction.Receive or Direction.Both

  11. def clone(): AnyRef

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  12. def disconnect(node: RoleName, target: RoleName): Future[Done]

    Tell the remote support to shutdown the connection to the given remote peer.

    Tell the remote support to shutdown the connection to the given remote peer. It works regardless of whether the recipient was initiator or responder.

    node

    is the symbolic name of the node which is to be affected

    target

    is the symbolic name of the other node to which connectivity shall be impeded

  13. def ensuring(cond: (Conductor) ⇒ Boolean, msg: ⇒ Any): Conductor

    Implicit information
    This member is added by an implicit conversion from Conductor to Ensuring[Conductor] performed by method any2Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  14. def ensuring(cond: (Conductor) ⇒ Boolean): Conductor

    Implicit information
    This member is added by an implicit conversion from Conductor to Ensuring[Conductor] performed by method any2Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  15. def ensuring(cond: Boolean, msg: ⇒ Any): Conductor

    Implicit information
    This member is added by an implicit conversion from Conductor to Ensuring[Conductor] performed by method any2Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  16. def ensuring(cond: Boolean): Conductor

    Implicit information
    This member is added by an implicit conversion from Conductor to Ensuring[Conductor] performed by method any2Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  17. final def eq(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  18. def equals(arg0: Any): Boolean

    Definition Classes
    AnyRef → Any
  19. def exit(node: RoleName, exitValue: Int): Future[Done]

    Tell the remote node to shut itself down using System.

    Tell the remote node to shut itself down using System.exit with the given exitValue. The node will also be removed, so that the remaining nodes may still pass subsequent barriers.

    node

    is the symbolic name of the node which is to be affected

    exitValue

    is the return code which shall be given to System.exit

  20. def finalize(): Unit

    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  21. def formatted(fmtstr: String): String

    Implicit information
    This member is added by an implicit conversion from Conductor to StringFormat performed by method any2stringfmt in scala.Predef.
    Definition Classes
    StringFormat
    Annotations
    @inline()
  22. final def getClass(): Class[_]

    Definition Classes
    AnyRef → Any
  23. def getNodes: Future[Iterable[RoleName]]

    Obtain the list of remote host names currently registered.

  24. def hashCode(): Int

    Definition Classes
    AnyRef → Any
  25. final def isInstanceOf[T0]: Boolean

    Definition Classes
    Any
  26. final def ne(arg0: AnyRef): Boolean

    Definition Classes
    AnyRef
  27. final def notify(): Unit

    Definition Classes
    AnyRef
  28. final def notifyAll(): Unit

    Definition Classes
    AnyRef
  29. def passThrough(node: RoleName, target: RoleName, direction: Direction): Future[Done]

    Switch the Netty pipeline of the remote support into pass through mode for sending and/or receiving.

    Switch the Netty pipeline of the remote support into pass through mode for sending and/or receiving.

    Note

    To use this feature you must activate the failure injector and throttler transport adapters by specifying testTransport(on = true) in your MultiNodeConfig.

    node

    is the symbolic name of the node which is to be affected

    target

    is the symbolic name of the other node to which connectivity shall be impeded

    direction

    can be either Direction.Send, Direction.Receive or Direction.Both

  30. def removeNode(node: RoleName): Future[Done]

    Remove a remote host from the list, so that the remaining nodes may still pass subsequent barriers.

    Remove a remote host from the list, so that the remaining nodes may still pass subsequent barriers. This must be done before the client connection breaks down in order to affect an “orderly” removal (i.e. without failing present and future barriers).

    node

    is the symbolic name of the node which is to be removed

  31. def shutdown(node: RoleName): Future[Done]

    Tell the actor system at the remote node to shut itself down.

    Tell the actor system at the remote node to shut itself down. The node will also be removed, so that the remaining nodes may still pass subsequent barriers.

    node

    is the symbolic name of the node which is to be affected

  32. def sockAddr: Future[InetSocketAddress]

    Obtain the port to which the controller’s socket is actually bound.

    Obtain the port to which the controller’s socket is actually bound. This will deviate from the configuration in akka.testconductor.port in case that was given as zero.

  33. def startController(participants: Int, name: RoleName, controllerPort: InetSocketAddress): Future[InetSocketAddress]

    Start the akka.remote.testconductor.Controller, which in turn will bind to a TCP port as specified in the akka.testconductor.port config property, where 0 denotes automatic allocation.

    Start the akka.remote.testconductor.Controller, which in turn will bind to a TCP port as specified in the akka.testconductor.port config property, where 0 denotes automatic allocation. Since the latter is actually preferred, a Future[Int] is returned which will be completed with the port number actually chosen, so that this can then be communicated to the players for their proper start-up.

    This method also invokes akka.remote.testconductor.Player.startClient, since it is expected that the conductor participates in barriers for overall coordination. The returned Future will only be completed once the client’s start-up finishes, which in fact waits for all other players to connect.

    participants

    gives the number of participants which shall connect before any of their startClient() operations complete.

  34. final def synchronized[T0](arg0: ⇒ T0): T0

    Definition Classes
    AnyRef
  35. def throttle(node: RoleName, target: RoleName, direction: Direction, rateMBit: Double): Future[Done]

    Make the remoting pipeline on the node throttle data sent to or received from the given remote peer.

    Make the remoting pipeline on the node throttle data sent to or received from the given remote peer. Throttling works by delaying packet submission within the netty pipeline until the packet would have been completely sent according to the given rate, the previous packet completion and the current packet length. In case of large packets they are split up if the calculated send pause would exceed akka.testconductor.packet-split-threshold (roughly). All of this uses the system’s scheduler, which is not terribly precise and will execute tasks later than they are schedule (even on average), but that is countered by using the actual execution time for determining how much to send, leading to the correct output rate, but with increased latency.

    Note

    To use this feature you must activate the failure injector and throttler transport adapters by specifying testTransport(on = true) in your MultiNodeConfig.

    node

    is the symbolic name of the node which is to be affected

    target

    is the symbolic name of the other node to which connectivity shall be throttled

    direction

    can be either Direction.Send, Direction.Receive or Direction.Both

    rateMBit

    is the maximum data rate in MBit

  36. def toString(): String

    Definition Classes
    AnyRef → Any
  37. final def wait(): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  38. final def wait(arg0: Long, arg1: Int): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  39. final def wait(arg0: Long): Unit

    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  40. def [B](y: B): (Conductor, B)

    Implicit information
    This member is added by an implicit conversion from Conductor to ArrowAssoc[Conductor] performed by method any2ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc

Shadowed Implicit Value Members

  1. val self: Any

    Implicit information
    This member is added by an implicit conversion from Conductor to StringAdd performed by method any2stringadd in scala.Predef.
    Shadowing
    This implicitly inherited member is ambiguous. One or more implicitly inherited members have similar signatures, so calling this member may produce an ambiguous implicit conversion compiler error.
    To access this member you can use a type ascription:
    (conductor: StringAdd).self
    Definition Classes
    StringAdd
  2. val self: Any

    Implicit information
    This member is added by an implicit conversion from Conductor to StringFormat performed by method any2stringfmt in scala.Predef.
    Shadowing
    This implicitly inherited member is ambiguous. One or more implicitly inherited members have similar signatures, so calling this member may produce an ambiguous implicit conversion compiler error.
    To access this member you can use a type ascription:
    (conductor: StringFormat).self
    Definition Classes
    StringFormat

Deprecated Value Members

  1. def x: Conductor

    Implicit information
    This member is added by an implicit conversion from Conductor to ArrowAssoc[Conductor] performed by method any2ArrowAssoc in scala.Predef.
    Shadowing
    This implicitly inherited member is ambiguous. One or more implicitly inherited members have similar signatures, so calling this member may produce an ambiguous implicit conversion compiler error.
    To access this member you can use a type ascription:
    (conductor: ArrowAssoc[Conductor]).x
    Definition Classes
    ArrowAssoc
    Annotations
    @deprecated
    Deprecated

    (Since version 2.10.0) Use leftOfArrow instead

  2. def x: Conductor

    Implicit information
    This member is added by an implicit conversion from Conductor to Ensuring[Conductor] performed by method any2Ensuring in scala.Predef.
    Shadowing
    This implicitly inherited member is ambiguous. One or more implicitly inherited members have similar signatures, so calling this member may produce an ambiguous implicit conversion compiler error.
    To access this member you can use a type ascription:
    (conductor: Ensuring[Conductor]).x
    Definition Classes
    Ensuring
    Annotations
    @deprecated
    Deprecated

    (Since version 2.10.0) Use resultOfEnsuring instead

Inherited from AnyRef

Inherited from Any

Inherited by implicit conversion any2stringadd from Conductor to StringAdd

Inherited by implicit conversion any2stringfmt from Conductor to StringFormat

Inherited by implicit conversion any2ArrowAssoc from Conductor to ArrowAssoc[Conductor]

Inherited by implicit conversion any2Ensuring from Conductor to Ensuring[Conductor]

Ungrouped