Adding the Network Actor Configuration to Director

There are several ways you can add the Actor configurations to the Director:

Adding a Network Actor Configuration using the Director

  1. Select Environment > Actors.
  2. Click Add Network Actors and fill out the new Actor form.

    Information about several of the fields is provided below.

    1. Name: Label for the Actor.

      Best practice is to include the security zone as part of the name, which makes it easier when assigning Actors to Jobs.

    2. Description: Free text description for the Actor.
    3. User Tags: Select existing user-created tags or add new ones to label this Actor.

      User tags are used for running bulk Actions. See Running Bulk Actions for more information.
    4. Security Zone: The area of your network where the Actor will live.

      Security zones are added to the Director after the Director is installed (see Adding Security Zones in your Director Install guide if there are no security zones listed).

    5. Comm Mode: The communications mode by which the Director and Actor communicate.
      1. Push mode: Director initiates communication to the Actor

      2. Pull mode: Actor initiates communication with the Director

        If the Actor is in Pull mode, you need to run vregister to register the Actor to the Director.
    6. Proxy Through Actor: Specifies the Actor to use as a proxy to communicate with the Director.

      Only Actors that are in Push communication mode can proxy through another Actor. Therefore, Actors installed as endpoint Actors or Protected Theater Actors cannot proxy through another Actor.

      An Actor can be used as an intermediate proxy in cases of network segmentation policies, where an Actor would not otherwise be reachable by the Director.

      For example, given Actor A, which is connected to the Director, and Actor B, which is in a remote network segment, when setting up Actor B, select Actor A in the Proxy Through Actor field. See Network Actor Requirements for more information.

    7. Location [Local/Cloud]: The Actor's location, specified as local or within the Cloud (Amazon Web Services or Azure).
    8. Pull Interval: The time interval (in seconds) between pull attempts between the Actor and the Director.
    9. Actor Time [System/NTP]: The method used for maintaining the Actor's time. This can be either system time or NTP (see Adding NTP Servers in your Director Install guide if no NTP servers are listed).This must be system time.

    10. Enable Network Keepalive: Actors send a periodic (default setting is hourly) ARP request for all Actor interfaces to maintain status in ARP tables.

  3. Click Submit.

    The Actor is populated in the Pending Actors list and a code is generated. This code must be used for registration within 15 minutes.

Add Network Actor form

After the Actor is registered, you can review and update the Actor details and capabilities. For more details, see Editing an Actor.

Create a Bulk Registration Token

  1. Launch the Director and sign in.
  2. Select Environment > Actors.
  3. Click Add Bulk Registration Token.
  4. Fill out the form and click Submit.
    1. Name: This value is used in the name of the Actors. The Actor name has the following format:

      <token_name>-#-<Actor IP address>.

      Actor names can be changed. Names must start and end with an alphanumeric character and be no more than 69 characters. Hyphens and periods are allowed but may not be next to each other. Spaces are not allowed.

    2. Security Zone: The security zone for the Actors.
    3. Expiration Date: The date the token is no longer valid.
    4. Max Uses: The number of times the token can be used. This value cannot exceed the number of available Actors allowed by your license.
  5. The token is created and is listed in the table. The token can be used for the easy install process or for registering Actors after they are installed.

  • June 5, 2022
  • April 3, 2025
In This Article