Chapter - 3 : Maintaining Your System

This chapter provides information on how to maintain your Oracle Documaker Enterprise Edition (ODEE) implementation.

This chapter describes:

  • Changing the Help Location
  • Downloading Patches
  • Downloading the Documentation
  • Deinstalling the Software

Changing the Help Location

If you want to access the online Help from a location other than the default WebLogic installation, such as on a static content server or via the Oracle Technology Network (OTN), you can modify the online Help configuration as follows:

You can find the various Help files on OTN, on the following Web page:

http://www.oracle.com/technetwork/documentation/insurance-097481.html

Document Factory Dashboard Help

You must define the new location for the Document Factory Dashboard Help content. The Help content is provided with the installation within this file:

documaker\j2ee\weblogic\dashboard\ODDF_Dashboard.ear

Within the Administrator, set the helpLink property to the hosted Help location for the Document Factory Dashboard configuration within the All Assembly Line.

Note:

The configuration within the All Assembly Line applies to the system level applications. Here is the default:

http://servername/ODDF_Dashboard_Help/help.html

Documaker Interactive: Correspondence Help

You must define the new location for the Documaker Interactive: Correspondence Help content. The Help content is provided with the installation within this file:

documaker\j2ee\weblogic\idocumaker_correspondence\idm.ear

Within the Administrator, set the helpLink property to the hosted Help location for the SYSTEM_IDS group in the Correspondence application configuration in the deployed Assembly Line. Here is the default:

http://servername:port/DocumakerCorrespondence/static/help/index.html

Downloading Patches

You can download the latest Oracle software patches at the My Oracle Support website. The process includes:

  • Going to the My Oracle Support site (requires registration)
  • Searching for the patches you want to download
  • Downloading those patches

To download Oracle software patches, go to the My Oracle Support website:

https://support.oracle.com

Downloading the Documentation

You can download the latest Oracle Documaker documentation at the Oracle Technology Network (OTN) web site. The process includes:

  • Going to the applicable page on the OTN site
  • Searching for the documentation you want to download
  • Downloading that documentation

To download Oracle Documaker documentation, go to this page on OTN:

http://www.oracle.com/technetwork/documentation/insurance-097481.html

Deinstalling the Software

You can uninstall your Documaker software before making your selection of products to install or after a successful install. To remove Documaker software, follow these steps:

Step A : Remove ODEE Weblogic Server domain server resources

  1. Shutdown all the ODEE Services (e.g. Docupresentment, Document Factory).

  2. Unlock any WebLogic Server Admin Server Domain locked from user edit sessions.

  3. Run remove_odee_domain_resources.cmd or remove_odee_domain_resources.sh script.

    This process removes:

    • The ODEE WebLogic Server domain server resources (e.g. JMS, DataSources, etc)

    • Web apps (e.g. Documaker Administrator, Documaker Dashboard, Documaker Web Services, Documaker Interactive, etc)

    • Managed servers (jms_server_#, dmkr_server_#, idm_#_server_#, etc)

      Note: ODEE Services will no longer function after completing these steps as they depend on the JMS services but, the domain server components can be redeployed by normal WebLogic Server domain server deployment of the ODEE resources and ODEE Services are restored if needed without full ODEE Services re-installation.

Step B : Stop the following processes

  1. Stop Docupresentment and Supervisor services of ODEE before you start the deinstallation process. If any of the services are running, it may lead to partial deinstallation of ODEE.

  2. Stop all application servers before starting deinstallation process of ODEE.

  3. From the command prompt access setup.exe to start the deinstall process. e.g C:\Oracle\odee_1\oui\bin\setup.exe –deinstall -jreLoc <path_to_jre>.

    Image represents command prompt screen.
    Figure 3.1 - Command prompt screen

    Note: If you run the setup.exe directly from the installed ODEE path, it may leave empty installation directory after deinstallation process. To avoid this, run the setup.exe outside of installation directory.

Begin the deinstallation

  1. Follow the required steps as shown in the Oracle Documaker Enterprise Edition Deinstallation window

    Image represents Deinstallation window
    Figure 3.2 - Deinstallation Window

  2. Open domain-registry.xml under $Middleware_HOME .Remove the corresponding entry referring to idocumaker_domain.

  3. Open nodemanager.domains file under $Middleware_HOME \wlserver_10.3\common\nodemanager\ folder and remove the corresponding entry referring to idocumaker_domain.

  4. Delete the domain folder under domains folder manually. $Middleware_HOME\user_projects\domains\idocumaker_domain

  5. Delete the domain folder under applications folder manually. $Middleware_HOME\user_projects\ applications\idocumaker_domain

  6. After deinstall, manually delete the ODEE folder: C:\oracle\odee_1. The ODEE folder can be deleted as part of de-installation as well but the de-installation has to be invoked from some other folder (other than ODEE).

  7. Drop ODEE admin and assembly line schema from the database.

    Note: Ensure that none of the folder/files within ODEE Home are open while running the deinstall, if open then it will fail to remove the directory.