Jump to: navigation, search

End of Life (EOL)/End of Support (EOS) Process

End of Life and Program Management

The EOL program is managed by Fahiza Hussain in Product Operations. (Up until August 31, 2021, that person is Chris Lee in Program Management handled it.) As part of this process, Fahiza creates an EOL announcement document and sends it to all those included in the EOL - Internal Announcement email alias. The announcement indicates that the item has entered the EOL track and includes such dates as End of Maintenance and End of Support.

Just prior this announcement being sent to customers, the Fahiza adds this EOL item (for example, a product/version or a component/version) to the Genesys EOL Life Cycle Table: Genesys™ Products and Components EOL Life Cycle Table. This online document was set up for Program Management at the end of 2020 for them to maintain/update.


Important
The EOL Life Cycle Table is referenced in three locations: the Systems page (https://all.docs.genesys.com/System), the System Level Guides page (https://docs.genesys.com/Documentation/System), and the Genesys Care/Support Managing Software page (https://docs.genesys.com/Documentation/ST/current/Premise/ManagingSoftware). If the link/reference needs to be updated, be sure to do so in these locations.

Add Notices to product landing pages

Starting in January 2022, writers will add the notices to the landing page or revise the existing per the process described. Previously, Kate handled adding these notices.

Suggest process for tracking, adding or revising notices

As writers take this on, go to your product doc landing pages to see if any or all versions of your product is on the end of life track. If it is, review the date that the product/version reaches end of support and add an appointment in your Outlook calendar to update the notice to reflect that the product reached end of support.

Add the notice when the product/component/version first enters the EOL track

  1. The IX Contact, Monique, will forward you the email from the EOL - Internal Announcement email alias that contains a document identifying that your product/version is entering the EOL track.
  2. Review the document for the dates.
  3. To the respective product landing page, add a Important note using the NoteFormat wiki coding. Use the format in this example:
    Important! Genesys App Automation Platform (GAAP) 3.5 entered End of Life (EOL) on July 31, 2020. It enters End of Maintenance on December 31, 2021, and reaches End of Support on July 31, 2022. If you have questions, contact your account representative.
  4. Comment out the text until the date that the product enters EOL is reached. (Suggestion: You might add a reminder to your Outlook calendar on the EOL date to "uncomment" it out.)
  5. When the EOL date is reached, remove the commenting out coding so that the notice appears.
  6. Alert the sender of the EOL - Internal Announcement email that you've added the notice.

On rare occasions, you may see a Product Technical Advisory that only includes the end of support date. For example, once came in in 2021 for GCXI versions 9.0.009 and below. For that, the wording you use different wording. Use the following example as a model: "As of May 15th, 2021, Genesys is announcing the immediate End of Support of GCXI versions 9.0.009 and below. Genesys recommends current GCXI customers to update to the latest release, version 9.0.019.00. Updates are available via Software Download Center from the My Support portal.

Revise the EOL on your product page when EOS is reached by your product

  1. When the End of Support (EOS) date is reached, revise the notice that you previously added using the format in these examples:
    • Interaction Workspace 8.0 reached End of Support (EOS) on May 31, 2021. It previously entered End of Life (EOL) on May 31, 2019 and End of Maintenance on November 30, 2020. If you have questions, contact your account representative.
    • All versions of Genesys Express reached End of Support (EOS) on November 19, 2019. They previously entered End of Life (EOL) on November 19, 2017, and End of Maintenance on May 19, 2019. If you have questions, contact your account representative.
    • Genesys Voice Platform 7.6 and Genesys Studio 7.6 reached End of Support on May 31, 2021. They previously entered End of Life (EOL) on May 31, 2019 and End of Maintenance on November 30, 2020. If you have questions, contact your account representative.

At this point, do not remove the associated documentation. In working with Chris Doyle in Customer Care, we agreed to keep the documents available for customers on our site for at least 12 months from the date that end of support is reached.

Remove documentation for our docs site

Per guidance from Chris Doyle in Customer Care, the documentation for products/versions that reached end of support should remain available to customers on our site for at least 12 months after the end of support date.

Before starting to remove documentation, confirm that your product/version has met the following criteria:

  • Your product/component/version reached EOS.
  • 12 months has passed since your product/version reached EOS.
  • Ask Monique Gionet, the IX contact, to confirm with Chris Doyle, in Customer Care if it's OK to remove the documents You should also let your Product Manager know about this, as the Product Manager may be aware of a reason not to remove the content.

If these criteria are met, you can remove the content from our docs site. The process for doing so varies with the situation, as described below.

Important
  • Prior to starting to remove content, send an email to Multicloud Writers informing them that you will be removing content in case they have links to any of the content you are removing.
  • Email RN Admins using the Pubs RN Admin email alias when you are preparing to remove content, as one of them will remove the RNs and related files on the Genesys Engage on-premises Release Notes pages.
  • Some content may be a combination of online-content and non-online content.

Remove non-online formatted documents

For documents that are HTML (including HTML Release Notes), PDF, Help (chm for example), and the like, do the following:

  1. Go to the Global IX SharePoint site.
  2. In the Documents folder, go to the Genesys Public folder and navigate to the folder in which your documents are located.
  3. Download any associated non-online documents from Genesys Public.
  4. Upload the same documents to the associated product folder in the EOS Docs folder in Global IX SharePoint. If the folder does not exist in the EOS Docs folder, create it using the same naming convention that exists in Genesys Public.
  5. Delete the files from the Genesys Public folder in Global IX SharePoint that you just added to the EOS Docs folder.
  6. Go back to your product landing pages and remove the text/sections for the documents you removed.
  7. If your documentation included HTML files for Release Notes, Release Advisories, Wizard Advisories, or Deployment Procedures, contact email Pubs RN Admin and ask one of them to remove the coding for the associated HTML files from the Genesys Multicloud on-premises Release Notes page (https://docs.genesys.com/Documentation/RN). For releases 8.5 and earlier, those Pubs RN Admin folks will also go to the Other Resources section on the right of the RN page to get to the RAs WAs, and Deployment Procedures pages, to see if there are any HTML files for the associated product/version that reached EOS and remove them.
  8. Alert someone in Pubs Editors to ask them to move the files from the Public folder in the repository (https://docs.genesys.com/Special:RepositoryUtils) to the respective folder in the endofsupport folder. Writers do not have the rights to do that. If the folder is not created in the endofsupport folder, the Pubs Editor should create it. Then, the Pubs Editor needs to Refresh the Map.

Online documents

Remove one or more online documents for a particular version but not all documents

This process is for the scenario where one or more manuals can be removed for a particular version but other documents for the same version need to be retained.

  1. Check to see in any other document or page links to the document you want to remove. Use the WhatLinks feature on the Special pages to determine that. If any pages link to it outside of the associated product pages, notify the writer of the page impacted to tell them that the content is being removed and that they need to remove the link.
  2. Generate a PDF of the manual(s) that are no longer needed.
  3. Place the PDFs in Global IX SharePoint > EOS Docs > [PRODUCT] > [version]. If the version folder doesn’t exist, create it. If the folder exists, create a folder within it called Online docs.
  4. In your manual, go to Helpful links > Manage [PRODUCT]> Versions.
  5. Add a new version called Archive (unreleased). For example: {{#version:Archive|unreleased}}
    • If more than one version needs to be archived distinctly, create an archive version for each of them.
    • If only the latest released version needs to be archived, generate PDFs of the earlier versions for which you are not creating an online archive version.
  6. For each manual for which you are creating an online archive, publish the entire X.X.X manual to the Archive version, per the usual process (see Publishing Content).
  7. Manually delete all released pages for each EOS document. When you delete each page, add an explanation in the Summary field. For example: “Deleting because the page reached EOS.”

This Archive approach enables us to handle a scenario if we ever need to republish the archived version so that it’s available, since the coding is all there and it’s a simple task or republishing.

Remove an entire version for a product

This process is for the scenario where an entire version of a product reaches EOS and the documentation the documentation removal was approved.

  1. Check to see in any other document or page links to the documents you want to remove. Use https://docs.genesys.com/Special:WhatLinks. If any pages link to it outside of the product pages, notify the writer of the page impacted to tell them that the content is being removed and that they need to remove the link.
  2. Generate a PDF of the manual(s) that are no longer needed.
  3. Place the PDFs in Global IX SharePoint > EOS Docs > [PRODUCT] > [version]. If the version folder doesn’t exist, create it. If the folder exists, create a folder within it called Online docs.
  4. In your manual, go to Helpful links > Manage [PRODUCT]> Versions.
  5. For the version that reached EOS support and can be removed, change “(released)” to "(unreleased)". If you have a preview version for the same EOS version, change that text to unreleased too.
  6. On your product landing page, with the exception of the EOL notice, remove all other text. Unless instructed by your PM, leave the version tab for a little while longer.

When an entire product reaches EOS and can be removed

This process is for the scenario where an entire product (all versions) reaches EOS and the documentation can be removed.

  1. Check to see in any other document or page links to the documents you want to remove. Use https://docs.genesys.com/Special:WhatLinks. If any pages link to it outside of the product pages, notify the writer of the page impacted to tell them that the content is being removed and that they need to remove the link.
  2. Generate a PDF of the manual(s) that are no longer needed.
  3. Place the PDFs in Global IX SharePoint > EOS Docs > [PRODUCT] > [version]. If the version folder doesn’t exist, create it. If the folder exists, create a folder within it called Online docs.
  4. In your manual, go to Helpful links > Manage [PRODUCT]> Versions.
  5. For all versions, change “(released)” to "(unreleased)". If you have a preview versions, change that text to unreleased too.
  6. On the product landing page, delete all content but the EOL notice that you previously revised.
  7. Go to the following page: https://docs.genesys.com/Documentation. Remove the product name from the list.
  8. Under Helpful links > Manage content, click Update quick links in the header, and remove the product name from the section in which it appears.

Videos for products/versions that reached EOS

Videos are already stored in Vimeo, there is no need to archive them elsewhere. Forward any queries regarding videos to the IX Global Video email alias.

End of Platform Support

When a third-party or partner platform reaches End of Support, Fahiza Hussain (or someone from Program Management) will provide an EOPS announcement.

  1. Review the announcement to determine what products are affected. If it’s unclear, check with Fahiza.
  2. Once it’s clear what products are impacted, determine where the notice should appear within the respective documentation.
  3. The writer then adds appropriate wording to their product documentation, with a link to the announcement. For example, see the Apple Notification (deprecated as of March 31, 2021) section of https://docs.genesys.com/Documentation/GMS/8.5.2/API/PushNotificationService. The result may be that the writer will have to add a notice, with a link to the announcement on specific pages.
  4. Separately, for a non-product specific notice:
    • An IX Manager will use standard wording on affected documentation pages, like a landing page and/or the welcome page of a book. Although the exact wording may vary depending on the item reaching end of support, here is an example of wording:
      • As of March 31, 2021, Genesys announced the End of Platform Support for Skype for Business Online. It will reach End of Platform Support on July 31, 2021. This impacts Multimedia Connector for Skype for Business 8.5 and 9.0. If you have questions, contact your account representative.
    • An IX Manager adds the wording on the respective pages, but comments it out, until the date indicated in the announcement.


End of Support and SOE-type information

Until August 31, 2021, Chris Lee manages End of Support for SOE-type information. Previously, it was Sunil Shah. As such, Chris creates the associated announcements and provides them to various folks Ginger Alford (Program Manager) via the EOL - Internal Announcement email alias. From an email on 1/27/20, it seems that Chris places the announcements in Genie and My Support. Ginger, in turn, adds the links to the NewsCenter, CX Insider, and Partner Newsletter so people and presumably customers are notified.

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