Jump to: navigation, search
(→‎Migrating from 8.5.200.18 or later to the current version)
Line 1: Line 1:
−
= Migrating your Installation Package (IP)=
+
= Upgrading your Installation Package (IP)=
  
−
If you have [[MigPreparation|prepared for your migration]], you can now migrate the Web Services and Application IP. Use the instructions that are specific to the version from which you migrating:
+
This article provides instructions on how to upgrade Web Services from a specific version up to currently available version and describes the steps that should be performed on each node where Web Services are run. The order in which you upgrade Web Services nodes doesn’t matter; you can upgrade all nodes simultaneously or one at a time.
  
−
* [[MigMigrateIPProc#Mig_09|Migrating from 8.5.200.09 to the current version]]
+
During a migration, we strongly recommend to avoid changes in configuration files if it’s not required for the migration procedure. Configuration changes can be a cause of failure. In the event of a failure, you will need to rollback to previous version instead of  rolling back only the changed options. Thus,  changing of customizations should only be performed after verification that the migration to new version completed successfully.
−
* [[MigMigrateIPProc#Mig_18_29_41|Migrating from 8.5.200.18 or later to the current version]]
 
  
 +
{{NoteFormat|
 +
*Since version 8.5.201.29, the Genesys Interaction Recording (GIR) API was discontinued by Web Services and Applications. Thus if you are about migrating to a 8.5.201.29+ version, you have to install separate GIR nodes according to <please insert the link to GIR documentation here>
 +
* Version 8.5.201.41 supports Cassandra 2.2 database; thus, you have the option to migrate to new Cassandra according to steps are described in [[Documentation:HTCC:Dep:UpgradingCassandraTo2x|Upgrading Cassandra to 2.2]]. This is not a mandatory step, so you can maintain the Cassandra 1.2 cluster with latest version of Web Services and Applications. If you decidd to upgrade Cassandra cluster, we recommend to perform this operation separately from the Web Services and Applications migration; not at the same time.
 +
}}
  
 
{{AnchorDiv|Mig_09}}
 
{{AnchorDiv|Mig_09}}
−
==Migrating from 8.5.200.09 to the current version==
+
==Migrating from 8.5.200.09 to 8.5.201.50==
−
 
 
−
Migrating from 8.5.200.09 has special considerations, because it includes a transition from standalone Jetty to embedded Jetty.  
 
  
 
'''Start'''
 
'''Start'''
−
<ol>
 
−
<li>Stop Jetty on all the Web Services nodes.</li>
 
−
<li>[[MigThirdParty#MigrateCassandra|Migrate Cassandra]].
 
−
<li>For each Web Services node, complete the following steps:
 
−
<ol type="a">
 
−
<li>Complete the [[MigThirdParty#EmbeddedJetty|How do upgrade from standalone to embedded Jetty?]] procedure.</li>
 
−
{{NoteFormat|Make a backup of your configuration folder ('''$JETTY_HOME/genconfig''') to use as a reference for setting configuration options.|2}}
 
−
<li>Review [[Documentation:HTCC:Dep:ConfigurationPremise|Configuring Web Services]] and its sub-topics.</li>
 
−
<li>Set the options required for your deployment.
 
−
<br/>
 
−
The following configuration options have been modified in the '''$JETTY_HOME/genconfig/server-settings.yaml''' file in 8.5.200.50:
 
  
−
{|
+
# Install Java 8 on the note accoring to Migrating from Java 7 to Java 8.
−
! '''Option'''
+
# Migrate from standalone to embedded Jetty.
−
! '''Type of Change'''
+
# [[Documentation:HTCC:Dep:DeployWebApp|Deploy the new version of Web Services]].
−
|-
 
−
| activationTimeout
 
−
| The default value changed from <tt>1000</tt> to <tt>12000</tt>.
 
−
|-
 
−
| connectionTimeout
 
−
| The default value changed from <tt>400</tt> to <tt>4000</tt>.
 
−
|-
 
−
| cmeAuthenticationEnabled
 
−
| Removed
 
−
|}
 
−
</li>
 
−
<!--<li>If you have a custom <tt>feature-definitions.json</tt> file, review the [[FeatureConfiguration|Feature Configuration]] and add the new features for 8.5.1:
 
  
−
{|
 
−
! '''id'''
 
−
! '''displayName'''
 
−
! '''description'''
 
−
! '''autoAssignOnContactCenterCreate'''
 
−
|-
 
−
| api-voice-recording
 
−
| Voice API Recording
 
−
| API for Voice Recording
 
−
| false
 
−
|-
 
−
| api-supervisor-agent-control
 
−
| API Supervisor Agent Control
 
−
| API For Supervisors to Control Agent State
 
−
| false
 
−
|-
 
−
| api-supervisor-monitoring
 
−
| API Supervisor Monitoring
 
−
| API For Supervisors to Monitor Agents
 
−
| false
 
−
|-
 
−
| api-mobile-push-notifications
 
−
| Mobile Push Notifications API
 
−
| API for Mobile push notification support
 
−
| false
 
−
|-
 
−
| ui-supervisor-add-user
 
−
| UI Supervisor Add User
 
−
| UI For Supervisors to Create Users
 
−
| false
 
−
|-
 
−
| ui-supervisor-edit-user
 
−
| UI Supervisor Edit User
 
−
| UI For Supervisors to Edit Users
 
−
| true
 
−
|}
 
−
{{NoteFormat|These new features must be added to the <tt>feature-definitions.json</tt> file in order for Web Services to work correctly.}}-->
 
−
</li>
 
−
<li>Complete the [[Documentation:HTCC:Dep:StartHTCC|Starting and Testing]] procedure.
 
−
</ol>
 
−
</li>
 
−
</ol>
 
 
'''End'''
 
'''End'''
  
−
{{AnchorDiv|Mig_18_29_41}}
+
{{AnchorDiv|Mig_18}}
−
==Migrating from 8.5.200.18 or later to the current version==
+
==Migrating from 8.5.200.18 to 8.5.201.50==
 +
 
 +
'''Start'''
 +
 
 +
# Install Java 8 on the note accoring to Migrating from Java 7 to Java 8.
 +
# [[Documentation:HTCC:Dep:DeployWebApp|Deploy the new version of Web Services]].
  
−
Use this procedure to migrate from 8.5.200.18 or later to the current version.
+
'''End'''
  
−
{{NoteFormat|If you are currently using 8.5.200.09, you need to follow the [[MigMigrateIPProc#Mig_09|Migrating from 8.5.200.09]] procedure because the migration includes a transition from standalone Jetty to embedded Jetty.  
+
{{AnchorDiv|Mig_18_29+}}
−
}}
+
==Migrating from 8.5.201.29+ to 8.5.201.50==
  
 
'''Start'''
 
'''Start'''
  
−
# {{Editgrn_open}}Stop GWS on all nodes.{{Editgrn_close}}
+
# [[Documentation:HTCC:Dep:DeployWebApp|Deploy the new version of Web Services]].
−
# [[MigThirdParty#MigrateCassandra|Migrate Cassandra]].
 
−
# Update the contents of the GWS package, see [[Documentation:HTCC:Dep:DeployWebApp|Deploy the new version of Web Services]].
 
−
# {{Editgrn_open}}Start GWS on all nodes.{{Editgrn_close}}
 
  
 
'''End'''
 
'''End'''
 +
  
  
 
[[Category:V:HTCC:8.5.2DRAFT]]
 
[[Category:V:HTCC:8.5.2DRAFT]]

Revision as of 19:39, December 15, 2016

Upgrading your Installation Package (IP)

This article provides instructions on how to upgrade Web Services from a specific version up to currently available version and describes the steps that should be performed on each node where Web Services are run. The order in which you upgrade Web Services nodes doesn’t matter; you can upgrade all nodes simultaneously or one at a time.

During a migration, we strongly recommend to avoid changes in configuration files if it’s not required for the migration procedure. Configuration changes can be a cause of failure. In the event of a failure, you will need to rollback to previous version instead of rolling back only the changed options. Thus, changing of customizations should only be performed after verification that the migration to new version completed successfully.

Important
  • Since version 8.5.201.29, the Genesys Interaction Recording (GIR) API was discontinued by Web Services and Applications. Thus if you are about migrating to a 8.5.201.29+ version, you have to install separate GIR nodes according to <please insert the link to GIR documentation here>
  • Version 8.5.201.41 supports Cassandra 2.2 database; thus, you have the option to migrate to new Cassandra according to steps are described in Upgrading Cassandra to 2.2. This is not a mandatory step, so you can maintain the Cassandra 1.2 cluster with latest version of Web Services and Applications. If you decidd to upgrade Cassandra cluster, we recommend to perform this operation separately from the Web Services and Applications migration; not at the same time.

Migrating from 8.5.200.09 to 8.5.201.50

Start

  1. Install Java 8 on the note accoring to Migrating from Java 7 to Java 8.
  2. Migrate from standalone to embedded Jetty.
  3. Deploy the new version of Web Services.

End

Migrating from 8.5.200.18 to 8.5.201.50

Start

  1. Install Java 8 on the note accoring to Migrating from Java 7 to Java 8.
  2. Deploy the new version of Web Services.

End

Migrating from 8.5.201.29+ to 8.5.201.50

Start

  1. Deploy the new version of Web Services.

End

Comments or questions about this documentation? Contact us for support!