This Guide is for Upgrading from 4.6.x.x, or newer to our latest release.

Upgrading Versadial Software

ONLINE CUSTOMER PORTAL RESOURCES

• Customers Infostore (includes software downloads)
• VSLogger Recording (H5) - Reference & FAQ

Portal URL:   https://www.adutante.com/portal/

As a registered customer, you will receive your user Id and password to access the portal. Please contact support if you have lost your login credentials. 

STEP 1 – Backup Recorder Settings and Users

First backup the original server’s settings.

Versadial recommends you create a separate folder to store backed up settings and files. Either a network drive, or on the C drive, such as  C:\Versadial Files\

Adutante Backup Steps:

1. Log into Adutante with administrator access: (default path: https://localhost:8443/portal/)
2. General Administration
1. Tools > Backups
3. click "Schedule Backup"
1. Select "Immediately" > Schedule
2. Back up will begin, depending on the size of your data, this may take a few moments. 
3. Hit browser REFRESH button. Then go back to Tools > Backups 
4. Your backup should now be listed. 
• Note: You may want to copy the backup to a different folder, such as C:\Versadial Files\Adutante 
• Take note of the backup folder location, browse to this location to copy/save in another folder

Adutante Backup Continued:

1. Two files must be manually backed up. 
• Default location is: C:\Versadial\Adutante\applications\adutante\config
2. Copy the following two files to a safe and known location, such as C:\Versadial Files\Adutante 
• adutante.properties - Security, Email, and other settings
• cti.properties - Cisco BIB configurations

VSLogger Settings Backup:

1. Two folders within the VSLogger installation must be manually backed up.
1. Default location: C:\ProgramData\Adutante\vslogger\
2. Copy the contents of  VSLogger *data* and *cert* folder to a safe and known location, such as C:\Versadial Files\Vslogger
1. Note: "Cert" folder will only be available if you previously created your own SSL certificate. 

STEP 2 – Download and Install

1. Go to: https://www.adutante.com/portal/infoshare.htm?static&storeid=10131&pageid=Main:DOWNLOADS_ALL:en_US
• The login ID/password should have been sent to you. If you need it changed, please let us know.
• Download “Versadial Software Distribution”…
• And (if not already installed from a prior 4.7 version)
• Microsoft Visual C++ 2010 SP1 Redistributable Package (x86) https://www.microsoft.com/en-us/download/details.aspx?id=8328
2. Stop the following services (Control Panel/Administrative Tools/Services):
• Adutante
• Versadial VSLogger Connection Service
• Versadial VSLogger Recording Service
3. Once services are properly Stopped. Un-install Adutante and VSLogger. The software can be uninstalled via Windows standard Add/Remove programs in the Control Panel.
• During uninstall, you may accept all defaults.
• Do not manually delete Adutante or VSLogger's folders
• RENAME the Adutante folder - By renaming, you preserve your old data, during the installation of the software, Adutante will create and install a new folder, if you fail to rename the Adutante folder, you risk your old data being written over. Default Adutante folder: C:\Versadial\Adutante - Rename to Adutante.bak. The VSLogger installation folder does not need to be renamed
• Note: The Windows un-install DOES NOT remove your settings or recordings. These are retained in the Adutante and VSLogger folders. 
4. Refresh the services to check if they were removed successfully. If Adutante and Versadial VSLogger services are no longer displayed in the Services window, proceed to the next step. If the services are still displayed but showing "disabled" – reboot Windows. After reboot, the Adutante and VSLogger services should no longer be present. 
5. After successful uninstall of Adutante and VSLogger, install in this order, accepting defaults:
• If Applicable: Microsoft Visual C++ 2010 SP1 Redistributable Package (x86) - vcredist_x86.exe (Downloaded in the step above)
• Adutante Installation: (where you downloaded saved file)\software\Adutante\ Adutante-1.7.0.0-Setup.exe
• *** Start the service when prompted *** 
• VSLogger Installation: (where you downloaded saved file)\software\vslogger-unlimited\vsl4702-setup.msi

STEP 3 – Restore Users and Data From Your Backup in Step 1

1. Time to restore your settings for VSLogger and Adutante (usernames, passwords, and other settings). 
2. Log into Adutante as administrator (default login admin/adutante (after initial login, you will be prompted to change password): https://localhost:8443/portal/ 
1. General Administration > Tools > Backups
2. The backup created in Step 1 should be listed 
3. Select "Restore" button next to the specific backup. 
1. If your backup is not listed: 
1. Go to where you manually copied and saved the backup file in Step 1 (example C:\Versadial Files\Adutante)
2. Copy the file and save to: C:\Versadial\adutantedata\backups\  (This is the default backup folder location, if you changed the default of your Adutante installation please adjust accordingly)
3. Refresh Adutante using the browser refresh, your backup should now be listed under Tools > Backups. Follow the above steps to restore.  

Manually copied files from Step 1 (Adutante Backup Continued and the VSLogger Backup Setting section):

1. If required, you may copy and save the previously manually copied files back to their original file location.
• Note: This step is typically not required, but if you notice some default settings not present after your Restore the backup, you may need to restore the manually saved files and folders as well. 

STEP 4 – Reactivate VSLogger License

1. Reactivate License in VSLogger: Use the Web UI to verify installation and services are running: https://localhost:22443/vslogger  
• Log in to VSLogger. (default login if not restored yet: admin/admin (check Sign in as local CLI Administrator.) )
• Go to Setup > License to enter and re-activate software license for the new version
• If software license code is used, add your license key: XXXX-XXXXX-XXXX (if upgrading from  4.7.XX to a newer version. the license code is probably already in place.)
• If HW key is used (reintroduced  since version  4.8.1.0), make sure license code and licenses are recognized
• Note: Click the blue ACTIVATE PROGRAM button located middle of the page (you must read and agree to license to activate)
• On license re-activation, connection and recording services will reload. Make sure to Refresh the web browser to update UI (may take a few minutes).
• Log back in to Verify license is active. 

STEP 5 – Proceed to Re-Register the Recorder to Adutante (Required):

1. Login into Adutante (if not already logged in): https://localhost:8443/portal/ 
2. Use the dropdown menu on the right, and go to Recorders Administration.
3. Click the Recorders tab, and then the red ‘Unregister’ button.
1. Important: Take note of the Recorder’s Name as you will use it as the ID in VSLogger to re-register.
4. After the recorder is Unregistered, there are two options to Re-register and connect VSlogger to Adutante. Our Web UI, or via CLI. See appropriate instructions below for method you are most comfortable with. You DO NOT need to follow both options to re-register VSLogger.
5. Option 1: Web UI
• Log back into VSLogger: https://localhost:22443/vslogger 
• Go to Setup > Adutante
• Click REGISTER
• Input Host path (default: https://localhost:8443) and Provider ID (Name of Your Recorder)
• Click Register (Connection and services will be restarted. Wait a few minutes and refresh to log back in)
• Log in - go to Setup > Adutante to verify status is Connected
6. Option 2: CLI
• Open CLI, and log in. (default location: C:\Program Files (x86)\Versadial Solutions\vsLogger\vscli.exe)
• File > Connect
• Here is the exact command sequence to register: (*Typed commands are preceded by ->)
• login>
• ->u admin p admin
• Welcome to VSLogger .... Today is: (Current date / time)
• ***Information about your VSLogger***
• cli>
• ->config adutante
• cli>(config-adutante)
• ->register host https://localhost:8443 id vslogger
• (where vslogger is your ID as noted prior)
• Registring...
• server is busy, wait...
• Provider successfully registered.
• Saving settings...
• Reloading...
• Stopping Connection service ...
7. Wait a few minutes, services will be restarted and VSLogger/Adutante will be re-registered. Logger Started
8. Close CLI and log back into VSLogger to verify connection was made: Setup > Adutante

Optional - STEP 6 – Re-Apply Your SSL Cert

(If SSL certificate had been created.)

1. Open: C:\ProgramData\Adutante\vslogger\cert
2. Copy:
1. adutante.jks
3. Paste the file here (overwrite):
1. C:\Versadial\Adutante\framework\base\config
4. Restart the service:
1. Adutante