Migrating to a five-node deployment

Edit online

You can convert your single-node or three-node production cluster to a multi-node cluster with five nodes.

Note: Migration of single-node demo installation type clusters is not supported.

Preparing your hosts

Edit online

To your existing single-node cluster, add two more hosts of the same platform and operating system as the current host.

Then, complete the migration by following these steps:

  1. On all the five hosts, make sure that the ports are open.

  2. On all the five hosts, configure private IP addresses.

  3. On the new hosts, make sure to check the Kernel parameters.

  4. On the new hosts, check the required packages and environment variables.

  5. On all the five nodes, configure secure shell.

  6. Shut down Self-Hosted Standard Edition on the current host.

    stanctl down
    Attention:

    Self-Hosted Standard Edition 1.10.3 and earlier versions:

    • For online (non–air‑gapped) installations, most stanctl lifecycle commands, such as stanctl up will fail to run.
    • For air‑gapped installations, the stanctl commands continue to work.

    Required action: Upgrade stanctl to 1.10.4 or later versions before you perform a lifecycle operation.

    Example: On online deployments that run stanctl 1.10.3 or earlier versions, any workflow that stops services, such as a stanctl down command, before a backup, cannot complete because the subsequent stanctl up command fails. Upgrade stanctl to 1.10.4 or later versions before you start these steps.

Moving the disks from the old host to the new host

Edit online

For more information about how the storage directories are used in a multi-node cluster, see Storage requirements.

Note: If your hosts are deployed in a cloud environment, follow the instructions that are provided by the cloud provider for mounting and unmounting the paths. For example, for AWS EC2, see Amazon EBS volume lifecycle Opens in a new tab or window.

Unmounting and mounting the paths in a non-cloud environment are shown in the following examples:

Migrating from a single-node deployment to a five-node deployment

Edit online

During migration, move three disks from your old host and attach it to the new host:

  • node1 (instana-1): Receives the data and metrics disks
  • node3 (instana-3): Receives the analytics disk

  1. On the old host (node0 (instana-0)), unmount the data, analytics, and metrics paths.

    umount /mnt/instana/stanctl/analytics
umount /mnt/instana/stanctl/metrics
umount /mnt/instana/stanctl/data

  2. Detach the three disks from the old host (node0 (instana-0)).

  3. Update fstab entry.

    sudo cp /etc/fstab /etc/fstab.bak
for folder in analytics metrics data; do 
  sudo sed -i "/^[[:space:]]*#/! {/[^[:space:]]*\/${folder}[[:space:]]/ s|^|# |}" /etc/fstab
done

  4. On the new host node1 (instana-1):

    1. Attach the data and metrics disks from (node0 (instana-0)).

    2. Create the data and metrics directories. For more information, see Creating the directories.

    3. Mount the data and metrics paths. See the commands in Adding mount paths.

    4. Complete the steps as given in sections Verifying the mount paths and Mounting the file systems.

  5. On the new host node3 (instana-3):

    1. Attach the analytics disk from (node0 (instana-0)).

    2. Create the analytics directory. For more information, see Creating the directories.

    3. Mount the analytics path. For the commands, see Adding mount paths.

    4. Complete the steps that are listed in Verifying the mount paths and Mounting the file systems.

Migrating from a three-node deployment to a five-node deployment

Edit online

During migration, move one disk from your old host and attach them to the new hosts:

  • node3 (instana-3): Receives the analytics disk

  1. On the old host (node1 (instana-1)), unmount the analytics path.

    umount /mnt/instana/stanctl/analytics

  2. Remove the disk from the old host (node1 (instana-1)).

  3. Update fstab entry.

    sudo sed -i.bak "/^[[:space:]]*#/! {/[^[:space:]]*\/analytics[[:space:]]/ s|^|# |}" /etc/fstab

  4. On the new host node3 (instana-3):

    1. Attach the analytics disk from (node1 (instana-1)).

    2. Create the analytics directory. For more information, see Creating the directories.

    3. Mount the analytics path. For the commands, see Adding mount paths.

    4. Complete the steps that are listed in Verifying the mount paths and Mouning the file systems.

Migrating Standard Edition to the new cluster

Edit online
  1. On node0 (instana-0), start migration: 
    stanctl up --multi-node-migrate

    The following message is displayed :

    ? Enter the IP addresses for all three or five nodes, separated by commas (e.g. 10.8.1.10,10.8.1.11,10.8.1.12):

  2. Enter the IP addresses.

    After a few minutes, your data is migrated to the new hosts. Standard Edition is now deployed on the five-node cluster.

  3. If agents for self-monitoring are installed, update Instana agents. If self-monitoring agents are not installed, skip this step.

    stanctl agent apply