unifier installation and setup guide for weblogic …...7 the unifier installation and setup guide...

81
Unifier Installation and Setup Guide for WebLogic Application Server 15 R2 September 2015

Upload: others

Post on 04-Jun-2020

43 views

Category:

Documents


0 download

TRANSCRIPT

UUnniiffiieerr IInnssttaallllaattiioonn aanndd SSeettuupp GGuuiiddee ffoorr WWeebbLLooggiicc AApppplliiccaattiioonn SSeerrvveerr 1155 RR22

SSeepptteemmbbeerr 22001155

3

Contents Introduction............................................................................................. 7 Unifier Overview ......................................................................................... 7 uDesigner Overview ..................................................................................... 8

Installation Prerequisites ............................................................................ 11 Installing JDK ........................................................................................... 11 Installing WebLogic .................................................................................... 11 Installing Oracle HTTP Server (OHS) ................................................................ 11

Installing Unifier on Windows ...................................................................... 13 Downloading Unifier ................................................................................... 13 Configuring the Oracle Database Server............................................................ 14 Installing the AutoVue Server ........................................................................ 15

Downloading and Installing AutoVue ......................................................... 15 Configuring AutoVue ............................................................................ 16 Deploying Unifier GUI Applets to AutoVue .................................................. 16

Configuring the SQL Database Server ............................................................... 17 Configuring WebLogic for Unifier .................................................................... 17

Creating a WebLogic Domain for Unifier .................................................... 17 Starting the WebLogic Admin Server ......................................................... 18 Stopping the WebLogic Admin Server ........................................................ 18 Configuring WebLogic as a Service on Windows (Optional) ............................... 19

Installing and Configuring the Reports Server (Optional) ........................................ 19 Specifying Unifier Configurator Settings ........................................................... 20

General Tab ..................................................................................... 20 Repository Tab (WebCenter Content) ........................................................ 21 Repository Tab (Network File System) ....................................................... 22 Repository Tab (SharePoint) .................................................................. 23 Repository Tab (CMIS) .......................................................................... 23 Database Tab (Oracle) ......................................................................... 24 Database Tab (MS SQL Server) ................................................................ 25 Email Tab ........................................................................................ 26 Markup Server Tab .............................................................................. 28 Report Tab ....................................................................................... 28 Geo Map Tab ..................................................................................... 29 Authentication Tab (Native) .................................................................. 29 Authentication Tab (OIM/OAM) ............................................................... 29 Authentication Tab (WebLogic) ............................................................... 29 Authentication Tab (LDAP Simple Bind) ..................................................... 29

Unifier Installation and Setup Guide for WebLogic Application Server

4

Authentication Tab (LDAP Double Bind) ..................................................... 30 Authentication Tab (Generic SSO) ............................................................ 31

Installing Oracle WebCenter Content (Optional) .................................................. 31 Configuring Unifier Using the Configurator ........................................................ 31

Editing the SetEnv.bat File .................................................................... 31 Changing Unifier Configurator Settings ...................................................... 31

General Tab........................................................................ 32 Repository Tab (WebCenter Content) .......................................... 32 Repository Tab (Network File System) ......................................... 33 Repository Tab (SharePoint)..................................................... 34 Repository Tab (CMIS) ............................................................ 35 Database Tab (Oracle) ........................................................... 36 Database Tab (MS SQL Server) .................................................. 37 Email Tab .......................................................................... 37 Markup Server Tab ................................................................ 40 Report Tab ......................................................................... 40 Geo Map Tab ....................................................................... 40 Authentication Tab (Native) ..................................................... 41 Authentication Tab (OIM/OAM) ................................................. 41 Authentication Tab (WebLogic) ................................................. 41 Authentication Tab (LDAP Simple Bind) ....................................... 41 Authentication Tab (LDAP Double Bind) ....................................... 42 Authentication Tab (Generic SSO) .............................................. 42

Saving the Configuration Settings ............................................................ 43 Changing Configuration Settings .............................................................. 43

Stopping Unifier in WebLogic ................................................... 43 Editing Configuration Data ...................................................... 43 Starting Unifier in WebLogic .................................................... 43

Copying the Configuration Data File ......................................................... 44 Configuring the Oracle HTTP Server (OHS)......................................................... 44

Installing SSL Certificate (Optional) .......................................................... 45 Data Backup Recommendations .............................................................. 45

Deploying Unifier ...................................................................................... 46 Creating an EAR File From the Configurator ................................................ 46 Deploying Unifier From the Unifier_Home Directory ...................................... 46 Deploying Unifier from the WebLogic Administration Console ........................... 46

Launching Unifier ...................................................................................... 47 Unifier URL (WebLogic) ........................................................................ 47 Starting Unifier for the First Time ........................................................... 47 Installing Unifier Applications ................................................................. 48 Deploying Unifier Online Help ................................................................ 50

Contents

5

Installing Unifier on Linux........................................................................... 53 Downloading Unifier ................................................................................... 53 Configuring the Oracle Database Server............................................................ 54 Installing the AutoVue Server ........................................................................ 55

Downloading and Installing AutoVue ......................................................... 55 Configuring AutoVue ............................................................................ 56 Deploying Unifier GUI Applets to AutoVue .................................................. 56

Configuring WebLogic for Unifier .................................................................... 57 Creating a WebLogic Domain for Unifier .................................................... 57 Starting the WebLogic Admin Server ......................................................... 58 Stopping the WebLogic Admin Server ........................................................ 58 Configuring WebLogic and OHS as a Service ................................................ 58

Installing and Configuring the Reports Server (Optional) ........................................ 59 Installing Oracle WebCenter Content (Optional) .................................................. 60 Configuring Unifier Using the Configurator ........................................................ 60

Editing the SetEnv.sh File ..................................................................... 60 Saving the Configuration Settings ............................................................ 60 Changing Configurator Settings ............................................................... 60

Stopping Unifier in WebLogic ................................................... 60 Editing Configuration Data ...................................................... 60 Starting Unifier in WebLogic .................................................... 61

Copying the Configuration Data File ......................................................... 61 Configuring the Oracle HTTP Server (OHS)......................................................... 61

Installing SSL Certificate (Optional) .......................................................... 63 Data Backup Recommendations .............................................................. 63

Deploying Unifier ...................................................................................... 63 Unifier URL (WebLogic) ........................................................................ 63 Creating an EAR File From the Configurator ................................................ 63 Deploying Unifier From the Unifier_Home Directory ...................................... 63 Deploying Unifier from the WebLogic Administration Console ........................... 64 Deploying Unifier to a WebLogic Cluster .................................................... 64

Launching Unifier ...................................................................................... 65 Starting Unifier for the First Time ........................................................... 65

Installing Unifier Applications ................................................... 65 Deploying Unifier Online Help ................................................................ 68

Appendix A: Installing a Service Pack (WebLogic) .............................................. 69

Appendix B: Archiving Projects .................................................................... 71

For More Information ................................................................................ 72 Where to Get Documentation ........................................................................ 72 Where to Get Training ................................................................................ 77 Where to Get Support ................................................................................. 77

Unifier Installation and Setup Guide for WebLogic Application Server

6

Additional Support ..................................................................................... 78

Legal Notices .......................................................................................... 81

7

The Unifier Installation and Setup Guide for WebLogic Application Server describes how to:

Set up the Unifier servers and third party services. The requirements include: Oracle database or Microsoft SQL Server database servers Oracle WebLogic Oracle Linux Oracle Maps (Optional) Oracle WebCenter Content (Optional) Oracle HTTP Server (OHS) Unifier Application / Web Server AutoVue Server Solaris Reports Server (Optional)

For the full list of system requirements and versions, refer to the Tested Configurations document under “Installation and Configuration Documentation” in the Primavera Unifier Online Documentation Library.

Install and configure Unifier components

This guide is intended for IT professionals who are installing and configuring the server environment for Unifier and who are supporting Unifier users.

Note: The uDesigner is a module in Unifier.

In This Section

Unifier Overview ........................................................................................................ 7 uDesigner Overview .................................................................................................. 8

Unifier Overview

Designing, building, and managing facilities requires extensive collaboration between numerous, often geographically dispersed, disciplines and entities. Throughout the process, from conceptual design to facility operations, access to accurate, up-to-date information is critical to the success of a project and facility.

Oracle Primavera's Unifier is an integrated platform that optimizes business processes and creates visibility to enable customers to better manage all of the communications and information required to successfully manage a facility throughout the lifecycle.

Introduction

Unifier Installation and Setup Guide for WebLogic Application Server

8

Unifier is a system for managing the flow of information in projects or shells, providing a seamlessly automated and integrated environment across the lifecycle of your company's facilities, from planning, design, procurement, construction and into operations and maintenance. It provides real-time visibility across multiple projects or shells to help your company make fast, accurate decisions.

Unifier lets you track and manage information such as budgets, project or shell members, specifications, requests for information, and shared documents. You decide who has access to the information, which team members are allowed to approve changes to the information, and how information flows between people.

Oracle Primavera's solutions automate manual processes and pull together information from various point systems typically used on a portfolio of projects or shells. Through Unifier, executives and project or shell team members can better manage all data and business processes in one centralized system, while reducing the reliance on older technologies such as email, fax, and desktop applications.

Unifier was designed from the ground up specifically for the facility owner, based upon our industry domain expertise and knowledge of best practices combined with direct customer input gathered over decades of client interaction. The result is a robust set of capabilities with an intuitive, easy-to-use interface. Unifier enables leading owners and operators to increase enterprise efficiencies, reduce project and operating costs, enhance visibility, and improve time-to-market.

uDesigner Overview

uDesigner is a functional module of Unifier and is enabled automatically when Unifier is installed.

The uDesigner module is used to create:

Business Process (BP) Managers (Asset - Cost - Document - Planning - Portfolio - Resource - Schedule - Space -

Shell) Configurable Modules Attribute Forms (Users, Shells, Document Manager, Cost)

You can use the uDesigner module to create, configure, setup, and test all designs in the Unifier Staging environment, and after you test the designs, you can import the designs to another environment, such as Unifier Production, by way of design bundles.

Notes:

You can select the Unifier environment in the Unifier Configurator. Unifier Staging environment is a Unifier server deployed without selecting the "Production" configuration checkbox in the Configurator.

Staging is a testing environment that replicates the Unifier Production environment. It must be set up just like production. An object (for example a BP) can be deployed multiple times in the Staging environment.

Introduction

9

Users with permission have access to uDesigner (Staging or Production). In Staging environment, all uDesigner functionalities are available, but in Production environment the uDesigner functionalities are limited.

11

Create an installation account on the server that has full administration privileges. You will need to use this account for maintenance and upgrades.

The following are also prerequisites:

Installation of the supported versions of WebLogic and JDK. Installation of the supported version of Oracle HTTP Server (OHS) Installation of an Oracle or Microsoft SQL database

See the Tested Configurations document for the supported versions.

In This Section

Installing JDK .......................................................................................................... 11 Installing WebLogic ................................................................................................. 11 Installing Oracle HTTP Server (OHS) ...................................................................... 11

Installing JDK

WebLogic 11g automatically installs Java JDK for Windows; however, specific versions are supported based on your configuration. For a list of supported configurations for Primavera Unifier, see the Tested Configurations document.

Installing WebLogic

You will need to install WebLogic 11g or 12c to deploy Primavera Unifier. For supported version levels, see the Tested Configurations document. Also, consult WebLogic’s documentation for installation instructions. Visit: http://docs.oracle.com/cd/E23943_01/wls.htm.

Installing Oracle HTTP Server (OHS)

You will need to install the Oracle HTTP server (OHS) for load balancing and redirection of Unifier.

For supported version levels, refer to the Tested Configurations document. Also, consult the Administrator's Guide for Oracle HTTP Server document for installation instructions: http://docs.oracle.com/cd/E23943_01/web.1111/e10144/toc.htm

1) Install Oracle HTTP Server (OHS) on desired server. 2) If OHS is installed on a different server than the Unifier server, then copy the Unifier_Home

directory and all the files from the Unifier server to the OHS server, using the same path and directory structure on both the servers. For example: [Unifier_Home]\apps\ROOT

Installation Prerequisites

Unifier Installation and Setup Guide for WebLogic Application Server

12

Note: The [Unifier home]\apps\ROOT contents must be kept consistent between the Unifier app server and the OHS server. For example, if a Unifier patch set or interim patch set results in modifying the contents of the [Unifier home]\apps\ROOT, re-copy the revised directory over to the OHS server.

13

Complete the procedures in the order listed below to install and configure Unifier for a first time installation. Each step corresponds to a section in this guide.

Note: Before you begin, create an installation account that has full administration privileges for the server. This account is needed for installation, maintenance and upgrades.

1) Download Unifier 2) Configure the database server

Complete this step before configuring Unifier. This information will be used during database configuration in Unifier Configurator.

3) Configure WebLogic for Unifier 4) Install and configure the Reports Server. (Optional) 5) Install Oracle WebCenter Content. (Optional) 6) Install AutoVue Server 7) Configure Unifier using the Configurator 8) Deploy Unifier in WebLogic 9) Configure the Web Server 10) Launch Unifier and install Unifier applications

In This Section

Downloading Unifier ................................................................................................ 13 Configuring the Oracle Database Server ................................................................. 14 Installing the AutoVue Server .................................................................................. 15 Configuring the SQL Database Server ..................................................................... 17 Configuring WebLogic for Unifier ............................................................................. 17 Installing and Configuring the Reports Server (Optional) ......................................... 19 Specifying Unifier Configurator Settings .................................................................. 20 Installing Oracle WebCenter Content (Optional) ...................................................... 31 Configuring Unifier Using the Configurator ............................................................... 31 Configuring the Oracle HTTP Server (OHS) ............................................................ 44 Deploying Unifier ..................................................................................................... 46 Launching Unifier ..................................................................................................... 47

Downloading Unifier

1) Go to Oracle Software Delivery Cloud (https://edelivery.oracle.com/) and sign in 2) Navigate to access the Primavera Unifier page

Installing Unifier on Windows

Unifier Installation and Setup Guide for WebLogic Application Server

14

3) Click Readme to open the "Primavera Unifier Media Pack" page and read the information about: Licensed Products and Restrictions for Primavera Unifier Download Requirements Contacting Unifier Customer Support Access to Oracle Support

4) Close the "Primavera Unifier Media Pack" page

The Primavera Unifier download provides the necessary files for installing the platform version of the product, only. The platform version of Unifier contains all the Unifier modules and allows the users to create their own designs (business processes and attribute forms). This version of Unifier does not have preconfigured designs.

The Primavera Unifier Project Controls download provides the files containing the preconfigured designs (business processes and attribute forms), only.

Note: If your licensing agreement includes Primavera Unifier Project Controls, you must first download the Primavera Unifier and then proceed to downloading the Primavera Unifier Project Controls. The Primavera Unifier Project Controls download folder does not have the main Unifier application.

See the Installing Unifier Applications section for additional information.

Refer to the:

