Updating Oxygen Web Service


  • System administrators must the install the Oxygen Web Service for the Ingeniux CMS site instance.
  • System administrators must have access to the latest OxygenWebService_[version-number].zip file compatible with your CMS version. Contact Ingeniux Support to obtain the .zip file. See CMS Statistics to check the version.
    • CMS 10.6.492 requires OxygenWebService_1.6.9.zip.

    • CMS 10.6.378 requires OxygenWebService_1.6.6.zip.
    • CMS 10.6.342 requires OxygenWebService_1.6.5.zip.
    • CMS 10.6.308 requires OxygenWebService_1.5.68.zip.
New Oxygen Web Service updates become available over time for the Oxygen Desktop Plugin. To update the service, replace all existing OxygenWebService folder contents with the target update package contents while preserving your existing Web.config settings.
To update the Oxygen Web Service:
  1. Stop the CMS instance application pool:
    1. Open Internet Information Services Manager (IIS) and navigate to the CMS instance application pool.
    2. Right-click the application pool and select Stop.
      The CMS instance stops running.
  2. Back up your existing Web.config file from [Drive:]\[path-to-cms-site-instance]\App_Data\xml\Custom\OxygenWebService\ to preserve your current settings.
    Note
    You will merge your existing settings with the updated Web.config file in a later step.
  3. Delete all contents from the existing [Drive:]\[path-to-cms-site-instance]\App_Data\xml\Custom\OxygenWebService\ folder.
    Important
    Remove all files and subfolders from the OxygenWebService directory before extracting the new package contents.
  4. Extract all contents from the target OxygenWebService_[version-number].zip package to the [Drive:]\[path-to-cms-site-instance]\App_Data\xml\Custom\OxygenWebService\ folder.
    The updated Oxygen Web Service files populate the OxygenWebService folder, including a new Web.config file.
  5. Merge your backed-up Web.config settings with the new Web.config file to preserve your existing configuration:
    Tip
    Compare the backed-up file with the new file to identify which settings need to be transferred. Key settings typically include user credentials, folder IDs, and custom configuration values.
    1. Open both the backed-up Web.config and the new Web.config in a text editor.
    2. Compare and copy your custom settings from the backed-up file to the corresponding locations in the new file.
    3. Save the updated Web.config file.
  6. Start the CMS instance application pool:
    1. Open Internet Information Services Manager (IIS) and navigate to the CMS instance's application pool.
    2. Right-click the application pool and select Start.
      The CMS instance starts running.

Next Steps: Install subsequent Ingeniux CMS Connector add-on updates when they become available.