Migrating data from RHEL 7

When upgrading your operating system from Red Hat Enterprise Linux Version 7 to a later version (Red Hat Enterprise Linux 9 (x86-64) is recommended) you need to perform a number of migration tasks.

About this task

Important: Older on-prem Agile Service Manager instances are deployed on RHEL 7 with Docker, while Agile Service Manager Versions 1.1.13 and later use RHEL 8 (and now Red Hat Enterprise Linux 9 (x86-64)) with Podman. This topic only applies if you are migrating from RHEL 7.
You perform the following tasks to migrate from RHEL Version 7:
  • Back up your existing Cassandra database.
  • Restore the database on the new system.
  • Run the re-broadcast crawler.
  • Copy over (or regenerate) any required observer certificates.

Procedure

  1. Backup Cassandra JanusGraph Keyspace on the RHEL 7 server. 
    cd $ASM_HOME
docker exec -it asm_cassandra_1 /opt/ibm/backup_scripts/backup_cassandra.sh -k janusgraph
  2. Copy backup to new RHEL server and change permissions. 
    cd $ASM_HOME
mkdir -p data/cassandra/backup
scp root@rhel7-server:/opt/ibm/netcool/asm/data/cassandra/backup/cassandra_<hostName>_KS_janusgraph_<date>.tar data/cassandra/backup/
chown -R 101001:101001 data/cassandra/backup/
    The Cassandra user will run inside the container with a user ID of 1001, which will map to a user ID of 101001 on the host.
  3. Restore the backup on the new RHEL server as the nasm user. 
    su - nasm
./bin/restore_cassandra.sh -k janusgraph -h <hostName>
./bin/asm_restart.sh

    Were <hostName> is the hostname from the backup file being restored.

  4. Run the re-broadcast crawler on the new RHEL server. 
    curl -ks -u asm:asm -X POST --header 'Content-Type: application/json' --header 'Accept: application/json' --header 'X-TenantID: cfd95b7e-3bc7-4006-a4a8-a73a79c71255' -d '{}' 'https://lensing1.fyre.ibm.com/1.0/topology/crawlers/rebroadcast'
  5. Copy over any certificates used by observer jobs.
    If you have any observer jobs that require the use of a certificate, then locate those certificates in $ASM_HOME/security and copy them to the new server.