Primavera Unifier What's New document to learn about enhancements to Primavera Unifier. Primavera Unifier Cumulative Feature Overview Tool (spreadsheet) to identify the features

that have been added to Unifier since a specific release level.

Configuring the Oracle Database Server

The following is an overview of the steps required to configure the Oracle database for use with Unifier. For more information and specific instructions, refer to your Oracle documentation.

Configure an Oracle database for Unifier as follows:

1) Create an instance for the database.

Note: You can accept the defaults except for the following: Ensure to set encoding to Unicode (UTF-8).

2) Create a user account on the newly created database. For successful Primavera Unifier/uDesigner installation, make sure ample free space of at least 2GB is available for the default tablespace where the new user will be located.

3) Grant the new user with connect, resource, create view, and create table privileges.

Note: This information will be used later for setting database information in the Database tab of the Unifier Configurator.

Installing Unifier on Windows

15

For example: create user unifier identified by unifier temporary tablespace temp default tablespace users; grant connect, resource, create view, create table to unifier;

Notes:

(Required) Ensure that maximum open cursor in Oracle DB is set to 1000, or above.

Ensure that Database user quota is set to unlimited on tablespace users.

Installing the AutoVue Server

AutoVue installation is mandatory if you plan to use Unifier Markup feature, also referred to as redlining.

When attaching documents to a Business Process (BP) form, you can add markups (text notes or graphical elements) that display directly on the document.

Note: The markups do not alter the document.

This section describes the following procedures:

Downloading and installing AutoVue Configuring AutoVue Deploying Custom GUI AutoVue applets

Notes:

You must have a license to install AutoVue. The AutoVue server is high-intensive with regard to CPU, I/O,

memory, and graphics. So, for optimal performance, ensure that the machine running the AutoVue server is not being used for other applications.

For more information, refer to Oracle AutoVue Client/Server Deployment Installation and Configuration Guide available on Oracle Documentation website.

For the full list of system requirements and versions, see the Unifier Tested Configurations document under “Installation and Configuration Documentation” in the Primavera Unifier Online Documentation Library.

Downloading and Installing AutoVue

Download and install AutoVue as follows:

1) Go to the Oracle Software Delivery Cloud (https://edelivery.oracle.com/ (https://edelivery.oracle.com/)) and sign in.

Unifier Installation and Setup Guide for WebLogic Application Server

16

2) From the Product field list select Oracle AutoVue 3D Professional Advanced. 3) Click Select Platform and select Microsoft Windows (32-bit)/Linux x86 and then click

Continue. 4) Review the information under Available Release, and then click Continue. 5) Accept the terms, and then click Continue. 6) Click the zip file and then click Download All to download:

1. V74040-01.zip Oracle AutoVue 3D Professional Advanced 20.2.3 (Windows) 2. V74008-01.zip Oracle AutoVue 3D Professional Advanced 20.2.3 (Linux x86)

The download may take a few minutes to complete. After the download is completed:

1) Extract the zip file and go to this directory in which you have extracted the zip file. 2) Run the AutoVue installer executable:

1. InstallClientServer.exe (Windows) 2. InstallClientServer_lin.bin (Linux x86)

3) Go to the directory in which you have extracted the zip file. 4) Locate the jvueserver.properties file and open. 5) Add the following line at the end of the <AutoVue install

dir>\bin\jvueserver.properties file: jvueserver.authentication.enable=false

Configuring AutoVue

After installing AutoVue, configure AutoVue by entering information in the following tabs of the Unifier Configurator:

In the General Tab, enter the Server internal URL field to access AutoVue. In the Markup Server Tab, complete all fields in this tab.

For more information about the General and Markup Server tabs, see the Specifying Unifier Configurator Settings (on page 20) section.

Deploying Unifier GUI Applets to AutoVue

AutoVue provides the option of customizing third-party graphical user interface (GUI). The following Unifier applet GUI files are provided to integrate with AutoVue: default.gui defaultcons.gui defaultNoMarkup.gui defaultview.gui

To deploy the Unifier applet GUI files to AutoVue:

1) Download the current version of the Primavera Unifier Tools file from the Oracle Software Delivery Cloud (https://edelivery.oracle.com/ (https://edelivery.oracle.com/)).

Installing Unifier on Windows

17

2) Unzip the AutoVueMenus.zip file into the location specified in the jvueserver.users.directory parameter in the <AutoVue install dir>\bin\jvueserver.properties file.

3) Follow the recommendation in the Oracle AutoVue 20.2.3 documentation site http://docs.oracle.com/cd/E60531_03/otn/docset.html

Configuring the SQL Database Server

The following is an overview of the steps required to configure the Microsoft SQL database for use with Unifier. Refer to your SQL documentation for more information and specific instructions.

Configure a Microsoft SQL database for Unifier as follows:

1) Create a new database to be used with Unifier.

Note: You can accept the defaults.

2) Create a user account for the newly created database. 3) Use the default SQL configuration. You must assign the user as db_owner otherwise Unifier

will not work.

Note: This information will be used later for setting database information in the Database tab of the Unifier Configurator.

Configuring WebLogic for Unifier

This section describes how to configure WebLogic for Unifier. It includes:

Creating a WebLogic Domain for Unifier (on page 17) Starting the WebLogic Admin Server (on page 18) Stopping the WebLogic Admin Server (on page 18) Configuring WebLogic as a Service on Windows (Optional) (on page 19)

Creating a WebLogic Domain for Unifier

Create a WebLogic domain for Unifier as follows:

1) Run the WebLogic Configuration Wizard. 2) In the Welcome window:

a. Select Create a new WebLogic domain. b. Click Next.

3) In the Select Domain Source window, click Next to accept the default selections. 4) In the Specify Domain Name and Location:

a. Enter a domain name for the new domain to be created. b. Enter the location of the new domain on the server. c. Click Next.

5) In the Configure Administrator User Name and Password window:

Unifier Installation and Setup Guide for WebLogic Application Server

18

a. Enter the User Name and Password for the Administrator that will be created. This user name will be used to login to the WebLogic console.

b. Click Next. 6) In the Configure Server Start Mode and JDK window:

a. In the left pane, select Production Mode. b. In the right pane, select the JDK you installed earlier. c. Click Next.

7) In the Select Optional Configuration window: a. Select the Administration Server option. b. Click Next.

8) (Optional) In the Configure the Administration Server window: a. Select the SSL Enabled option and set the SSL listen port if you are enabling Secure

Sockets Layer communication. See http://download.oracle.com/docs/cd/E12840_01/wls/docs103/secmanage/ssl.html for more details on setting SSL for WebLogic.

Note: Oracle recommends you always use SSL in a production environment for secure communications.

b. Click Next. 9) In the Configuration Summary window, click Create.

If given the option, you can click Done now. Otherwise, continue to the next step. 10) In the Creating Domain window, select Start Admin Server, and then click Done. 11) When prompted, enter the Administrator User Name and Password that you entered above.

Starting the WebLogic Admin Server

To deploy Unifier in WebLogic, start the admin server as follows:

1) From the Start menu, navigate to the Oracle WebLogic submenu. 2) Choose User Projects, domain, Your domain, Start Server.

(user_projects,domain,<your_domain>,Start Server) 3) If prompted for a user name and password in the WebLogic console window, enter the

administrative user name and password that was specified when creating the domain.

Note: If you turned on the WebLogic precompile option, the WebLogic console displays "Server started in RUNNING mode" when precompiling finishes. For detailed information about turning on precompilation, see your WebLogic Server documentation.

Stopping the WebLogic Admin Server

Stop WebLogic admin server as follows:

1) From the Start menu, navigate to the Oracle WebLogic submenu.

Installing Unifier on Windows

19

2) Choose User Projects, domain, Your domain, Stop Server. (user_projects,domain,<your_domain>,Stop Server)

3) If prompted for a user name and password in the WebLogic console window, enter the administrative user name and password that was specified when creating the domain.

Note: The WebLogic console window will close automatically when it is shutdown.

Configuring WebLogic as a Service on Windows (Optional)

To automatically start WebLogic on a reboot, complete the following steps to start WebLogic admin server as a service on Windows operating system:

1) Set WL_HOME as system environment variable or modify it in <unifier_home>/weblogic/setenv.bat. WL_HOME is the root directory of the WebLogic installation. For detailed instructions, refer to the topic, Creating a WebLogic Domain for Unifier (on page 17) to create the Domain Home for weblogic. For example: C:\Oracle\Middleware\wlserver_11\server

2) In setenv.bat, set the java_home variable to specify the java home used by the Unifier domain. The default value is Xms1536m -Xmx1536m. For detailed instructions on setting the environment variables for Unifier, refer to Changing Unifier Configurator Settings (on page 31).

3) Log in as a WebLogic Administrator. 4) Access the <unifier_home>/weblogic folder and run the following scripts: Run service.bat install to install the service for the first time using "beasvc

%DOMAIN_NAME%_AdminServer” as the service name. Run service.bat start to start the weblogic server with name "beasvc

%DOMAIN_NAME%_AdminServer" Run service.bat stop to stop the weblogic server with name "beasvc

%DOMAIN_NAME%_AdminServer" Run service.bat uninstall to remove the service named "beasvc

%DOMAIN_NAME%_AdminServer" from the system. where %DOMAIN_NAME% is the WebLogic domain name used for deploying Unifier. For example: unifier_domain

Tip: Check if the beasvc %DOMAIN_NAME%_%SERVER_NAME% service exists, runs, or stops from the Control Panel, Administrative Tools, Services menu option.

Installing and Configuring the Reports Server (Optional)

Consult your Oracle documentation for instructions on installing Oracle Business Intelligence Publisher 11g.

Unifier Installation and Setup Guide for WebLogic Application Server

20

For the full list of system requirements and versions, see the Tested Configurations document under “Installation and Configuration Documentation” in the Primavera Unifier Online Documentation Library.

For configuration information for integrating Unifier and BI Publisher, see the Configuring BI Publisher for Primavera Unifier document.

Specifying Unifier Configurator Settings

The Unifier environment is configured through the Unifier Configurator window. To change settings in Unifier Configurator:

1) Open the WebLogic directory inside the Unifier Home folder. 2) Run configure.sh. 3) Configure the settings for each tab described in the following topics.

General Tab

Server Type: The setting that defines the mode Unifier server is running.

Set Server Type to Production if this Unifier installation is acting as the Unifier production environment.

Set Server Type to Staging if this Unifier installation is acting as the staging server for testing of business processes and other Unifier designs and configurations.

Note: You must set the Server Type to Staging if you want to modify uDesigner designs. If you do not select Staging, you will not be able to edit uDesigner designs since designs are available as read-only in the Production Server.

