1. Help & Support
  2. Update and Migrate

Migrating from old versions of Hyperglance to v6.3.3 or newer

Note: If you are upgrading from Hyperglance v6.3.3 to a newer version then please see our newer migration guide.


Migrating from older versions of Hyperglance required a more manual process outlined below.




Export Credentials

Hyperglance gives you the options to export and import credentials for migration and backup purposes. 


Step 1: Navigate to the Administration page


Step 2: Select 'Export'



Step 3: Select Continue




Import Credentials


Step 1: Navigate to the Administration page


Step 2: Select 'Import'



Step 3: Choose the required credential file and select 'Submit'. 


Hyperglance will import the credentials and show any issues in a pop up window.




Export Rules


Step 1: Navigate to the 'Dashboard'


Step 2: Select the 'Export' icon


Hyperglance will export a .zip file with all your rules compressed to your default download folder




Import Rules


Step 1: Navigate to the 'Dashboard'


Step 2: Select the 'Import button'



Step 3: Choose the required rules .zip file and select 'Submit'


Hyperglance will import all the rules and show any issues in a pop up window.





Transfer App View Tags

Transfering from recent Hyperglance versions 6.3.0, 6.3.1 and 6.3.2:

These are managed via the Settings page (see here), you will need to manually transfer them across to a newer version of Hyperglance.


Transfering from older Hyperglance versions prior to 6.3:

App view tags in versions prior to 6.3.x are stored across two files:

/opt/wildfly/standalone/deployments/collector-plugins/AzureCollector.ear/lib/config.jar/runtime.properties

/opt/wildfly/standalone/deployments/collector-plugins/awscollector.ear/lib/config.jar/runtime.properties

Within these files are properties named amazon.apptag.keys and azure.apptag.keys and the tags are represented as a comma-separated list. You will need to manually transfer both sets of apptag keys into the new user-interface for tag views.



Transfer SMTP Settings

You can manually copy SMTP settings over from previous versions of Hyperglance and re-enter them in the new version. See How to Add SMTP Settings.


Alternatively transfer the file from the old VM which was located at:

/opt/wildfly/standalone/deployments/hgs.ear/lib/common.jar/email.properties

And move it to the new VM to this file location:

/var/lib/data/hyperglance/hgs-email.properties

Transfering RBAC (Users, Passwords and SAML) configuration

Unfortunately there is no way to transfer these. You will need to recreate them on the new VM. See more about administering users and configuring RBAC.