This article provides information on how to move the Server installation from one machine to another.  The document uses several terms like <user home> / App data - terms for which you may need a system administrator to help you to find or give you permission to access (see end of the article for more information as to where to find them).

 

Warning: We strongly recommend that you set up your new Server machine first, and make sure everything is working fine, before you delete Omniscope from the existing machine.

 

Step 1: Install Omniscope

 

Install Omniscope onto the new machine and make sure the license is activated. Visokio would be happy to provide a temporary key for the transition.

 

Step 2: Moving files to the new location


This step involves moving all the required files from your current installed machine to the new machine.


You need to move the following files to the new machine in the appropriate folders e.g. when moving “Omnicope-server” folder you would need to move it to the correct user home folder.



List of files / configurations you need to move:


  1. <Omniscope server folder> This folder also contains the config.xml and folder permissions, which would be copied once you move the entire folder.

    NOTE: You may need to adjust the paths in the config.xml and folder.xml , if necessary, by editing them manually using a text editor.


              (before moving make a copy of the existing omniscope-server folder in case something goes wrong).



  1. <INSTALLATION_LOCATION>/installconfig.properties (Windows)

           <INSTALLATION_LOCATION>/_launch.sh (Linux) 


            (before moving make a copy of the existing omniscope-server folder in case something goes wrong).


  1. <APP_DATA_VISOKIO>/Omniscope/LocalStorageRegistry.xml

           <APP_DATA_VISOKIO>/Omniscope/diskManagerSettings.xml

           <APP_DATA_VISOKIO>/Omniscope/MonetDb/ (maybe customised in diskManagerSettings.xml)


           (before moving make a copy of the existing omniscope-server folder in case something goes wrong).


Step 3: New Server testing


This step involves testing to make sure everything is working on the new server, before the changeover. Some of the tasks you should check: 


  1. Check the paths in the installconfig.properties/_launch.sh, config.xml, LocalStorageRegistry.xml, diskManagerSettings.xml are all valid.

            You will need to reconfigure your JDBC drivers again on thew new machine through Admin Web App, and re-apply any Advanced settings you may have set manually outside of Omniscope.

  1. Check Admin Web App by checking logs, after you've started the application.

  2. Test opening files and folders with configured Omniscope Server permissioning to make sure they are accessible


We advise doing a test run before decommissioning your old machine, lasting one day or more, until you are satisfied everything is working correctly.



Technical terms explained and their location


<USER_HOME>


This is user home directory of the user who has activated Omniscope. These are typically the following:



Operating system

Location

Linux

/home/<username>

Windows

C:\Users\<username>

Mac OSX

/Users/<username>

<username> is the user who has activated Omniscope


<INSTALLATION_LOCATION>


These are typical locations of where Omniscope has been installed.


Operating system

Location

Linux

/home/visokio-omniscope

Windows

All users: C:\Program files (x86)\Visokio Omniscope

Current user: <USER_HOME>\App Data\Local\Visokio Omniscope app

Mac OSX

/Applications/Visokio Omniscope.app

<username> is the user who has activated Omniscope


<APP_DATA_VISOKIO>


This is location Omniscope uses to store user-specific settings, and is also a standard practice in Operating system to store user specific settings.


NOTE: This location may be customised, depending on the changes in installconfig.properties (Windows / Mac OSX) or _launch.sh on Linux.

 


Operating system

Location

Linux

/home/<username>/.visokioappdata

Windows

 <USER_HOME>\App Data\Local\Visokio

Mac OSX

/users/<username>/Library/Application Support/Visokio

<username> is the user who has activated Omniscope


Omniscope server folder


This is where Omniscope Server hosts all the files.


NOTE: This location may be customised in installconfig.properties (Windows / Mac OSX) or _launch.sh on Linux.

 


Operating system

Location

Linux

/home/<username>/.visokioappdata

Windows

 <USER_HOME>\App Data\Local\Visokio

Mac OSX

/users/<username>/Library/Application Support/Visokio

<username> is the user who has activated Omniscope