Reattach an Actor

If an Actor has to be reimaged, due to migration or corruption, the Actor reattachment feature lets you create a fresh Actor. This feature also retains the configuration (such as Jobs and Monitors) for that existing Actor in system settings.

Although the new Actor must have the same capabilities as the old one, it can have its own new capabilities. However, make sure that those new capabilities are equivalent to the previous Actor.

In general, the new Actor node must use the same operating system as the original one to prevent crossing up old/new Actors (for example, Windows, macOS, or Ubuntu). Network Actors have some exceptions; for example, a CentOS-based Actor can be reattached as a Rocky Linux-based Actor, but keep in mind that a CentOS Actor can't be reattached as an Ubuntu Actor. In addition, the new node must be the same type (for example, appliance vs non-appliance) as the original one to prevent mistakes.

Reattach an Actor

From the Director web interface, select Environment > Actors.
In the Actions menu, locate the Actor that you want to reattach, click  more, and then click Re-attach.
- A new registration token gets generated when you click Re-attach.
- Reattaching an Actor results in any attached monitors failing until the Actor is reconnected.
Read the message that asks if you’re sure that you want to attach the Actor to another Actor, and then click OK to continue. The Actor gets added to a pending list.
To see details about the previous Actor's IP information, click  info, which appears next to the pending Actor in the Status column. Details include Management IP, Test IP, and/or Monitor IP information, and the original Actor's capabilities. Click OK to close the window.

Actor IP and Original Capabilities details
Connect to the Actor by using SSH, and then run the following command on the Actor before proceeding to the next step or the connection may fail:
```
sudo /opt/apps/verodin/node/node/scripts/vreset
```
Reattach the Actor using the steps that pertain to your Actor mode:
- Pull mode (CLI):
  1. Connect to the Actor by using SSH.
  2. Run the following command:
```
sudo /opt/apps/verodin/node/node/scripts/vregister
```
  3. Enter the registration token on the Actor.
- Push mode (web interface):
  1. To connect the Actor, return to the Director web interface and then click  more. The Connect Actor window opens.
  2. In the Connect Actor window, enter the Management IP or FQDN. To validate the FQDN, check Validate FQDN.
    FQDNs must comply with RFC 1123, a standard that defines the requirements for FQDNs on the internet. This standard specifies that FQDNs can only contain the following:
    - Letters (A-Z, a-z)
    - Digits (0-9)
    - Hyphens (-)
    Underscores are not permitted.
    
    For more information, see RFC 1123: Requirements for Internet Hosts.
  3. Click Connect.