AWS 10.6.6.x to 11.3 Upgrade: Migrate Disk Drives from 10.6.6.x to 11.3

Document created by RSA Information Design and Development on Apr 12, 2019Last modified by RSA Information Design and Development on Jul 12, 2019
Version 7Show Document
  • View in full screen mode
 

These instructions tell you how to upgrade virtual hosts from 10.6.6.x to 11.3.

Caution: 1.) Run the backup immediately before you upgrade hosts for each phase so that the data is not out-dated.
2.) This guide applies to AWS host upgrades exclusively. If have physical and virtual hosts in your deployment, see the RSA NetWitness® Platform 11.0 Physical Host Upgrade Instructions for the steps you must complete to upgrade physical hosts. Go to the Master Table of Contents to find all NetWitness Platform Logs & Network 11.x documents.

There are five tasks you must complete to migrate from 10.6.6.x to 11.3:

Task 1 - Backup the 10.6.6.x EC2 appliance

(Optional) Task 2 - Run the backup script to take backup data of 10.6.6.x instance

Task 3 - Stop the instances and detach volumes from 10.6.6.x instances

Task 4 - Note the IP addresses of 10.6.6.x instances and then terminate the EC2 instances

Task 5 - (IP retention) Create 11.3 instances using 11.3 AMI.

Task 6 - Attach volumes to the corresponding 11.3 instance

Task 7 - Restore backup data in 10.6.6.x to 11.3 Instances (Data Restoration)

Task 8 Run nwsetup-tui script

Task 1 - Backup the 10.6.6.x EC2 appliance

Select the 10.6.6.x EC2 Instance and navigate to Actions. Click Image and then select Create Image.

(Optional) Task 2 - Run the backup script to take backup data of 10.6.6.x instance

Note: If you have not taken a backup of the 10.6.6.x instance, follow these steps, otherwise skip to Task 3 - Stop the instances and detach volumes from 10.6.6.x instances.

If the stack contains Log Collector then prepare Log Collector for the migration:

1. Navigate to /opt/rsa/nwlogcollector/nwtools/ and run the below command:

sh prepare-for-migrate.sh –-prepare

2. Download backup scripts from GitHub: https://github.rsa.lab.emc.com/asoc/nw-backup (maintenance-11.0) and place it anywhere in a computer running an RPM-based Linux distribution (RHEL or CentOS for example) with a large amount of free hard drive space. In many cases the SA server will suffice. Now, navigate to scripts directory inside ‘nw-backup-master’ and run the following commands: 

./get-all-systems.sh <SA server-IP>

./ssh-propagate.sh <path-to-backup-directory/all-systems>

./nw-backup.sh -u

Its safe to copy a backup of the tar balls created at /var/netwitness/database, in some safe location (not mandatory).

Before starting the restore process, if you have ESA deployment then copy the files <hostname>-<IP>-controldata-mongodb.tar.gz & <hostname>-<IP>-controldata-mongodb.tar.gz.sha256 from the location /opt/rsa/database/nw-backup of ESA VM to /var/netwitness/database/nw-backup/ of SA VM.

Task 3 - Stop the instances and detach volumes from 10.6.6.x instances

Note: If detach fails, do a forced detach on the volume.

Select the 10.6.6.x EC2 instance and navigate to Actions and then click Stop.

Click on Volumes and then select the 10.6.6.x instance volumes to detach Actions and then select Detach Volume.

Task 4 - Note the IP addresses of 10.6.6.x instances and then terminate the EC2 instances

Note: Termination is required to free the IP address.

  1. Click on Instances and then select the Instance.
  2. Click Actions and navigate to Instance State.
  3. Click Terminate

Task 5 - (IP retention) Create 11.3 instances using 11.3 AMI.

1. During the creation of EC2 instance, provide the IP address from task4. Click on AMIs and select 11.0 AMI.

Note: Refer to the AWS Deployment Guide for version 11.0 for installing RSA NetWitness Platform11.0.0.0

2. Click Actions and then click Launch.

3. Assign the retained IP for the appropriate instances (IP retention). For example, If 10.6.1.xSA instance IP is 172.24.184.63 . Then assign the same IP(172.24.184.63) for 11.3 Instance.

Note: To deploy components other than NW, select the image(RSANW-11.0.0.0.1245-Lite-01) which is available under community AMIs section.

Task 6 - Attach volumes to the corresponding 11.3 instance

After NW 11.3 instance is deployed, stop the 11.0 instance and attach the available 10.6.1.x volumes (except the 'OS disk') to 11.3 instances.

1. Click on Volumes.

2. Select the 10.6.6.x instance volume to attach.

3. Click Actions and then select Attach Volume.

4. Enter the 11.3 instance ID to which the volume has to be attached.

