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} /user /L|language {language code} /g|log {log path} /s|silent /v|custom {options}

  • Parameters
    Parameter Description
    {installer path} The path of the installer executable.
    /user (optional) Specifies that the product will be installed only for the current user. This type of installation doesn't require administrative privileges. If you don't include this parameter, the product will be installed for all users on the machine, which requires administrative privileges.
    /L, /language {language code} (optional) Specifies the language used in the user interface. See theLanguage codes section below for a list of supported languages.
    /g, /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, /silent (optional) Specifies whether or not the user interface is shown.
    /v, /custom {options} (optional) Specifies options to pass to the Msiexec process. See Running the MSI Installer for details.
  • Example

    oracle_content_setup.exe /user /l 1033 /s

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
    Parameter Description
    {installer path} The path of the installer executable.
    /r, /repair  Repairs the product.
    /g, /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, /silent (optional) Specifies whether or not the user interface is shown.
    /v, /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"

Extract the installer MSI and MST

  • Syntax

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

  • Parameters
    Parameter Description
    {installer path} The path of the installer MSI file.
    /e, /extract {destination directory}  Extracts the installer MSI and MST into the given directory.
    /L, /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

Use the installer without a user interface

  • Syntax

    {installer path} /s|silent

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

    oracle_content_setup.exe /silent

Language codes

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.

Install options

Use /i to install the product.

  • Syntax

    msiexec /i {installer path} ALLUSERS=2 MSIINSTALLPERUSER=1 /norestart|promptrestart|forcerestart

  • Parameters
    Parameter Description
    {installer path} The path of the installer executable.
    ALLUSERS=2 MSIINSTALLPERUSER=1 Specifies that the product will be installed only for the current user. This type of installation doesn't require administrative privileges. If you don't include these parameters, the product will be installed for all users on the machine, which requires administrative privileges.
    /norestart Install the product without prompting for a system restart at the end of installation.
    /promptrestart Prompt the user to restart if a restart is required after installation.
    /forcerestart Restart the computer after every installation.
  • Example

    msiexec /i oracle_documents_setup.msi ALLUSERS=2 MSIINSTALLPERUSER=1 /norestart

Upgrade options

Use /i with the path to the latest installer to upgrade the product.

  • Syntax

    msiexec /i {path to latest version}

  • Parameters
    Parameter Description
    {path to latest version} The path to the latest version of the installer executable.
  • Example

    msiexec /i oracle_documents_setup.msi

Uninstall options

Use /x to uninstall the product.

  • Syntax

    msiexec /x {installer path} /norestart|promptrestart|forcerestart

  • Parameters
    Parameter Description
    {installer path} The path of the installer executable.
    /norestart Uninstall the product without prompting for a system restart at the end of installation.
    /promptrestart Prompt the user to restart if a restart is required after uninstall.
    /forcerestart Restart the computer after every uninstall.
  • Example

    msiexec /x oracle_documents_setup.msi /promptrestart

Repair options

Use /f to repair the product.

  • Syntax

    msiexec /f{p|o|e|d|c|a|u|m|s|v} {installer path}

  • Parameters
    Parameter Description
    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 Reinstalls if file is missing or the stored checksum doesn't 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. Doesn't overwrite desktop or favorite shortcuts.
    v Runs the repair from source installer executable and re-caches the local package.
    {installer path} The path of the installer executable.
  • Example

    msiexec /fomus oracle_documents_setup.msi

User interface options

Set the level of user interface displayed during install, uninstall, or repair by using /q with the options below.

  • Syntax

    msiexec /i|x|f {installer path} /q{n|b|r|f}

  • Parameters
    Parameter Description
    {installer path} The path of the installer executable.
    n Displays no user interface.
    b Displays only a progress bar during the process.
    r Displays a reduced user interface with a modal dialog displayed at the end of the process.
    f Displays a full user interface with modal dialog displayed at the end of the process.
  • Example

    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.