This article will assist users in migrating their current ClickView Publisher (Master) setup from their existing server to a new server.
Note: When you are ready to begin the migration process you will need to contact ClickView Support requesting that your existing ClickView Publisher (Master) binding is removed from ClickView Online - this is necessary as whenever ClickView Publisher is initially installed, the FQDN of the machine that this is installed to is uploaded to the ClickView Servers - this process prevents multiple ClickView Publisher (Master) instances being installed.
This process can be broken down to four sections:
- Installation and Configuration of the new ClickView Publisher (Master) instance
- Running the backup of content from your existing ClickView installation to your new server
- Verifying the migration process and adjusting configuration where necessary
- Decommissioning of your existing server and adjusting your ClickView Player setup to ensure functionality
- Desktop Experience (Server 2008 / 2012) - Guidance on activating this can be found in this KB
- ClickView Publisher Activation Key - this is an eight-digit code - contact ClickView Customer Service if you do not have a record of this
This type of install for ClickView Publisher is typically performed when installing ClickView Publisher for the first time at the institution or when migrating the existing instance to a new machine.
1. Download the latest version of the ClickView Publisher setup for your respective region:
2. Open the ClickView Publisher setup file by navigating to its download path and double clicking on it.
NOTE: Depending upon your computer's security settings, a User Account Control dialog box may appear, questioning Do you want to allow the following program to make changes to this computer? Click Yes.
3. The ClickView Publisher Setup installer should be open and at the welcome screen. Click Next.
4. The End-User License Agreement should be displayed. If you agree to the terms in the License Agreement, tick the tickbox for I accept the terms in the License Agreement and click Next. You must agree to the terms in the License Agreement to continue with the installation of ClickView Publisher.
5. The activation page should be displayed. Your institution's activation key will be required to progress to the next stage. Enter your institution's activation key within the textbox, as illustrated in the below screenshot. Depending upon the setup of your institution's network, you may need to input proxy settings into the installer to allow the installer to connect to our activation servers. If you must enter proxy setting details, follow the instructions within the below note, otherwise click Next.
NOTE: If proxy settings are required, click on the Proxy Settings button within the activation page of the installer (as seen below).
- a. The proxy settings configuration page should be displayed. Tick the Access the Internet using an HTTP proxy server tickbox to allow the input of proxy settings.
- b. Tick the Bypass Local tickbox to ...
- c. Depending upon the configuration of your proxy server, your institution may use a manual proxy with an IP address it connects to, or an automatic configuration script which configures proxy server access. Fill in the correct radio button for Manual Proxy or Automatic Script. Input the proxy server's address and port, or the automatic configuration script address respectively.
- d. If your proxy server requires user authentication (an authentication box generally appears whenever you try and access the internet or open an internet browser), then tick the Require User Authentication tickbox. Input valid user credentials within the username and password fields.
- e. Click Ok to progress with the installation.
6. The application destination folder screen should be displayed. This step requires you to input the installation directory for ClickView Publisher. Click the Change... button to open the Change Destination folder window. This window will allow you to change the installation directory of ClickView Publisher. Click on the down arrow to the right of Look in: to navigate to a directory. Once the directory has been chosen, ensure the installation path is correctly displayed within the Folder name: text box. Click OK to save the installation directory. Click Next to progress with the installation.
7. The Service Logon Account screen should be displayed. This window requires administrative network account details to be inputted for use by the ClickView Publisher services. A network administrator account is required, as ClickView Publisher requires both local and network privileges that only a network administrator account can provide. Ensure the domain and the account name is correct inputted, along with the account password. The user account credentials will be checked to ensure that they are correct. Click Next when ready.
8. The network administrator details entered in step 7 will be checked to ensure that the credentials provided are correct. A dialog box will pop up to advise if they are correct. If the dialog box advises that the credentials are not correct, double check the spelling for the domain and account name. Ensure the password was correctly entered. Click OK once the username and password dialog box advises that the details inputted were correct.
9. ClickView Publisher is ready to be installed. Click Install.
10. Allow ClickView Publisher to progress through the installation process.
11. Once ClickView Publisher has finished installing; the set up will advise that it has completed the ClickView Publisher Setup Wizard. Click Finish to exit the installer.
12. You may be prompted to restart your machine - you can click No for now - a reboot may be required in the later stages of the installation however.
The next stage of the migration is to move your current ClickView data and ClickView database from the instance that they currently reside on, to your new Publisher (Master) instance.
1. Launch ClickView Publisher on your existing instance. Navigate to Tools then Backup Utility.
You will be presented with a screen similar to the one below:
2. As you can see from the above screenshot, our ClickView Database on our existing instance is stored at C:\Program Files (x86)\ClickView\ClickView Library\CVDB.mdb and our binary data (video files etc.) is stored at E:\ClickView Data. The ClickView database (CVDB.mdb) and the physical ClickView binary data need to be copied from your existing instance to the new instance. The simplest way to move this data is a simple copy and paste across your network.
3. Access the Database Path on your existing instance and locate the CVDB.mdb file as shown below:
4. Make a copy of the CVDB.mdb file on your existing instance and copy this into the root of your new ClickView Publisher (Master) installation directory. You can copy the CVDB.mdb file to your new ClickView Publisher by typing in the database UNC path that you made a note of earlier. In our case this was '\\support\ClickView$'.
5. Access this location on your existing ClickView instance by typing the UNC path you noted earlier into the file manager on the new ClickView Publisher instance, as shown below:
6. Copy the CVDB from your existing instance to your new instance. You will be prompted to overwrite the default CVDB.mdb file with the one you are copying. Click Copy and Replace.
7. Once you have copied your CVDB.mdb in to your new ClickView Publisher installation directory, launch the ClickView Publisher software on your new instance. You should see your ClickView digital library folder structure appear on ClickView Publisher as it does on your existing ClickView instance. If this is not the case, please contact ClickView Support for guidance before proceeding any further.
8. The next step is to copy your ClickView binary data from its existing location, to your new ClickView instance. If your ClickView data is stored on a NAS or file server and you are intending on keeping it in this location, then you do not need to copy your binary data anywhere (as your new ClickView Publisher (Master) instance is already connected to it).
Note: As ClickView data can be hundreds of GB's or even a TB in size, institutions may want to wait until after school-hours before commencing the step below to ensure that network performance is not affected by the ClickView data being copied across the institutions LAN network from the existing instance to the new instance.
9. Navigate to your existing ClickView data binary location. The below example uses 'E:\ClickViewData' as the binary location.
10. Copy all of the folders that appear in this directory.
11. On the new instance, navigate to the binary data network share that we created earlier (and took a note of).
12. Copy the files from your existing instance to your new instance. You may be asked to overwrite folder names.
13. The copying dialog box should appear with an estimation of how long the copying process will take. The length of time the binary data takes to copy is determined by the amount of data being copied as well as the available bandwidth and network speeds at your institution.
14. Once completed, open ClickView Publisher on the new instance. Go to Tools and then Data Management. Run Verify Data to confirm the data has been successfully imported.
The next stage of the migration is to move your current ClickView data and ClickView database from the instance that they currently reside on, to your new instance. The Master instance of ClickView Publisher has an in-built backup utility that allows for a scheduled or manual backup of an institutions ClickView Data to be set - this backup is comprehensive and contains a school's ClickView database file (CVDB.mdb) as well as the physical binary data itself. We can use the backup utility to back up the data on the current instance for restoration on the new instance.
Performing the backup of your existing data to the new instance
1. Launch ClickView Publisher on your existing instance. Navigate to Tools and then Backup Utility.
You will be presented with a screen similar to the one below:
2. Click on the browse button [".."] in the Backup Target Path for ClickView Data section. Navigate and select the target backup folder. This path can be referenced to either a local drive (internal or external) or a network drive. If possible, you can set the backup to occur directly on the new instance by setting up a network share on the new instance, and selecting that network share as the backup target path.
3. From here, browse to your desired backup location. In our case, we have selected a network location of 'Neil-PC' and created a 'Backup' Folder in this location. This location was then selected as our Backup target path by clicking OK. This is an ideal scenario if NEIL-PC was the newly provisioned ClickView Publisher instance.
4. The Backup Target Path now shows the location which we have set.
5. Start the backup process by clicking Backup Now.
6. During the backup process the Backup Utility will display the number of files that have been backed up, the number of files that need to be backed up, and the total number of files found within your database.
Each time the Backup Utility is executed only the files that have been recently modified, or not backed up, will be copied. Thus the number of files to back up may not match the total number of files within your database as some may have been already backed up.
7. Once the backup process has completed, simply close the backup utility.
Restoring the backup on the new instance
1. Open ClickView Publisher on the new instance, and ensure the ClickView Publisher service is stopped by clicking File from the menu and then choosing Stop ClickView Publisher Service.
2. Navigate to the location where your ClickView backup is located and copy the CVDB.mdb file.
3. Navigate to your ClickView Publisher installation path. Paste the CVDB.mdb file within the installation directory. You should be prompted to Replace the empty database file (approx. 660KB) within the installation directory. Click Copy and Replace.
4. If you want your ClickView Data to reside in the location that it was originally backed up to, then skip this step. If you would like to move the binary data to a different location, navigate back to your backup directory, and copy all of the folders located within this directory.
5. Navigate to the location you want the binary data to reside, and paste the copied folders. If this is in the default install directory location, you may need to once again choose Replace All or Do this for all current items when prompted.
6. Once the files have been transferred successfully, go to the new ClickView Publisher installation directory and run the file UninstallClickViewService.exe. A Command window will open up briefly and close once it has completed the task.
7. Whilst still in the ClickView Publisher installation folder, select and run the file InstallClickViewService.exe. Again this will open up a Command window briefly and close once it has completed the task.
1. Open your registry (Registry Editor - regedit.exe)
2. Navigate to:
- 64-bit Machines: HKEY_LOCAL_MACHINE -> SOFTWARE -> Wow6432Node -> CLICKVIEW -> CLICKVIEW LIBRARY
- 32-bit Machines: HKEY_LOCAL_MACHINE -> SOFTWARE -> CLICKVIEW -> CLICKVIEW LIBRARY
You should see the ClickView registry keys, as per the below screenshot.
NOTE: You may not see remoteDatabasePath, remoteDataPath and remoteLocalCachePath. This is normal for a new install. These registry keys are created when network shares for the DatabasePath, DataPath and LocalCachePath are created. This will occur in Step 4. You may want to return back to the registry to check the remoteDatabasePath, remoteDataPath and remoteLocalCachePath values after the network shares have been created.
3. As per the above screenshot, the registry values above store many data elements crucial to your ClickView Publisher operation. These include your ClickView Database Path (DatabasePath), your ClickView Library Data Directory (DataPath) and your Local Cache Path (LocalCachePath). To change a value, just double click on the registry entry name. This will open a new window called Edit String. Here you can change the path. Click and change the data within the Value data: box to the correct paths.
4. Ensure all the registry paths have been correctly set to match your data location.
1. Launch ClickView Publisher. Navigate to File, then ClickView Publisher Service Details. Tick the Allow Remote Administration Box.
2. Depending upon your computer's security settings, you may have a User Account Control prompt open. Click Yes.
3. A confirmation prompt should pop up advising that a new network share has been created. Click OK.
4. Another prompt should pop up regarding the creation of another network share. Repeat steps until all three network shares have been created, unless your ClickView Data is stored on a file server or network location (NAS etc.). If your ClickView Data is stored on a file server or network location, click No to this option and move to step 6.
5. Once all network shares have been created, click OK within the ClickView Publisher Service Details window.
6. If you clicked No at step 4 as your data is stored on a network location, please specify the network location that your ClickView data is stored on within the Binary Data UNC Path box. You will need to manually enter the network location within the appropriate text boxes.
7. Make a note of the Database UNC path and Binary Data UNC path's that have been set on your ClickView Publisher installation as these will be required during Step 2 of the installation.
8. Now that the shares for ClickView have been created, go to the servers File Share Management under the Computer Management section or by going to Start and clicking Run and typing 'FSMGMT.MSC'. Click on Shares within the right hand pane. You should see shared folders 'ClickView$' (and ClickViewData$ if your ClickView data is stored on a network drive) share listed. Ensure that the correct permissions are configured on the share permissions & security tab to ensure that the correct user accounts can connect to the network shares that have been created.
9. Run the activation wizard on ClickView Publisher. In ClickView Publisher's main screen, click Help then Activation Wizard. Follow the prompts from the activation wizards to completion.