Deploy the Desktop App

Individual users can download the desktop app through the web browser and install it on their machines. However, some enterprise environments may not allow users to install their own software. In those cases, you can roll out the desktop app to multiple client machines with the help of the EXE and MSI installer packages.

Run the Executable Installer from the Command Line

You can run the .exe installer from the command line with parameters on a local machine to perform a number of installation tasks. This might be useful when automating some of the installation process.

Install or upgrade the software

All options following the custom option will be passed to Msiexec.

  • Syntax:

    {installer path} /d|directory {product directory} /L|language /g|log {log path} /s|silent /v|custom {options}

  • Parameters

    • {installer path} - The path of an installer executable.
    • /d or /directory {product directory} (optional) - Specifies the directory into which the product will be placed.
    • /L or /language {language code} (optional) - Specifies the language used in the user interface. See the Language Codes section below for a list of supported languages.
    • /g or /log {log path} (optional) - Specifies that a log should be created detailing the actions undertaken by the installer and written into the given file path.
    • /s or /silent (optional) - Specifies whether or not the user interface is shown. 
    • /v or /custom {options} (optional) - Specifies options to pass to the Msiexec process. See Running the MSI Installer for details.
  • Example

    oracle_content_setup.exe /directory "C:\Oracle\Oracle Documents" 

Repair the software

The language used during repair will be the language used to install the product. All options following the custom option will be passed to Msiexec.

  • Syntax

    {installer path} /r|repair /g|log {log path} /s|silent /v|custom {options}

  • Parameters

    • {installer path} - The path of an installer MSI file.
    • /r or /repair - Repairs the product.
    • /g or /log {log path} (optional) - Specifies that a log should be created detailing the actions undertaken by the installer and written into the given file path.
    • /s or /silent (optional) - Specifies whether or not the user interface is shown.
    • /v or /custom {options} (optional) - Specifies options to pass to the Msiexec process. See Running the MSI Installer for details.
  • Example

    oracle_content_setup.exe /repair /log "C:\logs\oracle documents.txt"

To extract the installer MSI and MST

  • Syntax

    {installer path} /e|extract {destination directory} /L|language {language code} 

  • Parameters

    • {installer path} - The path of an installer MSI file.
    • /e or /extract {destination directory} - Extracts the installer MSI and MST into the given directory.
    • /L or /language {language code}  (optional) - Specifies the language of the strings contained in the extracted MST. See the Language Codes section below for a list of supported languages.
  • Example

    oracle_content_setup.exe /extract C:\Users\blair\desktop

To use the installer without a user interface

  • Syntax

    {installer path} /s|silent

  • Parameters

    • {installer path} - The path of an installer executable.
    • /s or /silent  (optional) - Specifies whether or not the user interface is shown.
  • Example

    oracle_content_setup.exe /silent

Language Codes

  • 1025: Arabic
  • 1029: Czech
  • 1030: Danish
  • 1031: German
  • 1032: Greek
  • 1033: English
  • 1034: Spanish
  • 1035: Finnish
  • 1036: French (France)
  • 3084: French (Canada)
  • 1037: Hebrew
  • 1038: Hungarian
  • 1040: Italian
  • 1041: Japanese
  • 1042: Korean
  • 1043: Dutch
  • 1044: Norwegian
  • 1045: Polish
  • 1046: Portuguese (Brazil)
  • 2070: Portuguese (Portugal)
  • 1048: Romanian
  • 1049: Russian
  • 1051: Slovak
  • 1053: Swedish
  • 1054: Thai
  • 1055: Turkish
  • 2052: Chinese (China)
  • 1028: Chinese (Taiwan)

Run the MSI Installer

Use this command to extract the MSI package from the .exe installer to a given location:

oracle_content_setup.exe /extract c:\directory

The following MSI options are supported by the Oracle Content Management MSI package.

Option Parameter Meaning Example
/i   Install the product.
  • Use the /norestart parameter to install the product without prompting for a system restart at the end of installation.
  • Use the /promptrestart parameter to prompt the user to restart if a restart is required.
  • Use the /forcerestart parameter to restart the computer after every installation.
msiexec /i oracle_documents_setup.msi