Server Internal URL: Enter the Http Server URL running on 80 port which is configured with Unifier (For example: http://host1.expample.com)

Note: BI Publisher and Markup servers use this URL to communicate with Unifier.

Login Session Timeout: Login Session Timeout is used to control the amount of time a user can be idle before having to log back into Unifier. The unit is seconds. For security reasons, the recommended timeout setting is between 30 minutes and 4 hours.

Late Notice Interval: Interval, in minutes, used by the internal job server for notification tasks. The suggested interval is 15 minutes. A very small interval may degrade performance.

UPK Help URL: Enter the URL where the User Productivity Kit (UPK) help content is to be hosted (as a generic example, http://servername/contextroot, or as a specific example is http://localhost/unifierupk).

Note: Ensure that the Popup Blocker is disabled.

Installing Unifier on Windows

21

Unifier Help URL: To deploy a local version of the Unifier online help, enter the URL where the help file is to be hosted. By default, the online help is deployed from the Oracle Technology Network site.

Temporary Directory: Enter the temporary directory for Unifier server operations.

Repository Tab (WebCenter Content)

This topic applies when you select WebCenter Content for the File Repository field.

There are two data repositories (folders in which Unifier data is stored), which Unifier requires you to configure. There are additional repositories, such as the archive directory for project archiving, that are used with specific features, as described below. These can be located on a local but separate hard drive, or on a mapped drive on your network.

File Repository: Select WebCenter Content.

WebCenter Content Server Host: This is the IP address of the WebCenter Content server.

WebCenter Content Server Port: This is the port of the WebCenter Content server.

WebCenter Content User: This is the user who will add documents through the API. The user should exist in the WebCenter Content server.

WebCenter Content Root Folder: The root folder in WebCenter Content under which all Unifier folders will be created. When no root folder is specified, all folders will be created under "Contribution Folders."

Notes:

It is important to plan where these directories are located because they are where Unifier data is stored. Any subsequent upgrade installations need to point to these same two directories in order for Unifier to ‘see’ data previously entered.

These repositories, in addition to your database, should be backed up regularly.

When naming the folders, be sure there are no spaces in the folder names.

These files must be on a shared drive that is accessible by other server machines that are operating in a clustering environment.

Archive Directory: For project archiving capability. Default value is d:\projectArchive. (See Appendix B: Archiving Projects for more information about archiving.)

Archive Temp Directory: For temporary archived files. Default value is d:\temp.

Report Directory: The pathname where report files are stored.

Web Service Audit Directory: This folder stores files for Web Services calls.

Dashboard Data Directory: This folder stores the .swf and XML files used with custom dashboards.

Unifier Installation and Setup Guide for WebLogic Application Server

22

Log File Directory: The folder where the log files are stored.

Test WebCenter: Enables you to validate the the configuration settings that you have entered.

Repository Tab (Network File System)

This topic applies when you select Network File System for the File Repository field.

There are two data repositories (folders in which Unifier data is stored), which Unifier requires you to configure. There are additional repositories, such as the archive directory for project archiving, that are used with specific features, as described below. These can be located on a local but separate hard drive, or on a mapped drive on your network.

File Repository: In this field, select Network File System from the drop-down list. Other options include:

CMIS: See Repository Tab (CMIS) for detailed information. SharePoint: See Repository Tab (SharePoint) for detailed information.

Notes:

It is important to plan where these directories are located because they are where Unifier data is stored. Any subsequent upgrade installations need to point to these same two directories in order for Unifier to ‘see’ data previously entered.

These repositories, in addition to your database, should be backed up regularly.

When naming the folders, be sure there are no spaces in the folder names.

File Directory: Enter (or Browse to) the path where uploaded or attached files are stored. This repository is for storing documents within the Document Manager, such as drawings, plans, Word documents, etc. These files will be available for viewing or attaching to business process forms within Unifier. It also stores imported schedule files.

Note: These files must be on a shared drive that is accessible by other server machines that are operating in a clustering environment.

Index Directory: This is the pathname to the location where the Search Index files are stored.

Archive Directory: For project archiving capability. Default value is d:\projectArchive. (See Appendix B: Archiving Projects for more information about archiving.)

Archive Temp Directory: For temporary archived files. Default value is d:\temp.

Report Directory: This is the pathname to the location where report files are stored.

Web Service Audit Directory: This folder stores files for Web Services calls.

Dashboard Data Directory: This folder stores the .swf and XML files used with custom dashboards.

Log File Directory: The folder where the log files are stored.

Installing Unifier on Windows

23

Repository Tab (SharePoint)

The following fields display when you select SharePoint in the File Repository field.

SharePoint Login Name: Login user name to the machine where SharePoint is installed.

SharePoint Password: Password for the SharePoint login name.

SharePoint Host Name: Machine name or IP address of the SharePoint server.

SharePoint Domain: The domain where the SharePoint server resides.

SharePoint Document Library URL: URL for the document library (For example: http://SPHostname/unishare/UnitTestLib_1)

SharePoint Web Service URL: The URL of the Web Service used to connect Unifier to SharePoint, as specified when you configured SharePoint. The URL includes the machine name (or IP address) of the content repository server, port number of the server, and web service name (For example: http://hostname/port/WS_FPRPC).

External Document Library URL: The URL of an external document library.

Notes: It is important to plan where these directories are located because

they are where Unifier data is stored. Any subsequent upgrade installations need to point to these same two directories in order for Unifier to ‘see’ data previously entered.

These repositories, in addition to your database, should be backed up regularly.

When naming the folders, be sure there are no spaces in the folder names.

These files must be on a shared drive that is accessible by other server machines that are operating in a clustering environment.

Index Directory: This folder is for index files used in Document Manager search function.

Archive Directory: For project archiving capability. Default value is d:\projectArchive. (See "Appendix B: Archiving" for more information about archiving.)

Archive Temp Directory: For temporary archived files. Default value is d:\temp.

Report Directory: This field contains the pathname for where the report files are stored.

Web Service Audit Directory: This folder stores files for Web Services calls.

Dashboard Data Directory: This folder stores the .swf and XML files used with custom dashboards.

Log File Directory: The folder where the log files are stored.

Repository Tab (CMIS)

The following fields display when you select CMIS in the File Repository field.

CMIS Login Name: Enter the user name for your content repository.

Unifier Installation and Setup Guide for WebLogic Application Server

24

CMIS Password: Password for the CMIS login name.

CMIS Repository Name: The content repository name.

CMIS Documentation Home: The documentation home.

CMIS Web Service URL: The URL for your web services home.

Notes: It is important to plan where these directories are located because

they are where Unifier data is stored. Any subsequent upgrade installations need to point to these same two directories in order for Unifier to ‘see’ data previously entered.

These repositories, in addition to your database, should be backed up regularly.

When naming the folders, be sure there are no spaces in the folder names.

These files must be on a shared drive that is accessible by other server machines that are operating in a clustering environment.

Index Directory: This folder is for index files used in Document Manager search function.

Archive Directory: For project archiving capability. Default value is d:\projectArchive. (See "Appendix B: Archiving Projects" for more information about archiving.)

Archive Temp Directory: For temporary archived files. Default value is d:\temp.

Report Directory: The pathname where report files are stored.

Web Service Audit Directory: This folder stores files for Web Services calls.

Dashboard Data Directory: This folder stores the .swf and XML files used with custom dashboards.

Log File Directory: The folder where the log files are stored.

Database Tab (Oracle)

The information entered in this tab is based on your earlier database and user account creation.

Database Type: Select Oracle.

Database Name: This field is not applicable for Oracle.

Database Name: Leave it Blank.

Host Name: Enter the host name of the computer where you installed the database.

Instance ID: The Instance ID field in the Configurator can accept the following values:

An MS SQL server instance iD An Oracle SID An Oracle service name (Oracle DB 12c)

Installing Unifier on Windows

25

When you enter a service name for an Oracle service name (Oracle DB 12c), you must preface the name with a forward slash (/), for example, /servicename.

If you do not preface the name with a forward slash (/), the system presumes that you have:

Entered an Oracle SID, if you had selected Oracle from the drop-down list. or

Entered an MS SQL server instance iD, if you had selected SQL Server from the drop-down list.

Port: Enter the Port number to be used by Unifier to communicate with the database (For example: 1521).

User Name: Enter the database login user account name (created in Oracle) to be used by Unifier. The database login user account needs to have sufficient permissions to create tables in order for Unifier to work correctly.

User Password: Enter the database login user account password to be used by Unifier.

Max. Connections: The setting that defines the maximum connections to the database. The maximum is 400; the recommended maximum is 80 to 100.

Min. Connections: The setting that defines the minimum connections that must be connected to the database.

Test Connection: Click Test Connection to verify that the Application server and the database are connected and communicating. A Test is successful message will appear if test is successful. Two conditions are tested:

Ability of Unifier to connect to the database Level of permissions granted to the database login user account

Database Tab (MS SQL Server)

The information entered in this tab is based upon your earlier database and user account creation.

Database Type: Select MS SQL Server to configure for Microsoft SQL Server.

Database Name: Enter the database name (if applicable).

Host Name: Enter the host name of the computer where you installed and configured Microsoft SQL Server database.

Instance ID: If you did not specify an instance name when configuring the SQL Server, leave the Instance ID field blank. Otherwise, enter the Instance ID.

Port: Enter the Port number to be used by Unifier to communicate with the Microsoft SQL Server database.

User Name: Enter the database login user account name for the Microsoft SQL Server database to be used by Unifier.

User Password: Enter the database login user account name password for the Microsoft SQL Server database to be used by Unifier.

Max. Connections: The setting that defines the maximum connections to the database. The recommended setting is 100.

Unifier Installation and Setup Guide for WebLogic Application Server

26

Min. Connections: The setting that defines the minimum connections that must be connected to the database. Click Test Connection to verify that the Application server and the Microsoft SQL Server database are connected and communicating.

Test Connection: Enables you to validate the the configuration settings that you have entered.

Email Tab

Outbound (SMTP) E-mail Server: (Required) Enter the IP address for the outbound SMTP email server information in this filed.

System Notification E-mail Address: This field contains the email ID that the system displays as the "Sender’s" email address for all emails generated by the Unifier system, for example, [email protected].

E-mail Sender Prefix: Enter the email prefix that will be used in the Sender’s name whenever an email is generated from a user from within Unifier, for example, Unifier. Late email notifications show the E-mail Sender Prefix, only.

E-mail Login URL: The URL included in all email notifications sent to the users who have logged in to the system. Ensure that this URL is the same as "Server Internal URL" which is entered in General tab.

Note: This field must contain the fully qualified server name in order to establish a successful connection to the application server; otherwise, the interactive login will not work.

Support Contact Information: This field contains the message text that is included in all support-related email notifications.

Note: To enable an email address as a hyperlink, use the following format: <a href="mailto:[email protected]">[email protected]</a>

System Error Notification E-mail Address: This field contains the email address where Unifier sends a notification if Unifier loses connection to the database while the system is running. The email addresses can be separated by semicolon.

License Notification E-mail Address: This field contains the email address where Unifier sends licensing notifications, for example, if the number of users exceeds the number of available licenses. The email addresses can be separated by semicolon.

Inbound E-mail protocol: Select the protocol used by the inbound email server that can receive email. The supported protocols are POP3, IMAP, POP3S, and IMAPS.

Note: Each Unifier environment (Staging/Production) must be configured with its own inbound email account. To prevent undesired results, do not use the same inbound email for all the environments.

Inbound E-mail Server: Enter the server that can receive email, for example, if a user takes action via email on a business process. This can be the server name or IP address.

Installing Unifier on Windows

27

(Optional) You can specify the port number after the server name of IP address, for example, example.com:1521.

Inbound E-mail Account: Enter the email account to receive response email from the user.

Note: To use the project or shell Mailbox, which allows external email messages to be sent to and stored within a central project or shell mailbox, use the following format for the inbound email account. This allows acceptance of inbound emails sent to the system-generated project/shell email addresses: *[email protected]. This configuration is needed on the email server, not within the Unifier Configurator.

Inbound E-mail Password: This field contains the password that corresponds to the inbound email account. This password is used when email is retrieved.

Test Inbound E-mail Account: Enables you to validate the the configuration settings that you have entered.

Note: Click Test Inbound E-mail Account to test the Inbound E-mail Server, Inbound E-mail Account, and Inbound E-mail Password.

About Inbound E-mail This Project Mailbox functionality rely on email address used for BP Action via Email. If the Inbound email address is [email protected], then the email address of a Project/Shell could be one of the following, depending on the property value in the skire.project.email.pattern in skire.properties file. This property can have two values: "prefix" or blank and "suffix."

In case the property value is "prefix" or blank

The email address of any Unifier Project/Shell will follow the pattern <project id>[email protected] used for Project Mail box functionality. For example, if the project id is 1001, then email address for this particular Project/Shell will be [email protected]. For this to function, you have to set up an email forwarding rule on your mail server such that any emails sent to .*[email protected] will be automatically forwarded to [email protected] Inbox.

In case the property value is "suffix"

The email address of any Unifier Project/Shell will follow the pattern unifier_oracle+<project id>@unifiermail.com used for Project Mail box functionality. For example, if the project id is 1001, then email address for this particular Project/Shell will be [email protected]. For this to function, you have to set up an email forwarding rule on your mail server such that any emails sent to unifier_oracle+.*@unifiermail.com will be automatically forwarded to [email protected] Inbox.

Unifier Installation and Setup Guide for WebLogic Application Server

28

Note: If you are using an email address on oracleindustry.com domain, you must use the "suffix" pattern, and you must, explicitly, set skire.project.email.pattern=suffix because this property is not exposed in current Unifier configurator. The email forwarding rule (for suffix pattern) is enabled on this domain by default.

On Unifier configurator, ensure that you include the port number for the current protocol in Inbound E-mail Server field, for example, unifiermail.com:110 or oracleindustry.com:993. The protocol and port mapping are as follows:

POP3 - port 110 IMAP - port 143 IMAPS - port 993 POP3S - port 995

To prevent the spam emails to go in the Project Mail box, the system accepts emails from email addresses associated with Unifier user account or the email addresses listed in Approved Email List by Company Admin, only.

Markup Server Tab

Use Server Internal URL: (Optional) Select this option only if server internal URL address must be used by markup server to communicate with Unifier. If not selected (default), The User's login base URL address is used by markup server to communicate with Unifier.

Markup Server Host Name: Enter the host name of the markup server.

Markup Server Port: Enter the port number of the markup server. The default port number for AutoVue is 5099.

Report Tab

BIP Endpoint URL: Enter the BIP Web Services endpoint URL. For example: http://host1.example.com:1521

BIP User Name: Enter the user name created for the BI Publisher server.

BIP Password: Enter the password for the BI Publisher user.

BIP Data Source: Enter the JDBC data source name that was entered when the JDBC Data Source BI Publisher

BIP Report Folder: The folder under the default location in the BI Publisher catalog. Reports reside in this folder based on company registry.

Note: The values used in the BIP User Name, BIP Password, BIP Data Source, and BIP Report folder fields are the same as those created when using the Configuring BI Publisher for Primavera Unifier document.

OBIEE Analytics URL: The URL to OBIEE Analytics service. This URL should be accessible via internet.

Installing Unifier on Windows

29

Test Connection: Enables you to validate the the configuration settings that you have entered.

Geo Map Tab

Map Server Url: Enter https://elocation.oracle.com. This is the Oracle Map server base URL where the Oracle MapVeiwer application is deployed with the context "mapviewer". This is where the server obtains the map image.

Map Tile: Enter elocation.world_map. This is the name of the map tile layer (the base map used for map rendering) that was pre-defined on the Oracle Map server. This is the map data source.

Map Geocoder Url: Enter https://elocation.oracle.com. This is the server URL where the Oracle Geocoder application is deployed with the context "geocoder." This is the location service.

Authentication Tab (Native)

User Authentication Type: Native

The Unifier default authentication mechanism is used.

Authentication Tab (OIM/OAM)

User Authentication Type: OIM/OAM

The system determines whether integration of Primavera Unifier with Oracle Identity Manager (OIM) and Oracle Access Manager (OAM) is enabled.

SSO Logout: The logout URL for Oracle Access Manager (OAM) or any third-party Single Sign On (SSO) configuration. For more details, refer to Oracle Access Manager documentation.

Authentication Tab (WebLogic)

User Authentication Type: Weblogic

Form-based authentication is used to integrate with WebLogic authentication methods. After WebLogic authenticates the user, Unifier determines if the user is a valid Unifier user before granting access to the application.

Realm: Weblogic realm that is used for authentication.

Group(s) (comma separated): Weblogic group name, a comma separated list, used for mapping Weblogic groups to "unifieruser" role.

Authentication Tab (LDAP Simple Bind)

The Lightweight Directory Access Protocol (LDAP) is a protocol for querying, and modifying, directory services. The Administrator can configure the server to use either simple-bind or double-bind authentication.

User Authentication Type: LDAP Simple Bind

Provider: To connect the LDAP server (URL), for example, ldap://ldap.zyz.com:636

Unifier Installation and Setup Guide for WebLogic Application Server

30

SSL: To connect to the Secure Sockets Layer (SSL) enabled port of the LDAP server.

Note: Oracle recommends you always use SSL in a production environment for secure communications.

When Unifier is configured with JDK 8 and integrated with LDAP SSL:

Add "-Djdk.tls.client.protocols=TLSv1" Java option to setenv.sh file. Restart Unifier.

The above settings enable you to log in using LDAP SSL.

Example Setting in setenv.sh file: export JAVA_OPTIONS="$JAVA_OPTIONS -Djavax.xml.parsers.DocumentBuilderFactory=com.sun.org.apache.xerces.internal. jaxp.DocumentBuilderFactoryImpl -Djdk.tls.client.protocols=TLSv1"

Security Principal Template: To authenticate directly, based on the user name and password (Simple Bind). The template is used to construct the user's Distinguished Name (DN), for example, cn={0},l=amer,dc=oracle,dc=com

Admin User Bypass: To allow administrators to bypass LDAP login.

Authentication Tab (LDAP Double Bind)

The Lightweight Directory Access Protocol (LDAP) is a protocol for querying, and modifying, directory services. The Administrator can configure the server to use either simple-bind or double-bind authentication.

User Authentication Type: LDAP Double Bind

Provider: To connect the LDAP server (URL), for example, ldap://ldap.zyz.com:636

SSL: To connect to the Secure Sockets Layer (SSL) enabled port of the LDAP server.

When Unifier is configured with JDK 8 and integrated with LDAP SSL:

Add "-Djdk.tls.client.protocols=TLSv1" Java option to setenv.sh file. Restart Unifier.

The above settings enable you to log in using LDAP SSL.

Example Setting in setenv.sh file: export JAVA_OPTIONS="$JAVA_OPTIONS -Djavax.xml.parsers.DocumentBuilderFactory=com.sun.org.apache.xerces.internal. jaxp.DocumentBuilderFactoryImpl -Djdk.tls.client.protocols=TLSv1"

Provider Base: (Optional) When you select the Double Bind method of authentication, you need to find the user's DN and then authenticate them. Finding the user's DN is used as the base for searching the LDAP tree. If the Provided Base is not set, the root is assumed by the system: ldap.provider.base

Installing Unifier on Windows

31

Authorized User: When using the Double Bind method of authentication, find the user's Distinguished Name (DN) and then authenticate. This is used as the "trusted" or "search" login user's DN (first bind).

Authorized User Password: When using the Double Bind method of authentication, this is the authorized user's login password.

Search Field: The default value is "cn." You need to enter the node field that you want to search.

Admin User Bypass: To allow the administrator bypass the LDAP login.

Authentication Tab (Generic SSO)

User Authentication Type: Generic SSO

SSO Header: The Single Sign On (SSO)

SSO Logout: The logout URL for Oracle Access Manager (OAM) or any third-party Single Sign On (SSO) configuration. For more details, refer to Oracle Access Manager documentation.

Installing Oracle WebCenter Content (Optional)

Consult Oracle documentation for instructions on installing the Oracle WebCenter. For configuration information for integrating Unifier and WebCenter content, see the Connecting the Content Repository to Primavera Unifier document.

Configuring Unifier Using the Configurator

This section describes how to use the Unifier Configurator to configure Unifier.

Editing the SetEnv.bat File

Edit the setenv.bat file as follows:

Set the domain_home variable to specify the path of the domain home folder that will be used by Unifier.

Set the admin url variable to specify host name and port number used by the Unifier domain.

Set the java_home variable to the JDK installed directory.

Changing Unifier Configurator Settings

The Unifier environment is configured through the Unifier Configurator window. To change settings in Unifier Configurator:

1) Open the WebLogic directory in the Unifier Home folder. 2) Run configure.bat. 3) Configure the settings for each tab described in the following topics.

Unifier Installation and Setup Guide for WebLogic Application Server

32

General Tab Server Type: The setting that defines the mode Unifier server is running.

Set Server Type to Production if this Unifier installation is acting as the Unifier production environment.

Set Server Type to Staging if this Unifier installation is acting as the staging server for testing of business processes and other Unifier designs and configurations.

Note: You must set the Server Type to Staging if you want to modify uDesigner designs. If you do not select Staging, you will not be able to edit uDesigner designs since designs are available as read-only in the Production Server.

Server Internal URL: Enter the Http Server URL running on 80 port which is configured with Unifier (For example: http://host1.expample.com)

Note: BI Publisher and Markup servers use this URL to communicate with Unifier.

Login Session Timeout: Login Session Timeout is used to control the amount of time a user can be idle before having to log back into Unifier. The unit is seconds. For security reasons, the recommended timeout setting is between 30 minutes and 4 hours.

Late Notice Interval: Interval, in minutes, used by the internal job server for notification tasks. The suggested interval is 15 minutes. A very small interval may degrade performance.

UPK Help URL: Enter the URL where the User Productivity Kit (UPK) help content is to be hosted (as a generic example, http://servername/contextroot, or as a specific example is http://localhost/unifierupk).

Note: Ensure that the Popup Blocker is disabled.

Unifier Help URL: To deploy a local version of the Unifier online help, enter the URL where the help file is to be hosted. By default, the online help is deployed from the Oracle Technology Network site.

Temporary Directory: Enter the temporary directory for Unifier server operations.

Repository Tab (WebCenter Content) This topic applies when you select WebCenter Content for the File Repository field.

There are two data repositories (folders in which Unifier data is stored), which Unifier requires you to configure. There are additional repositories, such as the archive directory for project archiving, that are used with specific features, as described below. These can be located on a local but separate hard drive, or on a mapped drive on your network.

File Repository: Select WebCenter Content.

WebCenter Content Server Host: This is the IP address of the WebCenter Content server.

Installing Unifier on Windows

33

WebCenter Content Server Port: This is the port of the WebCenter Content server.

WebCenter Content User: This is the user who will add documents through the API. The user should exist in the WebCenter Content server.

WebCenter Content Root Folder: The root folder in WebCenter Content under which all Unifier folders will be created. When no root folder is specified, all folders will be created under "Contribution Folders."

Notes:

It is important to plan where these directories are located because they are where Unifier data is stored. Any subsequent upgrade installations need to point to these same two directories in order for Unifier to ‘see’ data previously entered.

These repositories, in addition to your database, should be backed up regularly.

When naming the folders, be sure there are no spaces in the folder names.

These files must be on a shared drive that is accessible by other server machines that are operating in a clustering environment.

Archive Directory: For project archiving capability. Default value is d:\projectArchive. (See Appendix B: Archiving Projects for more information about archiving.)

Archive Temp Directory: For temporary archived files. Default value is d:\temp.

Report Directory: The pathname where report files are stored.

Web Service Audit Directory: This folder stores files for Web Services calls.

Dashboard Data Directory: This folder stores the .swf and XML files used with custom dashboards.

Log File Directory: The folder where the log files are stored.

Test WebCenter: Enables you to validate the the configuration settings that you have entered.

Repository Tab (Network File System) This topic applies when you select Network File System for the File Repository field.

There are two data repositories (folders in which Unifier data is stored), which Unifier requires you to configure. There are additional repositories, such as the archive directory for project archiving, that are used with specific features, as described below. These can be located on a local but separate hard drive, or on a mapped drive on your network.

File Repository: In this field, select Network File System from the drop-down list. Other options include:

CMIS: See Repository Tab (CMIS) for detailed information. SharePoint: See Repository Tab (SharePoint) for detailed information.

Notes:

Unifier Installation and Setup Guide for WebLogic Application Server

34

It is important to plan where these directories are located because they are where Unifier data is stored. Any subsequent upgrade installations need to point to these same two directories in order for Unifier to ‘see’ data previously entered.

These repositories, in addition to your database, should be backed up regularly.

When naming the folders, be sure there are no spaces in the folder names.

File Directory: Enter (or Browse to) the path where uploaded or attached files are stored. This repository is for storing documents within the Document Manager, such as drawings, plans, Word documents, etc. These files will be available for viewing or attaching to business process forms within Unifier. It also stores imported schedule files.

Note: These files must be on a shared drive that is accessible by other server machines that are operating in a clustering environment.

Index Directory: This is the pathname to the location where the Search Index files are stored.

Archive Directory: For project archiving capability. Default value is d:\projectArchive. (See Appendix B: Archiving Projects for more information about archiving.)

Archive Temp Directory: For temporary archived files. Default value is d:\temp.

Report Directory: This is the pathname to the location where report files are stored.

Web Service Audit Directory: This folder stores files for Web Services calls.

Dashboard Data Directory: This folder stores the .swf and XML files used with custom dashboards.

Log File Directory: The folder where the log files are stored.

Repository Tab (SharePoint) The following fields display when you select SharePoint in the File Repository field.

SharePoint Login Name: Login user name to the machine where SharePoint is installed.

SharePoint Password: Password for the SharePoint login name.

SharePoint Host Name: Machine name or IP address of the SharePoint server.

SharePoint Domain: The domain where the SharePoint server resides.

SharePoint Document Library URL: URL for the document library (For example: http://SPHostname/unishare/UnitTestLib_1)

SharePoint Web Service URL: The URL of the Web Service used to connect Unifier to SharePoint, as specified when you configured SharePoint. The URL includes the machine name (or IP address) of the content repository server, port number of the server, and web service name (For example: http://hostname/port/WS_FPRPC).

External Document Library URL: The URL of an external document library.

Installing Unifier on Windows

35

Notes: It is important to plan where these directories are located because

they are where Unifier data is stored. Any subsequent upgrade installations need to point to these same two directories in order for Unifier to ‘see’ data previously entered.

These repositories, in addition to your database, should be backed up regularly.

When naming the folders, be sure there are no spaces in the folder names.

These files must be on a shared drive that is accessible by other server machines that are operating in a clustering environment.

Index Directory: This folder is for index files used in Document Manager search function.

Archive Directory: For project archiving capability. Default value is d:\projectArchive. (See "Appendix B: Archiving" for more information about archiving.)

Archive Temp Directory: For temporary archived files. Default value is d:\temp.

Report Directory: This field contains the pathname for where the report files are stored.

Web Service Audit Directory: This folder stores files for Web Services calls.

Dashboard Data Directory: This folder stores the .swf and XML files used with custom dashboards.

Log File Directory: The folder where the log files are stored.

Repository Tab (CMIS) The following fields display when you select CMIS in the File Repository field.

CMIS Login Name: Enter the user name for your content repository.

CMIS Password: Password for the CMIS login name.

CMIS Repository Name: The content repository name.

CMIS Documentation Home: The documentation home.

CMIS Web Service URL: The URL for your web services home.

Notes: It is important to plan where these directories are located because

they are where Unifier data is stored. Any subsequent upgrade installations need to point to these same two directories in order for Unifier to ‘see’ data previously entered.

These repositories, in addition to your database, should be backed up regularly.

When naming the folders, be sure there are no spaces in the folder names.

Unifier Installation and Setup Guide for WebLogic Application Server

36

These files must be on a shared drive that is accessible by other server machines that are operating in a clustering environment.

Index Directory: This folder is for index files used in Document Manager search function.

Archive Directory: For project archiving capability. Default value is d:\projectArchive. (See "Appendix B: Archiving Projects" for more information about archiving.)

Archive Temp Directory: For temporary archived files. Default value is d:\temp.

Report Directory: The pathname where report files are stored.

Web Service Audit Directory: This folder stores files for Web Services calls.

Dashboard Data Directory: This folder stores the .swf and XML files used with custom dashboards.

Log File Directory: The folder where the log files are stored.

Database Tab (Oracle) The information entered in this tab is based on your earlier database and user account creation.

Database Type: Select Oracle.

Database Name: This field is not applicable for Oracle.

Database Name: Leave it Blank.

Host Name: Enter the host name of the computer where you installed the database.

Instance ID: The Instance ID field in the Configurator can accept the following values:

An MS SQL server instance iD An Oracle SID An Oracle service name (Oracle DB 12c)

When you enter a service name for an Oracle service name (Oracle DB 12c), you must preface the name with a forward slash (/), for example, /servicename.

If you do not preface the name with a forward slash (/), the system presumes that you have:

Entered an Oracle SID, if you had selected Oracle from the drop-down list. or

Entered an MS SQL server instance iD, if you had selected SQL Server from the drop-down list.

Port: Enter the Port number to be used by Unifier to communicate with the database (For example: 1521).

User Name: Enter the database login user account name (created in Oracle) to be used by Unifier. The database login user account needs to have sufficient permissions to create tables in order for Unifier to work correctly.

User Password: Enter the database login user account password to be used by Unifier.

Installing Unifier on Windows

37

Max. Connections: The setting that defines the maximum connections to the database. The maximum is 400; the recommended maximum is 80 to 100.

Min. Connections: The setting that defines the minimum connections that must be connected to the database.

Test Connection: Click Test Connection to verify that the Application server and the database are connected and communicating. A Test is successful message will appear if test is successful. Two conditions are tested:

Ability of Unifier to connect to the database Level of permissions granted to the database login user account

Database Tab (MS SQL Server) The information entered in this tab is based upon your earlier database and user account creation.

Database Type: Select MS SQL Server to configure for Microsoft SQL Server.

Database Name: Enter the database name (if applicable).

Host Name: Enter the host name of the computer where you installed and configured Microsoft SQL Server database.

Instance ID: If you did not specify an instance name when configuring the SQL Server, leave the Instance ID field blank. Otherwise, enter the Instance ID.

Port: Enter the Port number to be used by Unifier to communicate with the Microsoft SQL Server database.

User Name: Enter the database login user account name for the Microsoft SQL Server database to be used by Unifier.

User Password: Enter the database login user account name password for the Microsoft SQL Server database to be used by Unifier.

Max. Connections: The setting that defines the maximum connections to the database. The recommended setting is 100.

Min. Connections: The setting that defines the minimum connections that must be connected to the database. Click Test Connection to verify that the Application server and the Microsoft SQL Server database are connected and communicating.

Test Connection: Enables you to validate the the configuration settings that you have entered.

Email Tab Outbound (SMTP) E-mail Server: (Required) Enter the IP address for the outbound SMTP email server information in this filed.

System Notification E-mail Address: This field contains the email ID that the system displays as the "Sender’s" email address for all emails generated by the Unifier system, for example, [email protected].

Unifier Installation and Setup Guide for WebLogic Application Server

38

E-mail Sender Prefix: Enter the email prefix that will be used in the Sender’s name whenever an email is generated from a user from within Unifier, for example, Unifier. Late email notifications show the E-mail Sender Prefix, only.

E-mail Login URL: The URL included in all email notifications sent to the users who have logged in to the system. Ensure that this URL is the same as "Server Internal URL" which is entered in General tab.

Note: This field must contain the fully qualified server name in order to establish a successful connection to the application server; otherwise, the interactive login will not work.

Support Contact Information: This field contains the message text that is included in all support-related email notifications.

Note: To enable an email address as a hyperlink, use the following format: <a href="mailto:[email protected]">[email protected]</a>

System Error Notification E-mail Address: This field contains the email address where Unifier sends a notification if Unifier loses connection to the database while the system is running. The email addresses can be separated by semicolon.

License Notification E-mail Address: This field contains the email address where Unifier sends licensing notifications, for example, if the number of users exceeds the number of available licenses. The email addresses can be separated by semicolon.

Inbound E-mail protocol: Select the protocol used by the inbound email server that can receive email. The supported protocols are POP3, IMAP, POP3S, and IMAPS.

Note: Each Unifier environment (Staging/Production) must be configured with its own inbound email account. To prevent undesired results, do not use the same inbound email for all the environments.

Inbound E-mail Server: Enter the server that can receive email, for example, if a user takes action via email on a business process. This can be the server name or IP address.

(Optional) You can specify the port number after the server name of IP address, for example, example.com:1521.

Inbound E-mail Account: Enter the email account to receive response email from the user.

Note: To use the project or shell Mailbox, which allows external email messages to be sent to and stored within a central project or shell mailbox, use the following format for the inbound email account. This allows acceptance of inbound emails sent to the system-generated project/shell email addresses: *[email protected]. This configuration is needed on the email server, not within the Unifier Configurator.

Inbound E-mail Password: This field contains the password that corresponds to the inbound email account. This password is used when email is retrieved.

Installing Unifier on Windows

39

Test Inbound E-mail Account: Enables you to validate the the configuration settings that you have entered.

Note: Click Test Inbound E-mail Account to test the Inbound E-mail Server, Inbound E-mail Account, and Inbound E-mail Password.

About Inbound E-mail This Project Mailbox functionality rely on email address used for BP Action via Email. If the Inbound email address is [email protected], then the email address of a Project/Shell could be one of the following, depending on the property value in the skire.project.email.pattern in skire.properties file. This property can have two values: "prefix" or blank and "suffix."

In case the property value is "prefix" or blank

The email address of any Unifier Project/Shell will follow the pattern <project id>[email protected] used for Project Mail box functionality. For example, if the project id is 1001, then email address for this particular Project/Shell will be [email protected]. For this to function, you have to set up an email forwarding rule on your mail server such that any emails sent to .*[email protected] will be automatically forwarded to [email protected] Inbox.

In case the property value is "suffix"

The email address of any Unifier Project/Shell will follow the pattern unifier_oracle+<project id>@unifiermail.com used for Project Mail box functionality. For example, if the project id is 1001, then email address for this particular Project/Shell will be [email protected]. For this to function, you have to set up an email forwarding rule on your mail server such that any emails sent to unifier_oracle+.*@unifiermail.com will be automatically forwarded to [email protected] Inbox.

Note: If you are using an email address on oracleindustry.com domain, you must use the "suffix" pattern, and you must, explicitly, set skire.project.email.pattern=suffix because this property is not exposed in current Unifier configurator. The email forwarding rule (for suffix pattern) is enabled on this domain by default.

On Unifier configurator, ensure that you include the port number for the current protocol in Inbound E-mail Server field, for example, unifiermail.com:110 or oracleindustry.com:993. The protocol and port mapping are as follows:

POP3 - port 110 IMAP - port 143 IMAPS - port 993 POP3S - port 995

Unifier Installation and Setup Guide for WebLogic Application Server

40

To prevent the spam emails to go in the Project Mail box, the system accepts emails from email addresses associated with Unifier user account or the email addresses listed in Approved Email List by Company Admin, only.

Markup Server Tab Use Server Internal URL: (Optional) Select this option only if server internal URL address must be used by markup server to communicate with Unifier. If not selected (default), The User's login base URL address is used by markup server to communicate with Unifier.

Markup Server Host Name: Enter the host name of the markup server.

Markup Server Port: Enter the port number of the markup server. The default port number for AutoVue is 5099.

Report Tab BIP Endpoint URL: Enter the BIP Web Services endpoint URL. For example: http://host1.example.com:1521

BIP User Name: Enter the user name created for the BI Publisher server.

BIP Password: Enter the password for the BI Publisher user.

BIP Data Source: Enter the JDBC data source name that was entered when the JDBC Data Source BI Publisher

BIP Report Folder: The folder under the default location in the BI Publisher catalog. Reports reside in this folder based on company registry.

Note: The values used in the BIP User Name, BIP Password, BIP Data Source, and BIP Report folder fields are the same as those created when using the Configuring BI Publisher for Primavera Unifier document.

OBIEE Analytics URL: The URL to OBIEE Analytics service. This URL should be accessible via internet.

Test Connection: Enables you to validate the the configuration settings that you have entered.

Geo Map Tab Map Server Url: Enter https://elocation.oracle.com. This is the Oracle Map server base URL where the Oracle MapVeiwer application is deployed with the context "mapviewer". This is where the server obtains the map image.

Map Tile: Enter elocation.world_map. This is the name of the map tile layer (the base map used for map rendering) that was pre-defined on the Oracle Map server. This is the map data source.

Map Geocoder Url: Enter https://elocation.oracle.com. This is the server URL where the Oracle Geocoder application is deployed with the context "geocoder." This is the location service.

Installing Unifier on Windows

41

Authentication Tab (Native) User Authentication Type: Native

The Unifier default authentication mechanism is used.

Authentication Tab (OIM/OAM) User Authentication Type: OIM/OAM

The system determines whether integration of Primavera Unifier with Oracle Identity Manager (OIM) and Oracle Access Manager (OAM) is enabled.

SSO Logout: The logout URL for Oracle Access Manager (OAM) or any third-party Single Sign On (SSO) configuration. For more details, refer to Oracle Access Manager documentation.

Authentication Tab (WebLogic) User Authentication Type: Weblogic

Form-based authentication is used to integrate with WebLogic authentication methods. After WebLogic authenticates the user, Unifier determines if the user is a valid Unifier user before granting access to the application.

Realm: Weblogic realm that is used for authentication.

Group(s) (comma separated): Weblogic group name, a comma separated list, used for mapping Weblogic groups to "unifieruser" role.

Authentication Tab (LDAP Simple Bind) The Lightweight Directory Access Protocol (LDAP) is a protocol for querying, and modifying, directory services. The Administrator can configure the server to use either simple-bind or double-bind authentication.

User Authentication Type: LDAP Simple Bind

Provider: To connect the LDAP server (URL), for example, ldap://ldap.zyz.com:636

SSL: To connect to the Secure Sockets Layer (SSL) enabled port of the LDAP server.

Note: Oracle recommends you always use SSL in a production environment for secure communications.

When Unifier is configured with JDK 8 and integrated with LDAP SSL:

Add "-Djdk.tls.client.protocols=TLSv1" Java option to setenv.sh file. Restart Unifier.

The above settings enable you to log in using LDAP SSL.

Example Setting in setenv.sh file: export JAVA_OPTIONS="$JAVA_OPTIONS

Unifier Installation and Setup Guide for WebLogic Application Server

42

-Djavax.xml.parsers.DocumentBuilderFactory=com.sun.org.apache.xerces.internal. jaxp.DocumentBuilderFactoryImpl -Djdk.tls.client.protocols=TLSv1"

Security Principal Template: To authenticate directly, based on the user name and password (Simple Bind). The template is used to construct the user's Distinguished Name (DN), for example, cn={0},l=amer,dc=oracle,dc=com

Admin User Bypass: To allow administrators to bypass LDAP login.

Authentication Tab (LDAP Double Bind) The Lightweight Directory Access Protocol (LDAP) is a protocol for querying, and modifying, directory services. The Administrator can configure the server to use either simple-bind or double-bind authentication.

User Authentication Type: LDAP Double Bind

Provider: To connect the LDAP server (URL), for example, ldap://ldap.zyz.com:636

SSL: To connect to the Secure Sockets Layer (SSL) enabled port of the LDAP server.

When Unifier is configured with JDK 8 and integrated with LDAP SSL:

Add "-Djdk.tls.client.protocols=TLSv1" Java option to setenv.sh file. Restart Unifier.

The above settings enable you to log in using LDAP SSL.

Example Setting in setenv.sh file: export JAVA_OPTIONS="$JAVA_OPTIONS -Djavax.xml.parsers.DocumentBuilderFactory=com.sun.org.apache.xerces.internal. jaxp.DocumentBuilderFactoryImpl -Djdk.tls.client.protocols=TLSv1"

Provider Base: (Optional) When you select the Double Bind method of authentication, you need to find the user's DN and then authenticate them. Finding the user's DN is used as the base for searching the LDAP tree. If the Provided Base is not set, the root is assumed by the system: ldap.provider.base

Authorized User: When using the Double Bind method of authentication, find the user's Distinguished Name (DN) and then authenticate. This is used as the "trusted" or "search" login user's DN (first bind).

Authorized User Password: When using the Double Bind method of authentication, this is the authorized user's login password.

Search Field: The default value is "cn." You need to enter the node field that you want to search.

Admin User Bypass: To allow the administrator bypass the LDAP login.

Authentication Tab (Generic SSO) User Authentication Type: Generic SSO

Installing Unifier on Windows

43

SSO Header: The Single Sign On (SSO)

SSO Logout: The logout URL for Oracle Access Manager (OAM) or any third-party Single Sign On (SSO) configuration. For more details, refer to Oracle Access Manager documentation.

Saving the Configuration Settings

You must save your configuration data to a configuration file. In the Unifier Configuration window, click File, Save.

Note: Restart Unifier for the changes to be operative.

Changing Configuration Settings

After initially installing and configuring Unifier, follow this procedure to make any subsequent changes to the configuration settings:

1) Stopping Unifier in WebLogic (on page 43) 2) Editing Configuration Data (on page 43) 3) Starting Unifier in WebLogic (on page 43)

Stopping Unifier in WebLogic To stop the Unifier application in WebLogic:

1) Open the WebLogic directory within the Unifier Home folder. 2) Run the stop.bat file. 3) If prompted, enter the WebLogic user name and password.

