How to Create a Customer Testing Environment (4305921)

Old SMA matches the new SMA version: Please ensure the old (Production PROD) SMA version matches the exact version of the new (Development DEV) SMA server. Failure to do so will cause the migration to fail. Also, please ensure that Single Sign On disabled before making the backup that will be used for the migration.

How to Create a Development (DEV) Box:

1. Note the exact version of the Production (PROD) box and download the appropriate VM template (OVF/Hyper-V)
   1. If this version is no longer available on the downloads site, it will be necessary to contact technical support
2. Create a new box using the template downloaded in the previous step
3. Login to the adminui using the IP assigned by DHCP
   1. License will be required during this step
   2. If no DHCP: use the account konfig/konfig at the console level to assign an IP and set network settings prior to logging into the webui (adminui)
      1. http(s)://HOSTNAMEorIP/adminui

Note: Prior to taking the full backup in the next step (that will be used to restore to the new DEV box), ensure that SSO is disabled and the box is unjoined from the domain. Then complete full backup, offboard backups, rejoin domain, re-enable SSO.

4. From the PROD box, take a full backup and offboard the backups to a network location
5. From the newly created DEV box, go to Settings | Backup Settings from the AdminUI or SystemUI
6. Go to the Uploads section and navigate to the backups from the PROD box above (base and differential)
7. Click on Upload Files
   1. If the backup files are larger than 2G, it may be necessary to upload the backups onto the box via CMD or FTP client

Note: The next step is going to cause a reboot of the DEV box

 

CRITICAL: Restoring backups from the PROD box into the DEV box will cause the IP and Hostname of the PROD environment to be duplicated in the DEV environment. Please check with your networking team to ensure the NIC is disabled or that the network is segmented properly prior to restoring the backups (to prevent agents from contacting the DEV box after restore).

Failure to do so may cause IP/Hostname conflicts in the environment. In the event that information meant for the PROD environment (inbound email, agent communication, etc) is sent to the DEV environment due to not having the network segmented properly, that data will be lost.

9. Once the files are uploaded and available to choose from the Onboard Backups section, choose the backups and click on Restore From Backup
10. Once the new box is done restoring, it will have the PROD box network settings (IP and Hostname)
    1. This should be addressed in Network Settings immediately
11. Once the new box is done restoring, all service desk queues will have the same email addresses as the PROD box
    1. This should be addressed in Queue Email Settings immediately
12. The network changes can be completed from the AdminUI or SystemUI
    1. Alternatively the network settings portion can be updated from the console directly using the konfig/konfig account
13. Change to the queue mailboxes will require logging into the webui to change them from each queue individually
14. Once the DEV box is complete, it is possible to change the host of a couple of agents to test with the DEV box
    1. Windows:
       1. Locally on the test devices, open a CMD prompt
          1. cd "\Program Files (x86)\Quest\KACE"
          2. amptools.exe host=HOSTNAMEorIP
          3. runkbot 4 0
    2. Mac/Linux:
       1. Locally on the test devices, open Terminal
          1. cd /Library/Application\ Support/Quest/KACE/bin
          2. sudo ./AMPTools host=HOSTNAMEorIP
          3. sudo ./runkbot 2 0

Note: Due to possible database changes with every upgrade, KACE strongly recommends that a development box is created and tested prior to each upgrade of the KACE SMA.