msiexec /i oracle_documents_setup.msi /norestart

msiexec /i oracle_documents_setup.msi /promptrestart

msiexec /i oracle_documents_setup.msi /forcerestart

/i {path to latest version} Upgrade the product to the latest version. msiexec /i oracle_documents_setup.msi
/i CUSTOM_INSTALLDIR={path to custom directory Install the product in a non-default (custom) location. msiexec oracle_documents_setup.msi CUSTOM_INSTALLDIR=”c:\example”
/x   Uninstall the product.
  • Use the /norestart parameter to uninstall the product without prompting for a system restart at the end of removal.
  • Use the /promptrestart parameter to prompt the user to restart if a restart is required.
  • Use the /forcerestart parameter to restart the computer.
msiexec /x oracle_documents_setup.msi

msiexec /x oracle_documents_setup.msi /norestart

msiexec /x oracle_documents_setup.msi /promptrestart

msiexec /x oracle_documents_setup.msi /forcerestart

/f {p|o|e|d|c|a|u|m|s|v}   Repair the product.
  • p: reinstalls only if file is missing
  • o: reinstalls if file is missing or if an older version is installed
  • e: reinstalls if file is missing or an equal or older version is installed
  • d: reinstalls if file is missing or a different version is installed
  • c: installs if file is missing or the stored checksum does not match the calculated value
  • a: forces all files to be reinstalled
  • u: rewrites all required user-specific registry entries
  • m: rewrites all required computer-specific registry entries
  • s: overwrites the start menu shortcuts. Does not overwrite desktop or favorite shortcuts.
msiexec /fomus oracle_documents_setup.msi

msiexec /fpecms oracle _documents_setup.msi

/i|x|f /q{n|b|r|f}    Set the level of user interface displayed on installation, uninstallation or repairing the product by using /q with one of these options:

  • n: Displays no user interface.
  • b: Displays only a progress bar during install.
  • r: Displays a reduced user interface with a modal dialog displayed at the end of the installation
  • f: Displays a full user interface with modal dialog displayed at the end
msiexec /i oracle_documents_setup.msi /qn

Deploy the MSI Installer Through Active Directory’s Group Policy

You can use Microsoft Active Directory 2008 group policy to distribute the desktop app to computers.

  1. From the Start menu, select Control Panel, then Administrative Tools.

  2. Click Active Directory Users and Computers. Create an organization unit that includes all the computers where you want to install Oracle Content Management.

  3. From the Start menu, select Control Panel, then Administrative Tools then Group Policy Management Console.

  4. In the console tree, right-click Group Policy Objects in the forest and domain in which you want to create a group policy object.

  5. Click New. Specify the name of the new group policy in the dialog box and click OK.

  6. Select the newly created object and select Edit to open the Group Policy Management Editor.

  7. Select and expand the Computer Configuration node.

  8. Expand the Software Settings folder under the Computer Configuration node.

  9. Right-click Software Installation and select New.

  10. From the Shortcut menu, click Package.

  11. Enter the path to the extracted MSI package. Ensure that the path is a UNC path and is accessible to all machines that the group policy is targeting.

  12. Selected Assigned and click OK.

  13. In the Properties dialog box, click OK.

  14. Exit the Active Directory Users and Computers console.

Set Installation Defaults

The following registry entries can be set by an administrator on a machine where the desktop app is installed:

  • Default server URL: [HKEY_CURRENT_USER\Software\Oracle\Oracle Documents\Account] “DefaultServer”=”server_URL. Users can override the default server URL by adding a different server in their preferences.

  • Set the default server URL for users of a particular machine: [HKEY_LOCAL_MACHINE\Software\Oracle\Oracle Documents\Account] "DefaultServer"=”server_URL

  • Block upgrade prompts: [HKEY_CURRENT_USER\Software\Oracle\Oracle Documents\Update] "SuppressDisplay"="true"

  • Block upgrade prompts for all users of a particular machine: [HKEY_LOCAL_MACHINE\Software\Oracle\Oracle Documents\Update] "SuppressDisplay"="true"

The HKEY_CURRENT_USER setting takes precedence over the HKEY_LOCAL_MACHINE setting.