Editing Configuration Data After stopping Unifier in WebLogic, make changes to the Unifier configuration settings as follows:

1) In the WebLogic directory within the Unifier Home folder, locate the configure.bat file. 2) Run configure.bat. 3) Make necessary configuration changes, and then click File, Save. 4) Restart Unifier in WebLogic.

Starting Unifier in WebLogic After a new installation, Unifier must be stopped before you can make any changes to the configuration settings. Be sure to restart it afterward.

To start the Unifier application in WebLogic:

1) Open the WebLogic directory within the Unifier Home folder. 2) Run the startup.bat file. 3) If prompted, enter the WebLogic user name and password.

Unifier Installation and Setup Guide for WebLogic Application Server

44

Copying the Configuration Data File

The configuration data for the Configurator is stored automatically under the installation folder in the /configurator/bluedoor.properties file. If necessary, you can transfer the configuration settings from one environment to another by copying the configuration data file and editing it with the new configuration settings.

Configuring the Oracle HTTP Server (OHS)

After installing Oracle HTTP Server (OHS), configure as follows:

1) Modify the $ORACLE_INSTANCE/ config/ OHS/ ohs1/httpd.conf file as follows: a. Change the default listen port from 7777 to 80.

Note: Before making the above change, disable or turn-off any other application that is using port 80 (such as IIS or Windows).

