Overview

This procedure outlines the steps to do in the SnapLogic® Classic IIP when the JCC node VM of the Groundplex is migrated to another region. For example, you can use these steps to migrate the VM from the US West region to the US East region (Azure platform).

Prerequisite

Ensure the firewall rules are updated with the new host names and IP addresses to enable inter-node communication. For more information, refer to https://docs-snaplogic.atlassian.net/wiki/spaces/SD/pages/2188804101.

Steps to migrate the Groundplex

1. As an Org admin, log in to SnapLogic and open Monitor from the Apps menu on the right side of the header. The SnapLogic Monitor System overview displays information about Snaplexes and their nodes. This is as shown in the images below:

Open

Open

2. Open the System overview from the Infrastructure link in the navigation pane. Click a node to view its details in the node map or list view. The Node details include the current status, resource usage, and the associated pipeline execution history. Learn more at https://docs.snaplogic.com/monitor/monitor-snaplex.html

3. From the header of the node details panel:

   1. Click the Snaplex name to open and view the details.

   2. For Groundplexes, the Org admins can click the gear icon to restart or put the node in maintenance mode.

4. Setting Maintenance mode completes any current jobs on the node and prevents additional jobs from running on that node. (In Classic IIP, this is under the Snaplex Health tab on the Dashboard).

5. Ensure that there are no running pipelines by checking the pipeline wall of the Snaplex Dashboard.

6. Log in to the Linux server as a root or sudo user, and execute the below commands to stop the JCC node and the service:
   $ sudo /opt/snaplogic/bin/jcc.sh stop
$ sudo systemctl stop snaplogic.serviceUse the command /opt/snaplogic/etc directory and backup the *.properties files (if any) and the .slpropz file.

7. Complete the region migration to the required region for the Linux server/VM. Learn more on Azure region migration at https://learn.microsoft.com/en-us/azure/resource-mover/tutorial-move-region-virtual-machines.

8. If the migration is not performed using the Azure move utility, then install JCC on the new VM. (i.e., If a new VM is being provisioned in the new region). Learn more

9. Download the Configurationfile for the Groundplex from the Manager > Project Spaces > shared > Snaplex > Downloads tab.
   
   

7. Update the load balancer URL under the Snaplex Settings tab only if there is a change to the load balancer host name.
   
   

8. Use the following commands to restart the JCC node and service by logging in to the migrated or new Linux server:
   $ sudo /opt/snaplogic/bin/jcc.sh start
$ sudo systemctl stop snaplogic.service

9. Verify the migration by successfully executing a few Triggered and Scheduled tasks.

12. Repeat the steps from 1 to 10 for the other Snaplex nodes.

Related content: