Professional Documents
Culture Documents
2: Part 1
This series of blog post covers all Unifier installation steps starting from Database installation to installing Project Control solutions application
inside Unifier.
Below are the high level steps that are required for installing Unifier for first time:1. Install supported version of Database
2. Create Unifier Database user and provide necessary privileges
3. Install supported JDK version on server where Unifier needs to be installed
4. Install supported Weblogic version
5. Create Unifier EAR file
6. Deploy EAR file on weblogic
7. Setup Company and create company admin in Unifier
Supported version of above database, weblogic and JDK can be found in Tested Configuration document provided by Oracle. For version 15.2,
tested configuration is available at below link http://docs.oracle.com/cd/E59283_01/Unifier/15_2/unifier_15_2_tested_config.xlsx
In this first post we will install Oracle Database and create Unifier database user.
First download the database from Oracles website. Here we are installing 15.2 Unifier so we need to install Oracle Database 12c.
Select Desktop class (if you are installing it only for learning purpose on your own PC, else select Server Class). Click Next.
Select Use Windows Built-in Account. Click Next. (If you are installing it for any organisation then make sure to use Service Account instead of
your personal id)
Set character set as Unicode ALT32UTF8.
Provide database name and password. Default database name is orcl. Note down the database name it will be used in Unifier configuration while
connecting Unifier with database.
You will get a pop-up window for password management. Click on Password Management.
Provide password for SYS and SYSTEM user, note it down as it will be used while creating Unifier database user. Click OK.
Open a command prompt and type SQLPLUS, press enter. Under user-name type sys as sysdba, press enter. It will then ask for password.
Provide password as set in password management window.
Now type following query to create Unifier database user.
create user unifier identified by unifier temporary tablespace temp default tablespace users;
Here username and password is unifier, change it to the values that you want to keep. Suppose you want username as myunifier and password as
abcd1234 then query will be
create user myunifier identified by abcd1234 temporary tablespace temp default tablespace users;
Grant privileges to user unifier, replace unifier with username that you have created in above script.
grant connect, resource, create view, create table to unifier;
In first post we have covered installation of Database and creating Unifiers database user. In this post we will install JDK and Weblogic.
Before proceeding you should first find out the supported JDK and Weblogic version for Unifier 15.2.
This information can be found in Tested Configuration document released by Oracle for every version of Unifier, for 15.2 it is available at below
link http://docs.oracle.com/cd/E59283_01/Unifier/15_2/unifier_15_2_tested_config.xlsx
So from document I found that supported version of JDK and Weblogic for Windows server 2012 R2 64 bit is 1.8.0_60 and 12.1.3.0.0
respectively. If you already have Weblogic 10.3.6 then upgrade it to 10.3.6.0.11. The supported JDK for Weblogic 10.3.6.0.11 is 1.7.0_85.
To download the supported Java version you have to go to Java Archive website and download the Java SE Development Kit according to your
server. Below is Java Archive link
http://www.oracle.com/technetwork/java/javase/downloads/java-archive-javase8-2177648.html
Make sure to install Java in a folder which dont contain spaces in its name like C://Program Files/Java/JDK instead install it in folder like
C://Java.
Click Next.
Click on Yes.
Click on Yes.
Select All user option. It will help in case your team member dont know the Weblogic installation directory and someone asked him/her to
restart Weblogic server, he/she can easily find options for same in their start menu.
You will get Quick Start window, here we will create an Admin server to host our Unifier application. Click on Getting Started with ..
Provide password for Weblogic user and click Next. Note down the password it will be used to start Weblogic and access Weblogic admin
console.
Select Administration Server. In case you want to deploy Unifier application on a managed server instead of Admin server check second option
else leave it as it is.
Provide a listen port for Admin server. Make sure this port is not already in use by other application hosted on same server.
A command prompt will appear, provide Weblogic admin user name and password as set earlier.
Press enter.
This will start Weblogic admin server and can be accessed using url http://localhost:7003/console from local browser.
In first and second post we have covered installation of Database, creating Unifiers database user, and Weblogic installation. In this post we will
create Unifier EAR file and deploy that on Weblogic.
First of all you need to download Unifier application from https://edelivery.oracle.com
Sign-in into portal and search for Unifier, select your system platform. Software details will appear in Download Queue window, click on
Continue.
Open Weblogic folder. Right click and edit setenv.bat file.Following parameter needs to be set in setenv.bat file
WL_HOME,DOMAIN_HOME,ADMINURL,JAVA_HOME
WL_HOME should be point to the path where Weblogic is installed, DOMAIN_HOME is the Weblogic s domain on which you are deploying
Unifier application, ADMINURL is the URL of managed server where unifier needs to be deployed and JAVA_HOME is path where JDK is
installed.
Now run configure.bat file present in same folder.At General tab, select Server Type as Staging if you are installing application for Dev and QA
environment, else select Production.Server Internal URL should contain IP address of server where Unifier will be deployed (Weblogic server ip
address). Port number is your Admin/managed server port in our case its 7003 as we are deploying on admin server only.Rest of the settings are
self-explanatory.
Now click on Repository tab. Settings at this tab tells Unifier where to store Business Processs attachment, published/unpublished documents
uploaded at Document Manager, Report files etc. You should create folder like below and map these to each directory using browse button.
At Database tab, provide details of Unifier database user (refer first post where we have created Unifier database user)
At Markup Server tab provide details for Autovue servers host name and port.
At report tab provide BI Publisher details.
At Geo Map provide following details for integrating unifier with Oracle map server
Map Server URL: https://elocation.oracle.com
Map Tile: elocation.world_map
Map Geocoder URL: https://elocation.oracle.com
At Authentication tab provide details for authentication provider, in our case we are keeping it as native.
After filling all the details go to File > Save. This will save all settings.
Then click on File > Create EAR. It will takes approximately 5-10 minutes for EAR file to be created.
You can see the EAR file in same folder as of configure.bat
Now run the deploy.bat file. This will deploy our EAR file in Weblogic. This operation calls setenv.bat for getting Weblogic details, so if there is
any error with file path this operation will fail, also make sure that Weblogics admin console is up and running.
Provide Weblogic user name and password.
Once deployment is completed login into Weblogic console. Navigate to Deployment page, you will see Unifier file deployed there, make sure
its active.
As application is deployed and active it can be accessed using browser. To do this click on name of deployment application. Click on Testing tab,
Login into application with userid Administrator and password as Administrator. Make sure that A is caps. Unifier will prompt you to change the
password.
Change your password. Click on Applications.
Click on Install. A window will appear select the V77741-01.zip file (file may vary for other Unifier version), provide details of hosting
company.
Provide password for coadmin, this is your Company Administrator.
Click Install.
Now the Project Control file is installed, you will be able to see all the out of the box business process, uDesigner and other features.
Click on Users. Select coadmin and click on login button.
You are now logged in as Company Administrator. Open Company Workspace tab, switch to admin mode then click on uDesigner. You will be
able to see all the Business Process.