b. Add settings after DocumentRoot as follows: DocumentRoot <Unifier_Home>/apps/ROOT

c. Add parameters between <Directory ></Directory> so it appears as follows: <Directory "<Unifier_Home>/apps/ROOT">

Options Includes FollowSymLinks AllowOverride None Allow from all Order allow,deny DirectoryIndex index.html

</Directory> <Directory "<Unifier_Home>/apps/ROOT/WEB-INF">

Deny from all </Directory>

d. #Support Http method GET/POST only RewriteEngine On RewriteCond %{REQUEST_METHOD} !^(GET|POST) RewriteRule .* - [F]

Notes:

<Unifier_Home> is the unifier installation directory. The session about Supporting Http method GET/POST only can be

(or may be) added at the end of http.conf file.

2) Add the following to the $ORACLE_INSTANCE/ config/ OHS/ ohs1/mod_wl_ohs.conf file: <LocationMatch /(bp|bluedoor|g|pub|m|portal|viewbp|ws|VueServlet|jvueDMS|xdespellchecker)($|/)>

Installing Unifier on Windows

45

SetHandler weblogic-handler WebLogicHost localhost WebLogicPort 7001 </LocationMatch> <LocationMatch /(dojo|gs|studio|unifier_js|webant|x)($|/)> ExpiresActive on ExpiresDefault "access plus 6 month" </LocationMatch> LoadModule deflate_module "${ORACLE_HOME}/ohs/modules/mod_deflate.so" before <LocationMatch /(bp|bluedoor|g|pub|portal|viewbp)($|/)> SetOutputFilter DEFLATE </LocationMatch> DeflateBufferSize 20000

Note: Modify these entries under <Location /> as necessary:

For WebLogicHost: Weblogic server hostname or IP address. For WebLogicPort: Weblogic server port number.

3) Modify the $ORACLE_INSTANCE/ config/ OHS/ ohs1/ssl.conf file as follows: Replace: SSLProtocol nzos_Version_1_0 nzos_Version_3_0 With: SSLProtocol -all +SSLv3 Replace: SSLCipherSuite SSL_RSA_WITH_RC4_128_MD5,SSL_RSA_WITH_RC4_128_SHA,SSL_RSA_WITH_3DES_EDE_CBC_SH A,SSL_RSA_WITH_DES_CBC_SHA,TLS_RSA_WITH_AES_128_CBC_SHA,TLS_RSA_WITH_AES_256_C BC_SHA With: SSLCipherSuite HIGH

4) Run opmnctl.sh to restart the OHS server.

Installing SSL Certificate (Optional)

Unifier works in Secure or Non-secure mode. Installing a Secure Socket Layer (SSL) certificate is optional.

Data Backup Recommendations

Oracle Primavera recommends that Primavera Unifier data be incorporated into your company backup procedures. Primavera Unifier data is stored in two places:

Unifier database Files Repository

These repositories need to be backed up regularly.

Unifier Installation and Setup Guide for WebLogic Application Server

46

Deploying Unifier

To deploy Unifier into the WebLogic domain, complete the following procedures:

1) Creating an EAR File From the Configurator (on page 46) 2) Deploy the generated EAR file using any of the following methods: Deploying Unifier From the Unifier_Home Directory (on page 46) Deploying Unifier from the WebLogic Administration Console (on page 46)

Creating an EAR File From the Configurator

Complete the following steps to create an .EAR file from the configurator:

1) Access the Configurator. 2) In the configurator, select File, Create EAR. 3) By default, the .EAR file is created in the unifier/weblogic directory. 4) Save the file as unifier.ear. 5) Proceed to deploy unifier.ear in WebLogic using any of the following methods: Deploying Unifier From the Unifier_Home Directory (on page 46) Deploying Unifier from the WebLogic Administration Console (on page 46)

Deploying Unifier From the Unifier_Home Directory

After creating the .EAR file, deploy Unifier as follows:

1) In the <unifier_home>\weblogic directory edit the setenv.bat file as follows: Set the domain_home variable to specify the path of the domain home folder that will be

used by Unifier. Set the admin url variable to specify host name and port number used by the Unifier

domain. Set the java_home variable to the JDK installed directory.

2) Save setEnv.bat. 3) Run startup.bat. 4) Run deploy.bat. 5) When prompted, enter the WebLogic user name and password.

Unifier is deployed in WebLogic using the variables set in setEnv.bat.

Note: This process may take several minutes.

Deploying Unifier from the WebLogic Administration Console

After creating the .EAR file in the Configurator, deploy the file from the WebLogic Administration Console as follows:

1) In the Change Center pane, select Lock & Edit.

Installing Unifier on Windows

47

2) In the Domain Structure pane, select Deployments. 3) In the Summary of Deployments pane, select Install. 4) In the Install Application Assistant pane:

a. Specify the path to the unifier.ear file and click Next. For example: c:\<unifier_home>\weblogic\unifier.ear.

b. Select Install this deployment as an application and click Next. c. Accept the defaults and click Next. d. Review the configuration settings you have chosen and select Finish to complete the

installation. 5) In the Settings for unifier window, select Save. 6) In the Change Center pane, select Activate Changes. 7) In the Domain Structure pane, select Deployments. 8) In the Summary of Deployments pane:

a. Select unifier. b. Select the down arrow to the right of the Start button and select Servicing all requests.

9) In the Start Application Assistant pane, select Yes.

Note: The unifier state column should be Active. If the state is Start Running, refresh the screen until the status is changed to Active.

Launching Unifier

This section describes how to:

Start Unifier for the first time Install Unifier applications Set up your company

Before launching Primavera Unifier, ensure that you have read the Getting Started section of the Unifier Help, which contains important information about configuring your browser for use with Primavera Unifier.

Unifier URL (WebLogic)

In your browser, navigate to the URL that launches the Unifier application locally. For example: http://unifier.oracle.com:7001

Starting Unifier for the First Time

In the Sign In window, sign in to Unifier with the default Administrator username (Administrator) and password (Administrator).

Unifier immediately prompts you to change your password. We recommend you do so immediately for security reasons. Once you change your password, Unifier creates your Administrator account.

Unifier Installation and Setup Guide for WebLogic Application Server

48

