Stage - 2 : Running Setup


In this stage, you run the setup application to install Documaker Enterprise. You will be prompted to enter the information listed on the previous topic.

During the initial installation, the system identifies the Oracle home directory. This directory is the location where Documaker Enterprise will be installed.

Note:

During the installation process:

You are prompted to enter various required values. If you need help completing these values, contact the appropriate system administrator.

A set of sample resources will be provided. These resources let you access the sample Correspondence master resource library (MRL) and validate your configuration.

Follow these steps to run the setup application:

  1. From the installation package, copy the ZIP file to the application server. Then unzip it.

  2. Go to the disk1 directory and enter this command: ./runInstaller

  3. The Welcome screen appears. Click Next.

  4. In the Specify Inventory directory and on the Credentials window enter:

    • The full path of the inventory directory. Here is the default:

      /home/username/orainventory

      This directory houses installer files for all installs created by the Oracle Universal Installer (OUI).

      Choose a shared oracle group and choose the shared location for inventory directory and credentials. If you are creating a directory, update the permissions to include the new oracle installer group.

    • Specify the Operating System group name. The default is the current user GROUP name.

    Note: This window appears if no other Oracle-based installer using (OUI) has been installed on this application tier.

  5. On the Specify Home Details window enter the name of the Oracle Home environment variable. The default is DocumakerHome1. For more information, click the Help button. Then enter the complete installation path. Click Browse to select an installation directory. The default is /home/user name/oracle/odee_1.

  6. Click Next to continue.

  7. In the Specify Administrator Group and User window, enter:

    Field Description
    Group Enter the group name. This provides the installation user with control over initial Administration group and Administration user
    User Enter the user name for the Administrator Group.
    Password Enter the password for the Administrator Group.
    Confirm Password Re-enter password to confirm.
  8. On the Specify Database Type window, indicate the database you will use. Select

    • Oracle

    • SQL Server

    • DB2 LUW

  9. On the Database Information window, enter:

    Field For an Oracle database For a DB2 database For SQL Server
    Host The host name or static IP address of the database server. The default is the computer where the installation is running from. The host name or static IP address of the database server. The default is the computer where the installation is running from. The host name or static IP address of the database server. The default is the computer where the installation is running from.
    Port The port number of the database; the default is 1521. The port number of the database; the default is 50000 The port number of database; the default port is 1433.
    Database Oracle Database Name of the database to which ODEE will be connected; the default is IDMAKER Name of the database to which ODEE will be connected; the default is IDMAKER
    Advanced Compression True* Enter False if you don't have a valid license for use. na na

    Note: * The scripts enable advanced compression on certain database columns. If you do not have an Advanced Compression Options license for Oracle 11g, please remove the COMPRESS DEDUPLICATE and COMPRESS HIGH DEDUPLICATE attributes from the scripts in dmkr_asline.sql.

  10. The Administration Database Schema window contains settings for the schema where the configuration tables are stored. In this window, enter

    Field Description
    DB Index Folder The database folder where the physical database index files will be created. Note: This is applicable only for SQL server DB.
    DB Folder The database folder location where the physical database files will be created. If blank, the database folder (directory) is created in the working directory of the database installation. For an Oracle database, this is honored. For a DB2 LUW database, this is only honored if you uncomment the dmkr_admin schema portion and create database section to reference another DB Folder location or enable this setting when the DBA creates the database in DB2.
    User Enter the schema user name. The application will use to connect to the database for the administration layer. The default is dmkr_admin. In case of DB2 database, the username should be less than 8 characters.
    Password The password for the user name the application will use to connect to the database. The default is Admin12.
    Confirm Password Re-enter the password to confirm.
    System ID A unique system ID for this Document Factory instance. If other Document Factory instances (not Assembly Lines) are installed, they also require a unique system ID. For initial installations, accept the default of one (1).
    System Name This is the display name for the Document Factory instance within the Documaker Administrator. The default is System 1.
    Change this name to reflect the Document Factory system in your organization.
  11. Click Next to continue.

  12. The Assembly Line Database Schema window contains settings for the schema where the assembly line processing tables are stored. In this window, make these entries:

    Field Description
    DB Index Folder The database folder where the physical database index files will be created. Note: This is applicable only for SQL server DB.
    DB Folder The location where the physical database files will be created. If you leave this field blank, the database folder is created in the working directory of the database installation.
    User This is the name the application connect to the database. The default is dmkr_asline. In case of DB2 database, the username should be less than 8 characters.
    This user name is also used for the:
    Database schema/owner
    JDBC data source name
    ODBC data source name
    Name applied to the Docupresentment service (docupresentment dmkr_asline)
    Password This is the password for this assembly line database. The default is Asline12. This password is also the Documaker Studio password for the Docucorp user.
    Confirm Password Re-enter the password to confirm.
    Assembly Line ID This is the ID for this Assembly Line. If other assembly lines are installed, they require a unique Assembly Line ID.
    For initial installations, accept the default of one (1).
    Assembly Line Name The display name for the Assembly Line instance within the Documaker Administrator. The default is Assembly Line 1. Change this name to reflect the name of the assembly line in your organization.

    When you finish, click Next to continue.

  13. On the Specify Application Server Type window, choose the application server you will use. Select:

    • WebLogic Server 12.2.1.2.0

  14. Enter the user value for the web application server that is associated with the domain.

  15. The JMS Setup window contains the JMS values. If you need help with these values, contact your administrator. In this window, make these entries:

    Field Description
      Weblogic
    Connection Class The name of the Java class used to connect to the JMS queues. Always accept this default:
    oracle.documaker.ids.WebLogicJMSConnection
    InitialContextFactory A Java class used when connecting to the JMS queues. Always accept this default:
    weblogic.jndi.WLInitialContextFactory
    Provider URL The URL used to connect to the JMS queues. Default value is: t3://servername:11001. Update the servername but leave the protocol and port as defaulted.
    Principal The user name required to start the logical server instances. Enter weblogic for WebLogic.
    Credentials The password for the JMS Principal. Enter a password and use the same while creating the domain.
    Confirm Credentials Re-enter credentials to confirm.

    When you finish, click Next to continue.

  16. On the Hot Folder window, enter the HotFolder path. This path can include more than one directory, each separated by a comma.

    This Hot Folder path applies to the Assembly Line in the previous window. The default is:

    [Install_Root]/documaker/hotdirectory

    Note: This directory is monitored for jobs that are waiting to be processed.

    Click Next to continue.

  17. On the optional SMTP Email Server window, make these entries:

    Field Description
    SMTP Host Enter the IP address or server name of the SMTP server.
    SMTP Port Enter the port number of the SMTP server.
    SMTP User Enter the user name for the SMTP server.
    SMTP Password Enter the password for the SMTP server.
    Confirm Password Re-enter the password to confirm.
    SMTP Sender Enter the email address the SMTP server uses as the sender for any email publication from the Documaker Document Factory. The default is admin@docfactory.com.

    When you finish, click Next to continue.

  18. In the Optional WebCenter Information window, enter the Universal Content Management settings:

    Field Description
    Use WebCenter Select True to enable documents to be archived to WebCenter. The default is False.
    WebCenter User Enter the WebCenter user name.
    WebCenter Password Enter the WebCenter password.
    Confirm Password Re-enter the password to confirm.
    WebCenter Connection String Enter the connection string. Here is an example: idc://hostname:4444
    WebCenter Document URL Enter the document URL. Here is the default: http//hostname:16200/cs/groups/secure/documents/document

    When you finish, click Next to continue.

  19. On the Optional Oracle (UMS) Information window, enter the User Messaging Services settings:

    Field Description
    Use UMS Select True to enable user messaging services. The default is False.
    UMS User Enter the UMS server user name.
    UMS Password Enter the UMS server user name.
    Confirm Password Re-enter the password to confirm.
    UMS Endpoint Enter the URL of the UMS server used for notifications.

    When you finish, click Next to continue.

  20. On the Summary window, review your installation settings, space requirements, and availability. To make any changes, click Back.

  21. Click Install to begin the installation process.

    The Install Status window indicates the progress of the installation. To stop the installation process, click Stop Installation.

    Note:

    The installation routine may display the Execute Configuration Scripts window. This window lists scripts you must run as the root user, specifically the orainstRoot.sh script.

    If so, follow the instructions on the screen to run the scripts as a user with root permissions.

    If errors occur during the installation, review the installActions[date_and_ time].log file. This file is usually located in this directory:

    /opt/dmoracle/oraInventory/logs

    Note that these out files and error logs are also created during the installation process:

    oraInstall[date_time].out

    oraInstall[date_time].err

  22. On completion of the installation process, click Next and Finish.

Your ODEE system has now been installed and the initial configuration has been completed. Continue with Stage 3: Post-Setup on page 52 to finish the implementation of your ODEE system.