How to continue using Acura after changing its public IP address

Continuing to use Acura after changing its public IP address

Challenge

Acura requires a new public IP, and the replications should continue working as before.

Solution 

This article covers the process from the start, so skip to #2 if you have already configured a new IP.

#1 To change Acura's public IP:
  1.       Go to ACP and select “Settings” from the menu.
      
  1.       Go to the “Cluster settings” tab. Update the “Hystax Acura Control Panel Public Address” field and save.
      

#2 Now that Acura has a new public IP address, the replication agents on the source machines have to be adjusted accordingly for the replications to continue. 
If you are using an external replication agent, simply download and reinstall it or alternatively update its settings.
  1. Open the instance VM console or establish an SSH connection to the agent. 
  2. Select the “Agent options” menu.
            
  1. Select the “Edit controller addresses” menu.
            
  1. Choose the option “Update all addresses at once”.
            
  1. Enter the controller public IP address and select “OK”.
            
  1. Restart the instance or select “1 Restart agent services” from the “Agent options” menu for the changes to take effect.
There are two ways to update internal agents:
  1. Reinstall the agents. For that, remove the existing replication agents and delete the old config files manually:
  1. For Windows Replication Agent:
C:\ProgramData\Hystax
If you can't see this folder, make sure that hidden files and folders are displayed and delete it. Terminate all repman or WinCBT procceses that might be left running.
After that, download a new agent installer from Acura and install the agent.

  1. For Linux Replication Agent:
sudo rm -rf /etc/hystax
After that, download a new agent installer from Acura and install the agent.

Acura will automatically inject the agent with the valid SSL certificate and IP address before the download.
Alert
If you choose to reinstall the agents, the source machines will require new full replications.
  1. Update agent configs with the new certificate and the new public IP. This can be done in a semi-automatic manner with the help of our script. 
    1. Download the file:
      1. For Windows Replication Agent: hwragent-update-cert-and-ip.cmd
      2. For Linux Replication Agent: hlragent-update-cert-and-ip.sh
    2. Update the certificate: open the file and replace the existing certificate with a valid one.
    3. Launch the script: run the script on the appropriate machine.
    4. Verify replication:
    5. The machines will be detected by Acura, and replication will proceed.
Idea
If you choose to update the config files, the existing replication data will be maintained allowing incremental replications to follow.  


    • Related Articles

    • Configuring a new network interface for the Acura instance

      Challenge Use TUI to set up a new network interface. Please refer to the KB article below if you are looking to perform this operation for an Acura (version 4.2 or newer) deployment in VMware: How to change network settings of an Acura instance in ...

    • Custom settings for a replication agent when creating a new customer in ACP

      Task When a replication agent is downloaded from the ACP, it is injected with the current network information vital for connecting to the Acura instance and discovering machines for the given customer. Depending on the actual layout, Acura may be ...

    • How to change network settings of an Acura instance in VMware (version 4.2 or newer)

      Challenge Hystax Acura for VMware is deployed as a virtual machine to a source ESXi host. It uses DHCP for its NIC by default. However, these default settings might not work in case the source VMware infrastructure doesn't have DHCP enabled or ...

    • Viewing log analytics for Acura (Kibana)

      Task How to view log analytics. Solution Find the instructions for versions 4.4 and above in the Acura Documentation. Below are the instructions for versions earlier than 4.4: 1. Use the Kibana service to view log analytics. It is available at: ...

    • Renaming the cloud agent image in Hystax Acura

      Task Change the name of the cloud agent image Solution "Hystax_CATI" is the default Cloud Agent image name used while we deploy Hystax Acura. Sequence of steps on an already deployed Acura: Rename the Cloud Agent image. Create a new customer, ...