The Administrator account is the only account with permissions automatically set for all features. The Administrator cannot be a member of any project, even if created in the Hosting Company.

Installing Unifier Applications

This section describes how to install the Unifier applications for your company.

Notes:

The following procedures must be performed by the Site Administrator, after the required Unifier applications (Primavera Unifier, or Primavera Unifier and Primavera Unifier Project Controls) have been downloaded and stored locally. See Downloading Unifier section for details.

If you receive an error message, try reinstalling the application. If reinstalling the application also results in receiving an error message, contact Oracle Support.

When you sign in as the Site Administrator, Unifier shows you the Home tab in Administration Mode.

1) In the left Navigator, click Applications node. Unifier displays an install panel on the right-hand side of the window.

2) Click Install to open the “Install Primavera Unifier Application” window. Use the information in the table below to complete the fields in the window and when finished, click Install.

Note: Ensure that the Temporary directory is set in the configurator (General tab).

In this field: Do this:

Select Downloaded Application to Install

Application File Browse to where the applications are stored and select the application you want to install. Note that you should point to the .zip file and that .zip file does not need to be previously extracted.

Set preconfigured designs as unpublished Note: This option is available in Staging environment. This option is not available in Production environment.

Selecting this option allows users to be able to modify designs (business processes and attribute forms) in the Staging environment, after Unifier is installed. See the following Unifier Environments topics for details.

Company Details

Name Enter the name of the company.

Installing Unifier on Windows

49

In this field: Do this:

Short Name Enter a one-word short name, up to 8 characters. The Short Name is a unique, one-word abbreviated form of your company name, and is used throughout Primavera Unifier in place of the company name. (For example, when importing uDesigner-created business processes, and on logs that identify partner companies.)

Currency Enter the default currency that will be used by the company.

Contact Email Enter the email address that will be used for all emails sent from the Support link in Unifier.

Licensed Users Enter the number of users who will be licensed to use the application.

Address Type Identify the address you are entering, such as Headquarters, Billing Office, or Satellite Office.

Address Enter the company address.

City Enter the city for the address.

State/Province Enter the state or province for the address.

Zip Enter the zip code for the address.

Country/Region Enter the country or region for the address.

Admin Login Username Enter the company administrator’s user name. Default is coadmin. This user name will be automatically added to the Company Administrators group. Note: The coadmin user by default gets all the permissions for the new designs or new modules. Essentially this user that is company administrator will have all the permissions across the company and projects.

Password Enter the administrator’s password.

Confirm Password Re-enter the password.

Unifier Environments There are two Unifier environments:

Staging environment Production environment

The Site Administrator can install the platform version of the product (Primavera Unifier) in both Staging and Production environments.

Unifier Installation and Setup Guide for WebLogic Application Server

50

Note: In this type of installation, the new designs created in the Staging environment are unpublished until the creation of Production design bundle creation. After Production design bundle is created, all designs that are tagged for Production will be published.

The Site Administrator can install the Project Controls version of the product (Primavera Unifier Project Controls) in both Staging and Production environments; however, Oracle recommends that the Administrators avoid installing the Project Controls version of the product in Production environment, if the users plan on modifying the preconfigured designs.

The following section explains the recommended setup (which downloaded folders must be placed in which environment):

Platform version of the product (Primavera Unifier) Staging The BASIC files The main Unifier application files ("unifier_#.zip" (where # represent the Unifier version

number) folder) Production The BASIC files The main Unifier application files ("unifier_#.zip" (where # represent the Unifier version

number) folder)

Project Controls version of the product (Primavera Unifier Project Controls) Staging The main Unifier application files ("unifier_#.zip" (where # represent the Unifier version

number) folder) The files in the main zip folder from Primavera Unifier Project Controls download

Production The main Unifier application files ("unifier_#.zip" (where # represent the Unifier version

number) folder)

Note: Since the content of the material created by the Users (also known as Custom Strings) can be translated into different languages, with the exception of data or value entered by the user, you (Unifier Administrator) must sign in to Unifier, navigate to the Company, expand the Configuration node, select the Internationalization node, click Refresh drop-down list, and select All Strings to populate the Custom String table. If you do not refresh after the installation, certain Unifier functions will not work properly.

Deploying Unifier Online Help

By default Unifier online help is deployed from the Oracle Technology Network site. To deploy Unifier help locally, or from an alternative URL, proceed as follows:

Installing Unifier on Windows

51

1) From the Help topic of the Primavera Unifier Online Documentation Library, download help.zip.

2) Extract the contents of the help.zip to the folder specified in the Unifier Help URL field in the General tab of the Configurator.

53

Complete the following procedures to install and configure Unifier for a first time installation. Each step corresponds to a section in this guide.

Note: Before you begin, create an installation account that has full administration privileges for the server. This account is needed for maintenance and upgrades.

1) Download Unifier. 2) Configure the database server.

Complete this step before configuring Unifier. This information will be used during database configuration in Unifier Configurator.

3) Configure WebLogic for Unifier. 4) Install and configure the Reports Server. (Optional) 5) Install Oracle WebCenter Content. (Optional) 6) Install AutoVue Server. 7) Configure Unifier using the Configurator. 8) Configure the Web Server. 9) Deploy Unifier in WebLogic. 10) Launch Unifier and install Unifier applications.

In This Section

Downloading Unifier ................................................................................................ 53 Configuring the Oracle Database Server ................................................................. 54 Installing the AutoVue Server .................................................................................. 55 Configuring WebLogic for Unifier ............................................................................. 57 Installing and Configuring the Reports Server (Optional) ......................................... 59 Installing Oracle WebCenter Content (Optional) ...................................................... 60 Configuring Unifier Using the Configurator ............................................................... 60 Configuring the Oracle HTTP Server (OHS) ............................................................ 61 Deploying Unifier ..................................................................................................... 63 Launching Unifier ..................................................................................................... 65

Downloading Unifier

1) Go to Oracle Software Delivery Cloud (https://edelivery.oracle.com/) and sign in 2) Navigate to access the Primavera Unifier page 3) Click Readme to open the "Primavera Unifier Media Pack" page and read the information

about:

Installing Unifier on Linux

Unifier Installation and Setup Guide for WebLogic Application Server

54

Licensed Products and Restrictions for Primavera Unifier Download Requirements Contacting Unifier Customer Support Access to Oracle Support

4) Close the "Primavera Unifier Media Pack" page

The Primavera Unifier download provides the necessary files for installing the platform version of the product, only. The platform version of Unifier contains all the Unifier modules and allows the users to create their own designs (business processes and attribute forms). This version of Unifier does not have preconfigured designs.

The Primavera Unifier Project Controls download provides the files containing the preconfigured designs (business processes and attribute forms), only.

Note: If your licensing agreement includes Primavera Unifier Project Controls, you must first download the Primavera Unifier and then proceed to downloading the Primavera Unifier Project Controls. The Primavera Unifier Project Controls download folder does not have the main Unifier application.

See the Installing Unifier Applications section for additional information.

Refer to the:

Primavera Unifier What's New document to learn about enhancements to Primavera Unifier. Primavera Unifier Cumulative Feature Overview Tool (spreadsheet) to identify the features

that have been added to Unifier since a specific release level.

Configuring the Oracle Database Server

The following is an overview of the steps required to configure the Oracle database for use with Unifier. For more information and specific instructions, refer to your Oracle documentation.

Configure an Oracle database for Unifier as follows:

1) Create an instance for the database.

Note: You can accept the defaults except for the following: Ensure to set encoding to Unicode (UTF-8).

2) Create a user account on the newly created database. For successful Primavera Unifier/uDesigner installation, make sure ample free space of at least 2GB is available for the default tablespace where the new user will be located.

3) Grant the new user with connect, resource, create view, and create table privileges.

Note: This information will be used later for setting database information in the Database tab of the Unifier Configurator.

For example: create user unifier identified by unifier

Installing Unifier on Linux

55

temporary tablespace temp default tablespace users; grant connect, resource, create view, create table to unifier;

Notes:

(Required) Ensure that maximum open cursor in Oracle DB is set to 1000, or above.

Ensure that Database user quota is set to unlimited on tablespace users.

Installing the AutoVue Server

AutoVue installation is mandatory if you plan to use Unifier Markup feature, also referred to as redlining.

When attaching documents to a Business Process (BP) form, you can add markups (text notes or graphical elements) that display directly on the document.

Note: The markups do not alter the document.

This section describes the following procedures:

Downloading and installing AutoVue Configuring AutoVue Deploying Custom GUI AutoVue applets

Notes:

You must have a license to install AutoVue. The AutoVue server is high-intensive with regard to CPU, I/O,

memory, and graphics. So, for optimal performance, ensure that the machine running the AutoVue server is not being used for other applications.

For more information, refer to Oracle AutoVue Client/Server Deployment Installation and Configuration Guide available on Oracle Documentation website.

For the full list of system requirements and versions, see the Unifier Tested Configurations document under “Installation and Configuration Documentation” in the Primavera Unifier Online Documentation Library.

Downloading and Installing AutoVue

Download and install AutoVue as follows:

1) Go to the Oracle Software Delivery Cloud (https://edelivery.oracle.com/ (https://edelivery.oracle.com/)) and sign in.

2) From the Product field list select Oracle AutoVue 3D Professional Advanced.

Unifier Installation and Setup Guide for WebLogic Application Server

56

3) Click Select Platform and select Microsoft Windows (32-bit)/Linux x86 and then click Continue.

4) Review the information under Available Release, and then click Continue. 5) Accept the terms, and then click Continue. 6) Click the zip file and then click Download All to download:

1. V74040-01.zip Oracle AutoVue 3D Professional Advanced 20.2.3 (Windows) 2. V74008-01.zip Oracle AutoVue 3D Professional Advanced 20.2.3 (Linux x86)

The download may take a few minutes to complete. After the download is completed:

1) Extract the zip file and go to this directory in which you have extracted the zip file. 2) Run the AutoVue installer executable:

1. InstallClientServer.exe (Windows) 2. InstallClientServer_lin.bin (Linux x86)

3) Go to the directory in which you have extracted the zip file. 4) Locate the jvueserver.properties file and open. 5) Add the following line at the end of the <AutoVue install

dir>\bin\jvueserver.properties file: jvueserver.authentication.enable=false

Configuring AutoVue

After installing AutoVue, configure AutoVue by entering information in the following tabs of the Unifier Configurator:

In the General Tab, enter the Server internal URL field to access AutoVue. In the Markup Server Tab, complete all fields in this tab.

For more information about the General and Markup Server tabs, see the Specifying Unifier Configurator Settings (on page 20) section.

Deploying Unifier GUI Applets to AutoVue

AutoVue provides the option of customizing third-party graphical user interface (GUI). The following Unifier applet GUI files are provided to integrate with AutoVue: default.gui defaultcons.gui defaultNoMarkup.gui defaultview.gui

To deploy the Unifier applet GUI files to AutoVue:

1) Download the current version of the Primavera Unifier Tools file from the Oracle Software Delivery Cloud (https://edelivery.oracle.com/ (https://edelivery.oracle.com/)).

2) Unzip the AutoVueMenus.zip file into the location specified in the jvueserver.users.directory parameter in the <AutoVue install dir>\bin\jvueserver.properties file.

Installing Unifier on Linux

57

3) Follow the recommendation in the Oracle AutoVue 20.2.3 documentation site: http://docs.oracle.com/cd/E60531_03/otn/docset.html

Configuring WebLogic for Unifier

This section describes how to configure WebLogic for Unifier on a Linux 64-bit operating system. It includes:

Creating a WebLogic Domain for Unifier (on page 57) Starting the WebLogic Admin Server (on page 58) Stopping the WebLogic Admin Server (on page 58) Configuring WebLogic and OHS as a Service (on page 58)

Creating a WebLogic Domain for Unifier

To create a WebLogic domain:

1) Run the WebLogic Configuration Wizard. 2) In the Welcome window:

a. Select Create a new WebLogic domain. b. Click Next.

3) In the Select Domain Source window, click Next to accept the default selections. 4) In the Specify Domain Name and Location:

a. Enter a domain name for the new domain to be created. b. Enter the location of the new domain on the server. c. Click Next.

5) In the Configure Administrator User Name and Password window: a. Enter the User Name and Password for the Administrator that will be created. This user

name will be used to login to the WebLogic console. b. Click Next.

6) In the Configure Server Start Mode and JDK window: a. In the left pane, select Production Mode. b. In the right pane, select the JDK you installed earlier. c. Click Next.

7) In the Select Optional Configuration window: a. Select the Administration Server option. b. Click Next.

8) (Optional) In the Configure the Administration Server window: a. Select the SSL enabled option and set the SSL listen port if you are enabling Secure

Sockets Layer communication. See http://download.oracle.com/docs/cd/E12840_01/wls/docs103/secmanage/ssl.html for more details on setting SSL for WebLogic.

Unifier Installation and Setup Guide for WebLogic Application Server

58

Note: Oracle recommends you always use SSL in a production environment for secure communications.

b. Click Next. 9) In the Configuration Summary window, click Create. 10) Click Done after the domain is created. 11) When prompted, enter the Administrator User Name and Password that you entered above.

Starting the WebLogic Admin Server

To deploy Unifier in WebLogic, start the Admin server as follows:

1) Change to the weblogic_home/user_projects/domains/your_domain directory. 2) Run the startWebLogic.sh script. 3) If prompted for a user name and password in the WebLogic console window, type in the

administrative user name and password you specified when creating the domain.

Note: If you turned on the WebLogic precompile option, the WebLogic console displays "Server started in RUNNING mode" when precompiling finishes. For detailed information about turning on precompilation, see your WebLogic Server documentation.

Stopping the WebLogic Admin Server

When you are finished working in the WebLogic Administration Console, stop the WebLogic admin server as follows:

1) Change to the weblogic_home/user_projects/domains/domain_home/bin directory.

2) Run the stopWebLogic.sh script. 3) If prompted for a user name and password in the WebLogic console window, enter the

administrative user name and password that was specified when creating the domain.

Note: The WebLogic console window will close automatically at shutdown.

Configuring WebLogic and OHS as a Service

Complete the following steps to install WebLogic and Oracle HTTPS Server (OHS) as a service on a Linux 64-bit operating system.

1) Set WL_HOME as system environment variable or modify it in <unifier_home>/weblogic/setenv.sh. WL_HOME is the root directory of the WebLogic installation. For detailed instructions, refer to the topic, Creating a WebLogic Domain for Unifier (on page 17) to create the Domain Home for weblogic. For example: C:\Oracle\Middleware\wlserver_11\server

Installing Unifier on Linux

59

2) Set the environment variables for Unifier. For detailed instructions, refer to Changing Unifier Configurator Settings (on page 31).

3) For WebLogic installed in production mode, create boot.properties at $DOMAIN_HOME/servers/<server_name>/security.

