Login
Home CMS Documentation Home CMS 10 DITA Processing Pipeline Authoring and Editing DITA Content Oxygen Desktop Plugin Oxygen Desktop Plugin Installation and Updates CMS 10.6 Oxygen Desktop Plugin Installation MacOS: Installing CMS 10.6 Oxygen Web Launcher

MacOS: Installing CMS 10.6 Oxygen Desktop Plugin Web Launcher

Prerequisites:
  • Users must have a MacOS 12+ machine.
  • The Oxygen Desktop Plugin must be installed in the Oxygen XML Editor desktop application via the Ingeniux CMS Connector add-on. See Installing CMS 10.6 Connector Add-on for details.
  • Users with DITA configuration permissions must enable the web launcher feature for content contributors.

    Navigate to Administration > DITA > Setup, and select the Allow invoking Oxygen Desktop XML Author for DITA editing checkbox in the DITA Advanced Options area.

    Note
    When this setting is selected, the CMS generates an OAuth Identity named _oxygen_exclusive_admin. The system uses the OAuth identity credentials to connect users to the Oxygen Desktop Plugin when they execute Web Launcher.

    See OAuth Identities for details about using OAuth identities in the CMS.

  • Ensure that Oxygen XML Editor is not currently running. Close the application.

Set up the web launcher tool for MacOS to streamline the process of accessing and editing DITA in the Oxygen Desktop Plugin. After setup, the Edit in Oxygen button becomes available in the CMS. Users can select this button to directly open DITA content in the Oxygen Desktop Plugin from the CMS.

To install CMS 10.6 Oxygen Desktop Plugin Web Launcher for MacOS:
  1. Complete the following steps to download the OxygenWebLauncher_Mac.dmg.
    1. Navigate to Assets > Assets Tree.
    2. Select any DITA item in the tree to display the item's Overview tab.
    3. Select the gear icon on the Edit in Oxygen button, and select the Download Installer icon that displays.

      Download Web Launcher Installer

    OxygenWebLauncher_Mac.dmg downloads to your machine.
  2. Run OxygenWebLauncher_Mac.dmg, and move the file to the Applications folder in the dialog that displays.
    Important
    The Oxygen Desktop Plugin requires the Web Launcher folder to reside directly under the Applications folder.

    Drag to Applications Folder

  3. Close the dialog, and open OxygenWebLauncher_Mac in the Applications folder via Finder.
    Warning
    Do not delete OxygenWebLauncher_Mac.dmg. Without this file, the system will not maintain your Web Launcher registration settings. If you delete the file, then repeat the Web Launcher installation steps again.
  4. Select Open in the confirmation dialog.
    The Ingeniux Oxygen Web Launcher application displays.

  5. Complete the following fields.
    FieldDescription
    Select Oxygen LocationSelect the Oxygen XML Editor installation location from the drop-down list. This setting determines where the web launcher will execute.
    Select ModeSelect a mode option from the drop-down list. This setting determines the mode that the web launcher will use.
    Note
    Mode availability varies, depending on the installation location you chose. If you chose an Oxygen XML Editor location, then all modes listed below become available for selection.
    • Author. When web launcher executes, the system opens the DITA content in the Oxygen XML Author desktop application.
    • Developer. When web launcher executes, the system opens the DITA content in the Oxygen XML Developer desktop application.
    • Editor. When web launcher executes, the system opens the DITA content in the Oxygen XML Editor desktop application.
  6. Select Confirm and Perform Registration.
    A message displays to confirm completion of the web launcher registration.
  7. Select OK.
    The Ingeniux Oxygen Web Launcher application and confirmation message close.
  8. Restart the Oxygen XML Editor twice to ensure the system copied the Web Launcher application to the correct location.

Next Steps: Run the Oxygen Desktop Web Launcher to automatically connect the CMS to the plugin and open DITA content directly in Oxygen XML Editor.