5. Power ON all the 11.3 instances once all the disks are attached.

Task 7 - Restore backup data in 10.6.6.x to 11.3 Instances (Data Restoration)

Execute the following steps for copying the backup data on SA, LD/LC, PD, Concentrator, Archiver, Broker:

  1. Create a directory under /tmp/ by the name nwhome.
  2. Mount VolGroup00-nwhome on /tmp/nwhome/ and make sure /var/netwitness/database/ directory is present.

mount /dev/mapper/VolGroup00-nwhome /tmp/nwhome/

  1. Copy the contents of /tmp/nwhome/ directory to /var/netwitness/.
  2. Unmount VolGroup00-nwhome from /tmp/nwhome/

umount /dev/mapper/VolGroup00-nwhome /tmp/nwhome/

Follow these steps for ESA:

  1. Create a directory under /tmp/ by the name apps.
  2. Mount VolGroup01-apps temporarily on /tmp/apps/

mount /dev/mapper/VolGroup01-apps /tmp/apps/

  1. Copy nw-backup directory from here to /var/netwitness

cp -r /tmp/apps/database/nw-backup /var/netwitness

  1. Unmount VolGroup01-apps from /tmp/apps/

umount /tmp/apps

  1. Add the following entries in /etc/fstab for mounts:(Disk Mounting) and then run mount -a

For SA:

/dev/mapper/VolGroup01-ipdbext /var/netwitness/ipdbextractor/ xfs defaults,noatime,nosuid 1 2

/dev/mapper/VolGroup02-redb /var/netwitness/database/ xfs defaults,noatime,nosuid 1 2

For LogDecoder/LogCollector:

/dev/mapper/VolGroup01-decoroot /var/netwitness/logdecoder ext4 defaults,noatime,nosuid 1 2

/dev/mapper/VolGroup01-index /var/netwitness/logdecoder/index xfs defaults,noatime,nosuid 1 2

/dev/mapper/VolGroup01-sessiondb /var/netwitness/logdecoder/sessiondb xfs defaults,noatime,nosuid 1 2

/dev/mapper/VolGroup01-metadb /var/netwitness/logdecoder/metadb xfs defaults,noatime,nosuid 1 2

/dev/mapper/VolGroup01-logcoll /var/netwitness/logcollector xfs defaults,noatime,nosuid 1 2

/dev/mapper/VolGroup01-packetdb /var/netwitness/logdecoder/packetdb xfs defaults,noatime,nosuid 1 2

For PacketDecoder:

dev/mapper/VolGroup01-decoroot /var/netwitness/decoder ext4 defaults,noatime,nosuid 1 2

/dev/mapper/VolGroup01-sessiondb /var/netwitness/decoder/sessiondb xfs defaults,noatime,nosuid 1 2

/dev/mapper/VolGroup01-index /var/netwitness/decoder/index xfs defaults,noatime,nosuid 1 2

/dev/mapper/VolGroup01-metadb /var/netwitness/decoder/metadb xfs defaults,noatime,nosuid 1 2

/dev/mapper/VolGroup01-packetdb /var/netwitness/decoder/packetdb xfs defaults,noatime,nosuid 1 2

For Concentrator:

/dev/mapper/VolGroup01-concroot /var/netwitness/concentrator ext4 defaults,noatime,nosuid 1 2

/dev/mapper/VolGroup01-sessiondb /var/netwitness/concentrator/sessiondb xfs defaults,nosuid,noatime 1 2

/dev/mapper/VolGroup01-index /var/netwitness/concentrator/index xfs defaults,noatime,nosuid 1 2

/dev/mapper/VolGroup01-metadb /var/netwitness/concentrator/metadb xfs defaults,noatime,nosuid 1 2

For Archiver:

/dev/mapper/VolGroup01-archiver /var/netwitness/archiver xfs defaults,nosuid,noatime 1 2

/dev/mapper/VolGroup02-workbench /var/netwitness/workbench xfs defaults,nosuid,noatime 1 2

For Broker:

/dev/mapper/VolGroup01-broker /var/netwitness/broker xfs defaults,nosuid,noatime 1 2

  1. Then run mount command
    mount -a

Task 8 Run nwsetup-tui script

Note: Please provide appropriate host names for all the 11.3 instances after launching. (for 10.6.6.x instance names refer all-systems-master-copy file, which contains 10.6.6.x instance names with IP address)

Execute the command to set the hostname: hostnamectl set-hostname <hostname>

Login to SA Sever CLI and run nwsetup-tui script for rest of the process completion.

Run 'nwsetup-cli' on rest of the components for Bootstrap and Orchestration. For more information, refer to the Set Up Virtual Hosts in 11.3 section.

Previous Topic:Backup Instructions
You are here
Table of Contents > Migrate Disk Drive

Attachments

    Outcomes