4) Ensure all variables are set for a ROOT_USER. 5) Login to Linux as a ROOT_USER. 6) In the <unifier_home>/weblogic/unifier, modify values for the following parameters: OHS_INSTANCE_HOME: The home directory of OHS. UNIFIER_HOME: The home directory of Primavera Unifier. OHS_USER: User who can start OHS. Alternatively, locate the user in the httpd.conf file. WL_USER: User who can start WebLogic.

Note: Change the command to start weblogic in accordance to the user privilege on the system.

7) Ensure that when the server is restarted the Xvfb process is also started with the same DISPLAY value as follows for the ROOT_USER: a. Install Xvfb

yum install Xvfb b. start Xvfb

locate Xvfb (where Xvfb is installed) /usr/bin/Xvfb :99 -screen 0 1x1x8 &

c. Edit the unifier file to add: export DISPLAY=:99 8) Copy the unifier script into the /etc/rc.d/init.d folder 9) To make the file executable, run the command: chmod 755 unifier 10) To add the service at system reboot, run the command: chkconfig --add unifier 11) To start the unifier service from the console, run the command: service unifier start Stopping the Service

To stop the unifier service from the console, run the command: service unifier stop

Uninstalling the Service

To remove the service, run the command: chkconfig --del unifier

Installing and Configuring the Reports Server (Optional)

Consult your Oracle documentation for instructions on installing Oracle Business Intelligence Publisher 11g.

For the full list of system requirements and versions, see the Tested Configurations document under “Installation and Configuration Documentation” in the Primavera Unifier Online Documentation Library.

For configuration information for integrating Unifier and BI Publisher, see the Configuring BI Publisher for Primavera Unifier document.

Unifier Installation and Setup Guide for WebLogic Application Server

60

Installing Oracle WebCenter Content (Optional)

Consult Oracle documentation for instructions on installing the Oracle WebCenter. For configuration information for integrating Unifier and WebCenter content, see the Connecting the Content Repository to Primavera Unifier document.

Configuring Unifier Using the Configurator

This section describes how to use the Unifier Configurator to configure Unifier.

Editing the SetEnv.sh File

Ensure that the following variables are saved in the setenv.sh file:

Set the domain_home variable to specify the path of the domain home folder that will be used by Unifier.

Set the admin_url variable to specify host name and port number used by the Unifier domain. Set the java_home variable to the JDK installed directory.

Saving the Configuration Settings

You must save your configuration data to a configuration file. In the Unifier Configuration window, click File, Save.

Note: Restart Unifier for the changes to be operative.

Changing Configurator Settings

After initially installing and configuring Unifier, you must follow this procedure to make any subsequent changes to the configuration settings:

1) Stopping Unifier in WebLogic (on page 60) 2) Editing Configuration Data (on page 60) 3) Starting Unifier in WebLogic (on page 61)

Stopping Unifier in WebLogic To stop Unifier in WebLogic:

1) Open the WebLogic directory within the Unifier Home folder. 2) Run the stop.sh file. 3) If prompted, enter the WebLogic user name and password.

Editing Configuration Data After stopping Unifier, edit the configuration settings as follows:

1) In the WebLogic directory within the Unifier Home folder, locate the configure.sh file.

Installing Unifier on Linux

61

2) Run configure.sh. 3) Make necessary configuration changes, and click File, Save. 4) Start Unifier in WebLogic.

Starting Unifier in WebLogic To start Unifier in WebLogic:

1) Open the WebLogic directory within the Unifier Home folder. 2) Run the startup.sh file. 3) If prompted, enter the WebLogic user name and password.

Copying the Configuration Data File

The configuration data for the Configurator is stored automatically under the installation folder in the /configurator/bluedoor.properties file. If necessary, you can transfer the configuration settings from one environment to another by copying the configuration data file and editing it with the new configuration settings.

Configuring the Oracle HTTP Server (OHS)

After installing Oracle HTTP Server (OHS), configure as follows:

1) Modify the $ORACLE_INSTANCE/ config/ OHS/ ohs1/httpd.conf file as follows: a. Change the default listen port from 7777 to 80.

Note: Before making the above change, disable or turn-off any other application that is using port 80 (such as IIS or Windows).

b. Add settings after DocumentRoot as follows: DocumentRoot <Unifier_Home>/apps/ROOT

c. Add parameters between <Directory ></Directory> so it appears as follows: <Directory "<Unifier_Home>/apps/ROOT">

Options Includes FollowSymLinks AllowOverride None Allow from all Order allow,deny DirectoryIndex index.html

</Directory> <Directory "<Unifier_Home>/apps/ROOT/WEB-INF">

Deny from all </Directory>

d. #Support Http method GET/POST only RewriteEngine On RewriteCond %{REQUEST_METHOD} !^(GET|POST)

Unifier Installation and Setup Guide for WebLogic Application Server

62

RewriteRule .* - [F]

Notes:

<Unifier_Home> is the unifier installation directory. The session about Supporting Http method GET/POST only can be

(or may be) added at the end of http.conf file.

2) Add the following to the $ORACLE_INSTANCE/ config/ OHS/ ohs1/mod_wl_ohs.conf file: <LocationMatch /(bp|bluedoor|g|pub|m|portal|viewbp|ws|VueServlet|jvueDMS|xdespellchecker)($|/)> SetHandler weblogic-handler WebLogicHost localhost WebLogicPort 7001 </LocationMatch> <LocationMatch /(dojo|gs|studio|unifier_js|webant|x)($|/)> ExpiresActive on ExpiresDefault "access plus 6 month" </LocationMatch> LoadModule deflate_module "${ORACLE_HOME}/ohs/modules/mod_deflate.so" before <LocationMatch /(bp|bluedoor|g|pub|portal|viewbp)($|/)> SetOutputFilter DEFLATE </LocationMatch> DeflateBufferSize 20000

Note: Modify these entries under <Location /> as necessary:

For WebLogicHost: Weblogic server hostname or IP address. For WebLogicPort: Weblogic server port number.

3) Modify the $ORACLE_INSTANCE/ config/ OHS/ ohs1/ssl.conf file as follows: Replace: SSLProtocol nzos_Version_1_0 nzos_Version_3_0 With: SSLProtocol -all +SSLv3 Replace: SSLCipherSuite SSL_RSA_WITH_RC4_128_MD5,SSL_RSA_WITH_RC4_128_SHA,SSL_RSA_WITH_3DES_EDE_CBC_SH A,SSL_RSA_WITH_DES_CBC_SHA,TLS_RSA_WITH_AES_128_CBC_SHA,TLS_RSA_WITH_AES_256_C BC_SHA With: SSLCipherSuite HIGH

4) Run opmnctl.sh to restart the OHS server.

Installing Unifier on Linux

63

Installing SSL Certificate (Optional)

Unifier works in Secure or Non-secure mode. Installing a Secure Socket Layer (SSL) certificate is optional.

Data Backup Recommendations

Oracle Primavera recommends that Primavera Unifier data be incorporated into your company backup procedures. Primavera Unifier data is stored in two places:

Unifier database Files Repository

These repositories need to be backed up regularly.

Deploying Unifier

To deploy Unifier into the WebLogic domain, complete the following procedures:

1) Creating an EAR File From the Configurator (on page 46) 2) Deploy the generated EAR file using any of the following methods: Deploying Unifier From the Unifier_Home Directory (on page 46) Deploying Unifier from the WebLogic Administration Console (on page 46)

Unifier URL (WebLogic)

In your browser, navigate to the URL that launches the Unifier application locally. For example: http://unifier.oracle.com:7001

Creating an EAR File From the Configurator

Complete the following steps to create an .EAR file from the configurator:

1) Access the Configurator. 2) In the configurator, select File, Create EAR. 3) By default, the .EAR file is created in the unifier/weblogic directory. 4) Save the file as unifier.ear. 5) Proceed to deploy unifier.ear in WebLogic using any of the following methods: Deploying Unifier From the Unifier_Home Directory (on page 46) Deploying Unifier from the WebLogic Administration Console (on page 46)

Deploying Unifier From the Unifier_Home Directory

After creating the .EAR file, deploy Unifier as follows:

1) In the <unifier_home>\weblogic directory perform the following:

Unifier Installation and Setup Guide for WebLogic Application Server

64

Set the domain_home variable to specify the path of the domain home folder that will be used by Unifier.

Set the admin url variable to specify host name and port number used by the Unifier domain.

Set the java_home variable to the JDK installed directory. 2) Save setEnv.sh. 3) Run startup.sh. 4) Run deploy.sh. 5) When prompted, enter the WebLogic administrator user name and password.

The Unifier application will be deployed in WebLogic using the variables set in the setEnv.sh.

Note: This process may take several minutes.

Deploying Unifier from the WebLogic Administration Console

After creating the .EAR file in the Configurator, deploy the file from the WebLogic Administration Console as follows:

1) In the Change Center pane, select Lock & Edit. 2) In the Domain Structure pane, select Deployments. 3) In the Summary of Deployments pane, select Install. 4) In the Install Application Assistant pane:

a. Specify the path to the unifier.ear file and click Next. For example: c:\<unifier_home>\weblogic\unifier.ear.

b. Select Install this deployment as an application and click Next. c. Accept the defaults and click Next. d. Review the configuration settings you have chosen and select Finish to complete the

installation. 5) In the Settings for unifier window, select Save. 6) In the Change Center pane, select Activate Changes. 7) In the Domain Structure pane, select Deployments. 8) In the Summary of Deployments pane:

a. Select unifier. b. Select the down arrow to the right of the Start button and select Servicing all requests.

9) In the Start Application Assistant pane, select Yes.

Note: The unifier state column should be Active. If the state is Start Running, refresh the screen until the status is changed to Active.

Deploying Unifier to a WebLogic Cluster

There are two types of clustering environments:

Installing Unifier on Linux

65

1) Individually deployed WebLogic server that points to the same Unifier DB.

2) WebLogic cluster of multiple managed servers, deployed with a single EAR file.

For both clustering environments, files must be placed on a shared drive that is accessible by other server machines that are operating in a clustering environment.

In addition, for the WebLogic cluster, the directory path must be the same for all WebLogic cluster servers because the same EAR file (and configuration setup) is used by all WebLogic cluster servers.

To setup a WebLogic cluster, refer to the WebLogic documentation for detailed instructions. After setting up the cluster, generate the EAR file and deploy Unifier using the EAR file as described in this guide.

Launching Unifier

This section describes how to:

Start Unifier for the first time Install Unifier applications Set up your company

Before launching Primavera Unifier, ensure that you have read the Getting Started section of the Unifier Help, which contains important information about configuring your browser for use with Primavera Unifier.

Starting Unifier for the First Time

In the Sign In window, sign in to Unifier with the default Administrator username (Administrator) and password (Administrator).

Unifier immediately prompts you to change your password. We recommend you do so immediately for security reasons. Once you change your password, Unifier creates your Administrator account.

The Administrator account is the only account with permissions automatically set for all features. The Administrator cannot be a member of any project, even if created in the Hosting Company.

Installing Unifier Applications This section describes how to install the Unifier applications for your company.

Notes:

The following procedures must be performed by the Site Administrator, after the required Unifier applications (Primavera Unifier, or Primavera Unifier and Primavera Unifier Project Controls) have been downloaded and stored locally. See Downloading Unifier section for details.

Unifier Installation and Setup Guide for WebLogic Application Server

66

If you receive an error message, try reinstalling the application. If reinstalling the application also results in receiving an error message, contact Oracle Support.

When you sign in as the Site Administrator, Unifier shows you the Home tab in Administration Mode.

1) In the left Navigator, click Applications node. Unifier displays an install panel on the right-hand side of the window.

2) Click Install to open the “Install Primavera Unifier Application” window. Use the information in the table below to complete the fields in the window and when finished, click Install.

Note: Ensure that the Temporary directory is set in the configurator (General tab).

In this field: Do this:

Select Downloaded Application to Install

Application File Browse to where the applications are stored and select the application you want to install. Note that you should point to the .zip file and that .zip file does not need to be previously extracted.

Set preconfigured designs as unpublished Note: This option is available in Staging environment. This option is not available in Production environment.

Selecting this option allows users to be able to modify designs (business processes and attribute forms) in the Staging environment, after Unifier is installed. See the following Unifier Environments topics for details.

Company Details

Name Enter the name of the company.

Short Name Enter a one-word short name, up to 8 characters. The Short Name is a unique, one-word abbreviated form of your company name, and is used throughout Primavera Unifier in place of the company name. (For example, when importing uDesigner-created business processes, and on logs that identify partner companies.)

Currency Enter the default currency that will be used by the company.

Contact Email Enter the email address that will be used for all emails sent from the Support link in Unifier.

Licensed Users Enter the number of users who will be licensed to

Installing Unifier on Linux

67

In this field: Do this: use the application.

Address Type Identify the address you are entering, such as Headquarters, Billing Office, or Satellite Office.

Address Enter the company address.

City Enter the city for the address.

State/Province Enter the state or province for the address.

Zip Enter the zip code for the address.

Country/Region Enter the country or region for the address.

Admin Login Username Enter the company administrator’s user name. Default is coadmin. This user name will be automatically added to the Company Administrators group. Note: The coadmin user by default gets all the permissions for the new designs or new modules. Essentially this user that is company administrator will have all the permissions across the company and projects.

Password Enter the administrator’s password.

Confirm Password Re-enter the password.

Unifier Environments There are two Unifier environments:

Staging environment Production environment

The Site Administrator can install the platform version of the product (Primavera Unifier) in both Staging and Production environments.

Note: In this type of installation, the new designs created in the Staging environment are unpublished until the creation of Production design bundle creation. After Production design bundle is created, all designs that are tagged for Production will be published.

The Site Administrator can install the Project Controls version of the product (Primavera Unifier Project Controls) in both Staging and Production environments; however, Oracle recommends that the Administrators avoid installing the Project Controls version of the product in Production environment, if the users plan on modifying the preconfigured designs.

The following section explains the recommended setup (which downloaded folders must be placed in which environment):

Platform version of the product (Primavera Unifier)

Unifier Installation and Setup Guide for WebLogic Application Server

68

Staging The BASIC files The main Unifier application files ("unifier_#.zip" (where # represent the Unifier version

number) folder) Production The BASIC files The main Unifier application files ("unifier_#.zip" (where # represent the Unifier version

number) folder)

Project Controls version of the product (Primavera Unifier Project Controls) Staging The main Unifier application files ("unifier_#.zip" (where # represent the Unifier version

number) folder) The files in the main zip folder from Primavera Unifier Project Controls download

Production The main Unifier application files ("unifier_#.zip" (where # represent the Unifier version

number) folder)

Note: Since the content of the material created by the Users (also known as Custom Strings) can be translated into different languages, with the exception of data or value entered by the user, you (Unifier Administrator) must sign in to Unifier, navigate to the Company, expand the Configuration node, select the Internationalization node, click Refresh drop-down list, and select All Strings to populate the Custom String table. If you do not refresh after the installation, certain Unifier functions will not work properly.

Deploying Unifier Online Help

By default Unifier online help is deployed from the Oracle Technology Network site. To deploy Unifier help locally, or from an alternative URL, proceed as follows:

1) From the Help topic of the Primavera Unifier Online Documentation Library, download help.zip.

2) Extract the contents of the help.zip to the folder specified in the Unifier Help URL field in the General tab of the Configurator.

69

To obtain the applicable service pack, go to Oracle Support. Use the Readme associated with the service pack for instructions about how to apply the service pack.

Appendix A: Installing a Service Pack (WebLogic)

71

Archiving allows Site Administrator to archive individual projects.

Configuring Primavera Unifier for Project Archiving Set up the archive parameters (Archive Directory and Archive Temp Directory). Refer to "Repository Tab."

Archiving Projects The archiving process captures project data and creates .csv files for all records, including business processes, tasks, documents, attachments, users, groups.

Note: In order to archive projects, you must have "Archive" permission as a Hosting Company user. (This permission is found under Projects (Standard) in Access Control or the Permissions tab of the Edit User/Group window; company must be Hosting Company.)

To archive projects:

1) Sign in to Primavera Unifier as Site Administrator. 2) In Administration Mode, navigate to System, Customer Support, Projects. The Project log

opens. 3) Select the project to archive. If a project has not yet been archived, the Archive Status

column will display Not Started. 4) Click the Archive Project button. The Archive Status column will change to Scheduled. A

background process picks up the request and runs the archive process. Once it is done, the status will change to Ready. The location of the zip file that contains the data will be located in the directory you specified during configuration.

Appendix B: Archiving Projects

Unifier Installation and Setup Guide for WebLogic Application Server

72

Where to Get Documentation

If you need help with an operation in Primavera Unifier, there are a number of resources to help you.

Note: The Company Administrators for Unifier Cloud must use the Primavera Cloud Service Administrator's Setup Guide instead of all the other installation and configuration guides in the Primavera Unifier Online Documentation Library.

Online Help If you have a question or need further assistance regarding a specific feature, review the online help.

Click the Help menu from any Primavera Unifier window, and choose:

Unifier Help: This link goes to the Oracle Technical Network (OTN) Primavera Unifier Online Document Library. From here you can access: Primavera Unifier Online Help Primavera Unifier Administration Guide Primavera Unifier User's Guide Primavera uDesigner User's Guide Primavera Unifier Reference Guide

You must have Adobe Acrobat Reader installed (available free at www.adobe.com). BP-specific Help: If your company has provided customized Help files for individual business

processes, you can access them through the business process log or the Help menu.

Note: For the full list of system requirements, supported software, and versions, see the Tested Configurations document under “Installation and Configuration Documentation” in the Primavera Unifier Online Documentation Library.

Documentation Complete documentation libraries for Primavera Unifier releases are available on the Oracle Technology Network (OTN) at:

http://www.oracle.com/technetwork/documentation/default-1870233.html

From this location you can either view libraries online or download them to have local copies. We recommend viewing them from OTN to ensure you always access the latest versions, including critical corrections and enhancements.

For More Information

For More Information

73

Primavera Unifier is configured to access its help system directly on OTN. However, a downloadable version of the help system is also available on OTN if you need to download, deploy, and access a local copy.

The documentation assumes a standard setup of the product, with full access rights to all features and functions.

Distributing Information to the Team You can copy the online documentation to a network drive for access by project participants. Each team member can then view or print those portions that specifically relate to his or her role in the organization.

The following is the list, and description, of the core documents available for Primavera Unifier.

Supplementary Documentation What's New

Contains key enhancements in the current release of Primavera Unifier. All users should read this guide.

Cumulative Features Overview Tool

Provides an overview of features and enhancements included in Oracle Primavera products. It is intended solely to help you assess the business benefits of upgrading and to plan your I.T. projects. All users should read this guide.

Readme for Media Pack

Contains a table that can help you determine what downloads are required to run your licenses. All users should read this guide.

Licensing Information User Manual

Contains information about the third-party proprietary and open source software used in Oracle Primavera Unifier. All users should read this guide.

Where to Get Documentation, Training, and Support

Contains information about resources to help you with the operation of Oracle Primavera Unifier. All users should read this guide.

Installation Documentation Primavera Unifier Installation and Setup Guide For WebLogic Application Server

Describes how to: Set up Primavera Unifier servers and third party services Install and configure Primavera Unifier components

Unifier Installation and Setup Guide for WebLogic Application Server

74

IT professionals who are installing and configuring the server environment, and the Primavera Unifier network administrator/database administrator and Primavera Unifier administrator should read this guide.

Primavera Unifier Installation and Setup Guide for WebSphere Application Server

Describes how to: Set up the Primavera Unifier servers and third party services on Linux (64-bit) Install and configure Primavera Unifier components IT professionals who are installing and configuring the server environment, and the Primavera Unifier network administrator/database administrator and Primavera Unifier administrator should read this guide.

Unifier Performance and Sizing Guide

Provides guidance for planning product deployment with: Estimates of hardware and software requirements for Primavera Unifier Recommendations for deploying small-scale to large-scale configurations The Unifier network administrator/database administrator and Unifier administrator should read this guide.

Unifier Upgrade Guide

Provides information on how to upgrade to the latest version of with Oracle Primavera Unifier. The Unifier network administrator/database administrator and Unifier administrator should read this guide.

Tested Configurations

Provides the tested configurations for Oracle Primavera Unifier and includes list of applications and supported version levels. All users should read this guide. The Unifier network administrator/database administrator and Unifier administrator should read this guide.

Primavera Unifier Security Guide

Provides guidelines on how to plan your security strategy for Oracle Primavera Unifier. All users should read this guide. The Unifier network administrator/database administrator and Unifier administrator should read this guide.

Configuration Documentation Primavera uClient Configurator Setup Guide

Describes how to set up the Primavera uClient Configurator. All users should read this guide.

Primavera Unifier File Transfer Utility Instructions

Describes how to download and install the Primavera Unifier File Transfer Utility. All users should read this guide.

For More Information

75

uCAD Installation and User's Guide

Provides instructions on how to download and install the Primavera Unifier uCAD Application on your desktop and configure it to work with your AutoCAD® application. It also includes details on how to use uCAD with AutoCAD and Primavera Unifier. All users should read this guide.

Configuring BI Publisher for Unifier

Provides instructions on how to: Download BI Publisher. Configure BI Publisher settings. Configure BI Publisher in Primavera Unifier. Create BI Publisher reports. Run BI Publisher reports. The Primavera Unifier network administrator/database administrator and Primavera Unifier administrator should read this guide.

Configuring Unifier for Single Sign On

Provides procedures to configure Primavera Unifier that is running on Windows (64-bit) or on Linux operating systems for Single Sign On (SSO). The Primavera Unifier network administrator/database administrator and Primavera Unifier administrator should read this guide.

Connecting Oracle Enterprise Manager to Primavera Unifier Metrics

Provides instructions on how to enable Enterprise Manager to display certain Primavera Unifier metrics. The Primavera Unifier network administrator/database administrator and Primavera Unifier administrator should read this guide.

Connecting Oracle Identity Manager 11g to Primavera Unifier

Guides administrators in configuring Oracle Identity Manager (OIM) to be used with Primavera Unifier. The Primavera Unifier network administrator/database administrator and Primavera Unifier administrator should read this guide.

Connecting the Content Repository to Primavera Unifier

Provides instructions on how to: Configure Oracle WebCenter Content Core Capabilities after you install it. Configure Microsoft SharePoint after you install it. Configure CMIS-compliant repositories after you install one. Configure the Primavera Unifier File Repository. Set your content repository settings in Primavera Unifier to connect to your content

repository. The Primavera Unifier network administrator/database administrator and Primavera Unifier administrator should read this guide.

Unifier Installation and Setup Guide for WebLogic Application Server

76

Primavera Cloud Service Administrator's Guide

This guide describes how to configure and administer Primavera products hosted on the Oracle Cloud for industries. It supersedes all the other installation and configuration guides for Primavera products, since they are for on-premises deployments. Cloud administrators should read this guide.

User Documentation Primavera Unifier Help

Provides topic-oriented information about Primavera Unifier to assist users with features and procedures. All users should read this guide.

Primavera Unifier User's Guide

Guides users on how to use Primavera Unifier application. All users should read this guide.

Primavera uDesigner User's Guide

Guides users on how to use the uDesigner feature of Primavera Unifier application. All users should read this guide.

Primavera Unifier Administration Guide

Provides details about the Administration Mode of Primavera Unifier, which covers access to Primavera Unifier functionality that is granted through permissions. All users should read this guide.

Primavera Unifier Project Controls User's Guide

Explains Oracle Primavera: Capital Planning which is used for managing budget forecasts (both planned and in

execution) for the user company. Cost Controls which supports project tracking and project cost management. Project Delivery Management which is designed to optimize project results. Anyone who wants to use the Unifier Project Controls base product should read this guide.

Database Documentation Primavera Unifier Reference Guide

Provides details about data definitions, data elements, permission settings, import codes, and pickers with Primavera Unifier. All users should read this guide.

Integration Documentation Primavera Unifier Integration Interface Guide

Describes the methods required for the integration, and the data being passed, between Primavera Unifier and an external system.

For More Information

77

Anyone who wants to develop applications which interact with Primavera Unifier should read this guide.

Where to Get Training

To access comprehensive training for all Primavera products, go to: http://education.oracle.com

Oracle Learning Library The Oracle Learning Library (OLL) provides online learning content covering Primavera products. Content includes whitepapers, videos, tutorials, articles, demos, step-by-step instructions to accomplish specific tasks, and self-paced interactive learning modules.

To access the learning library’s Primavera content, go to: http://www.oracle.com/oll/primavera

Where to Get Support

If you have a question about using Oracle products that you or your network administrator cannot resolve with information in the documentation or help, click http://support.oracle.com/. This page provides the latest information on contacting Oracle Global Customer Support, knowledge articles, and the support renewals process. For more information about working with Support, visit https://support.oracle.com/epmos/faces/DocumentDisplay?id=888813.2 to view Support Tools & Tips.

To get the latest information about Critical Patch Updates, visit http://www.oracle.com/technetwork/topics/security/alerts-086861.html.

Access to Oracle Support Oracle customers that have purchased support have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/us/corporate/accessibility/support/index.html (http://www.oracle.com/us/corporate/accessibility/support/index.html).

Using Primavera Support Resource Centers Primavera’s Support Resource Center provides links to important support and product information. Primavera's Product Information Centers (PICs) organize documents found on My Oracle Support (MOS), providing quick access to product and version specific information such as important knowledge documents, Release Value Propositions, and Oracle University training. PICs also offer documentation on Lifetime Management, from planning to installs, upgrades, and maintenance.

Visit https://support.oracle.com/epmos/faces/DocumentDisplay?id=1486951.1 to access links to all of the current PICs.

PICs also provide access to:

Communities, which are moderated by Oracle providing a place for collaboration among industry peers to share best practices.

News from our development and strategy groups.

Unifier Installation and Setup Guide for WebLogic Application Server

78

Education via a list of available Primavera product trainings through Oracle University. The Oracle Advisor Webcast program brings interactive expertise straight to the desktop using Oracle Web Conferencing technology. This capability brings you and Oracle experts together to access information about support services, products, technologies, best practices, and more.

Using Unifier Service Request and Support The Primavera Unifier integrates with different Oracle applications; when you create a Service Request, be sure to open the request with the proper Support team. To ensure you reach the proper Support team, enter the correct product information when you create the Service Request. Each product has its own support line.

Use the Primavera Unifier support line when you are having installation, configuration, connection, or application issues related to the Primavera Unifier.

Use one of the following support lines when you are having installation or configuration issues that do not relate to the Primavera Unifier.

Oracle WebLogic Server Oracle Server Oracle Database Server Oracle AutoVue Oracle WebCenter Content Oracle Enterprise Manager Oracle Business Intelligence

Additional Support

The following is a list of additional support that are available in Unifier:

Unifier Help Unifier Library Contact Support Download Plugins About Unifier

Note: The Contact Support and Download Plugins options both open a single window, Support. The only difference is as follows: - Contact Support opens the Contact tab of the Support window by default - Download Plugins opens the Download tab of the Support window by default

Unifier Help Click Help from the upper right-hand section of the Unifier window to open a contextual menu and click Unifier Help to open the Unifier and uDesigner Help.

For More Information

79

Unifier Library Click Help from the upper right-hand section of the Unifier window to open a contextual menu and click Unifier Library to open the Unifier documentation library.

Contact Support Click Help from the upper right-hand section of the Unifier window to open a contextual menu and click Contact Support to open the Support window.

The Support window has two tabs:

Contact, which opens by default Download

In the Contact tab, Contact Information section, you can see the name, phone, and contact instructions of someone at your company that you can contact when you need help with Primavera Unifier. For assistance, try this person, first.

Note: This information is available only if your company administrator has provided internal support contact information.

In the Contact tab, eLearning section, you see the location (Access), name of the contact (Contact), and any instructions that you might need in order to access the eLearning materials.

Note: Your company may elect to provide access to the eLearning suite, where you can access interactive Primavera Unifier learning materials. Alternatively, your company may have its own customized support or training materials that can be accessed on an internal site/location. If your company administrator provides this contact information, it will be listed at the bottom of the window.

In the Download tab, Download section, you can see a list of the following application and plug-ins available to download, with installation instructions.

File Transfer Application Unifier uCAD Plug-in

Each application and plug-in has two options:

Download Installation instructions

Follow the links within each option to proceed.

Download Plugins Click Help from the upper right-hand section of the Unifier window to open a contextual menu and click Download Plugins to open the Support window.

The Support window has two tabs:

Contact Download, which opens by default

Unifier Installation and Setup Guide for WebLogic Application Server

80

In the Download tab, Download section, you can see a list of the following application and plug-ins available to download, with installation instructions.

File Transfer Application Unifier uCAD Plug-in

Each application and plug-in has two options:

Download Installation instructions

Follow the links within each option to proceed.

In the Contact tab, Contact Information section, you can see the name, phone, and contact instructions of someone at your company that you can contact when you need help with Primavera Unifier. For assistance, try this person, first.

Note: This information is available only if your company administrator has provided internal support contact information.

In the Contact tab, eLearning section, you see the location (Access), name of the contact (Contact), and any instructions that you might need in order to access the eLearning materials.

Note: Your company may elect to provide access to the eLearning suite, where you can access interactive Primavera Unifier learning materials. Alternatively, your company may have its own customized support or training materials that can be accessed on an internal site/location. If your company administrator provides this contact information, it will be listed at the bottom of the window.

About Unifier Click Help from the upper right-hand section of the Unifier window to open a contextual menu and click About Unifier to access version number, copyright information, and software agreement details for the Oracle Primavera Unifier.

81

Oracle Primavera Unifier Installation and Setup Guide for WebLogic Application Server

Copyright © 1998, 2015, Oracle and/or its affiliates. All rights reserved. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered to U.S. Government end users are “commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all appropriate failsafe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software or hardware in dangerous applications.

This software or hardware and documentation may provide access to or information on content, products and services from third-parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.

Legal Notices