SCPRGrewritecond

UUnniiffiieerrIInnssttaallllaattiioonnGGuuiiddeeffoorrOOnn--PPrreemmiisseessVVeerrssiioonn1177MMaayy220011883ContentsIntroduction7UnifierOverview.
7InstallationPrerequisites.
9InstallingJDK.
9InstallingWebLogic9InstallingOracleFusionMiddlewareInfrastructure.
9InstallingOracleHTTPServer(OHS)10InstallingFonts10InstallingUnifieronWindows13DownloadingUnifier.
13RecommendedSetupafterDownloadingUnifier.
14ConfiguringtheOracleDatabaseServer14InstallingtheAutoVueServer15DownloadingandInstallingAutoVue16ConfiguringAutoVue.
16DeployingUnifierGUIAppletstoAutoVue.
16ConfiguringWebLogicforUnifieronWindows.
17CreatingaWebLogicDomainforUnifieronWindows17ConfiguringtheWebLogicDomainforUnifier(MobileDevice)18CreatingaWeblogicDomainforUnifierRESTServices.
18PreparingtheDatabase.
19ConfiguringaWeblogicDomainforRESTServices.
20CreatingRoles21CreatingGroups.
21CreatingUsers22SettingupOWSMAuthentication22InstallingandConfiguringtheReportsServer(Optional)23StartingtheWebLogicAdminServeronWindows.
23StoppingtheWebLogicAdminServeronWindows23ConfiguringWebLogicasaServiceonWindows(Optional)24InstallingOracleWebCenterContent(Optional)24ConfiguringUnifierUsingtheConfigurator24EditingtheSetEnv.
batFileonWindows25ChangingUnifierConfiguratorSettingsonWindows25GeneralTab25RepositoryTab(CMIS)26RepositoryTab(Database)27RepositoryTab(NetworkFileSystem)28RepositoryTab(WebCenterContent)29UnifierInstallationGuideforOn-Premises4DatabaseTab(Oracle)30EmailTab31MarkupServerTab.
33ReportTab34GeoMapTab34AuthenticationTab(Native)34AuthenticationTab(OIM/OAM)35AuthenticationTab(WebLogic)35AuthenticationTab(LDAPSimpleBind)35AuthenticationTab(LDAPDoubleBind)36AuthenticationTab(GenericSSO)37AdvancedTab37SavingtheConfigurationSettings.
38ChangingConfigurationSettingsonWindows38StoppingUnifierinWebLogiconWindows.
38EditingConfigurationDataonWindows.
38StartingUnifierinWebLogiconWindows39CopyingtheConfigurationDataFile39ConfiguringtheOHTTPServer(OHS)39InstallingSSLCertificate(Optional)44DataBackupRecommendations44DeployingUnifier44CreatinganEARFileFromtheConfigurator.
44DeployingUnifierFromtheUnifier_HomeDirectoryonWindows.
44DeployingUnifierfromtheWebLogicAdministrationConsole.
45LaunchingUnifier46UnifierURL(WebLogic)46StartingUnifierfortheFirstTime.
46DeployingUnifierOnlineHelp.
46InstallingUnifieronLinux47DownloadingUnifier.
47RecommendedSetupafterDownloadingUnifier.
48ConfiguringtheOracleDatabaseServer48InstallingtheAutoVueServer49DownloadingandInstallingAutoVue50ConfiguringAutoVue.
50DeployingUnifierGUIAppletstoAutoVue.
50ConfiguringWebLogicforUnifieronLinux.
51CreatingaWebLogicDomainforUnifieronLinux.
51ConfiguringWebLogicBasicAuthenticationonLinux.
52CreatingaWeblogicDomainforUnifierRESTServices.
52PreparingtheDatabase.
52ConfiguringaWeblogicDomainforRESTServices.
54CreatingRoles55Contents5CreatingGroups.
55CreatingUsers56SettingupOWSMAuthentication56StartingtheWebLogicAdminServeronLinux57StoppingtheWebLogicAdminServeronLinux.
57ConfiguringWebLogicandOHSasaServiceonLinux57InstallingandConfiguringtheReportsServer(Optional)58InstallingOracleWebCenterContent(Optional)59ConfiguringUnifierUsingtheConfigurator59EditingtheSetEnv.
shFileonLinux.
59ChangingUnifierConfiguratorSettingsonLinux59GeneralTab59RepositoryTab(CMIS)61RepositoryTab(Database)61RepositoryTab(NetworkFileSystem)62RepositoryTab(WebCenterContent)63DatabaseTab(Oracle)64EmailTab65MarkupServerTab.
67ReportTab68GeoMapTab68AuthenticationTab(Native)68AuthenticationTab(OIM/OAM)69AuthenticationTab(WebLogic)69AuthenticationTab(LDAPSimpleBind)69AuthenticationTab(LDAPDoubleBind)70AuthenticationTab(GenericSSO)71AdvancedTab71ChangingConfiguratorSettingsonLinux72StoppingUnifierinWebLogiconLinux.
72EditingConfigurationDataonLinux.
72StartingUnifierinWebLogiconLinux72OpeningtheConfigurator.
73CopyingtheConfigurationDataFile74ConfiguringtheOHTTPServer(OHS)74InstallingSSLCertificate(Optional)78DataBackupRecommendations79DeployingUnifier79CreatinganEARFileFromtheConfigurator.
79DeployingUnifierFromtheUnifier_HomeDirectoryonLinux.
79DeployingUnifierfromtheWebLogicAdministrationConsole.
80DeployingUnifiertoaWebLogicClusteronLinux.
80LaunchingUnifier81UnifierURL(WebLogic)81UnifierInstallationGuideforOn-Premises6StartingUnifierfortheFirstTime.
81DeployingUnifierOnlineHelp.
81DownloadingandInstallingUnifierBaseProducts.
82RecommendedSetupafterDownloadingBaseProducts.
82DownloadingtheUnifierMobileApp85AppendixA:InstallingaServicePack(WebLogic)87AppendixB:ArchivingProjects89AppendixC:WebLogicClusteringforHighAvailability.
91LegalNotices997IntroductionTheUnifierInstallationGuidedescribeshowto:SetuptheUnifierserversandthirdpartyservices.
Therequirementsinclude:OracleWebLogicOracleLinuxOracleMaps(Optional)OracleWebCenterContent(Optional)OracleHTTPServer(OHS)UnifierApplication/WebServerAutoVueServerSolarisReportsServer(Optional)WindowsServerNote:Forthefulllistofsystemrequirements,applications,andapplicationversionlevelsrefertothePrimaveraUnifierTestedConfigurationsinthePrimaveraUnifierDocumentationLibrary.
InstallandconfigureUnifiercomponentsThisguideisintendedforITprofessionalswhoareinstallingandconfiguringtheserverenvironmentforUnifierandwhoaresupportingUnifierusers.
Note:TheuDesignerisamoduleinUnifier.
InThisSectionUnifierOverview7UnifierOverviewDesigning,building,andmanagingfacilitiesrequiresextensivecollaborationbetweennumerous,oftengeographicallydispersed,disciplinesandentities.
Throughouttheprocess,fromconceptualdesigntofacilityoperations,accesstoaccurate,up-to-dateinformationiscriticaltothesuccessofaprojectandfacility.
PrimaveraUnifierisanintegratedplatformthatoptimizesbusinessprocessesandcreatesvisibilitytoenablecustomerstobettermanageallofthecommunicationsandinformationrequiredtosuccessfullymanageafacilitythroughoutthelifecycle.
UnifierInstallationGuideforOn-Premises8Unifierisasystemformanagingtheflowofinformationinprojectsorshells,providingaseamlesslyautomatedandintegratedenvironmentacrossthelifecycleofyourcompany'sfacilities,fromplanning,design,procurement,constructionandintooperationsandmaintenance.
Itprovidesreal-timevisibilityacrossmultipleprojectsorshellstohelpyourcompanymakefast,accuratedecisions.
Unifierletsyoutrackandmanageinformationsuchasbudgets,projectorshellmembers,specifications,requestsforinformation,andshareddocuments.
Youdecidewhohasaccesstotheinformation,whichteammembersareallowedtoapprovechangestotheinformation,andhowinformationflowsbetweenpeople.
PrimaveraUnifiersolutionsautomatemanualprocessesandpulltogetherinformationfromvariouspointsystemstypicallyusedonaportfolioofprojectsorshells.
ThroughUnifier,executivesandprojectorshellteammemberscanbettermanagealldataandbusinessprocessesinonecentralizedsystem,whilereducingtherelianceonoldertechnologiessuchasemail,fax,anddesktopapplications.
Unifierwasdesignedfromthegroundupspecificallyforthefacilityowner,baseduponourindustrydomainexpertiseandknowledgeofbestpracticescombinedwithdirectcustomerinputgatheredoverdecadesofclientinteraction.
Theresultisarobustsetofcapabilitieswithanintuitive,easy-to-useinterface.
Unifierenablesleadingownersandoperatorstoincreaseenterpriseefficiencies,reduceprojectandoperatingcosts,enhancevisibility,andimprovetime-to-market.
9InstallationPrerequisitesCreateaninstallationaccountontheserverthathasfulladministrationprivileges.
Youwillneedtousethisaccountformaintenanceandupgrades.
Thefollowingarealsoprerequisites:InstallationofthesupportedversionsofWebLogicandJDK.
InstallationofthesupportedversionofOracleHTTPServer(OHS)InstallationofanOracleorMicrosoftSQLdatabaseRefertothePrimaveraUnifierTestedConfigurationsforthesupportedversions.
InThisSectionInstallingJDK9InstallingWebLogic9InstallingOracleFusionMiddlewareInfrastructure9InstallingOracleHTTPServer(OHS)10InstallingFonts.
10InstallingJDKForthefulllistofsystemrequirements,applications,andapplicationversionlevelsrefertothePrimaveraUnifierTestedConfigurationsinthePrimaveraUnifierDocumentationLibrary.
InstallingWebLogicYouwillneedtoinstallWebLogictodeployPrimaveraUnifier.
Note:Forthefulllistofsystemrequirements,applications,andapplicationversionlevelsrefertothePrimaveraUnifierTestedConfigurationsinthePrimaveraUnifierDocumentationLibrary.
RefertotheWebLogicdocumentationforinstallationinstructions(OracleFusionMiddlewareDocumentation:https://docs.
oracle.
com/en/middleware/middleware.
html).
InstallingOracleFusionMiddlewareInfrastructure1)DownloadOracleFusionInfrastructure.
Note:SeethePrimaveraUnifierTestedConfigurationsinthePrimaveraUnifierforsupportedversions.
2)StartcommandpromptasAdministrator.
UnifierInstallationGuideforOn-Premises103)Runthefollowingcommandtoinstall:C:\Oracle\Java\\bin\java-jarfmw__infrastructure.
jarIfyouhavemultiplejavaversions,justaddthefullpathtoJava1.
8JDKtojavacommandabove.
Note:SpecifytheWebLogichomeastheOracleHomeforthisinstallation.
InstallingOracleHTTPServer(OHS)YouwillneedtoinstalltheOracleHTTPserver(OHS)forloadbalancingandredirectionofUnifier.
Note:Forthefulllistofsystemrequirements,applications,andapplicationversionlevelsrefertothePrimaveraUnifierTestedConfigurationsinthePrimaveraUnifierDocumentationLibrary.
RefertotheOracleHTTPServerdocumentforinstallationinstructions(OracleFusionMiddlewareDocumentation:https://docs.
oracle.
com/en/middleware/middleware.
html).
1)InstallOracleHTTPServer(OHS)ondesiredserver.
2)IfOHSisinstalledonadifferentserverthantheUnifierserver,thencopytheUnifier_HomedirectoryandallthefilesfromtheUnifierservertotheOHSserver,usingthesamepathanddirectorystructureonboththeservers.
Forexample:[Unifier_Home]\apps\ROOTNote:The[Unifierhome]\apps\ROOTcontentsmustbekeptconsistentbetweentheUnifierappserverandtheOHSserver.
Forexample,ifaUnifierpatchsetorinterimpatchsetresultsinmodifyingthecontentsofthe[Unifierhome]\apps\ROOT,re-copythereviseddirectoryovertotheOHSserver.
InstallingFontsOracleOutsideInrequiresaccesstoTrueTypefontsinordertogeneratethumbnailandpageimages.
Aspartofinstallsetup,anadministratormustensurethatthesystemhasappropriatefontsinstalled.
TheUnifierapplicationsearchesforthefollowingdirectoryintheapplicationserverfortheinstalledfonts,asexplainedbelowfor:Note:Ifnoneoftheoptionsbelowisavailable,youwillnotbeabletoviewyourdocumentsbywayofOutsideInviewer.
LinuxInstallationPrerequisites11/usr/share/fonts/liberationMicrosoftWindowsC:\Windows\FontsSolaris/usr/openwin/lib/X11/fonts/TrueType13InstallingUnifieronWindowsCompletetheproceduresintheorderlistedbelowtoinstallandconfigureUnifierforafirsttimeinstallation.
Eachstepcorrespondstoasectioninthisguide.
Note:Beforeyoubegin,createaninstallationaccountthathasfulladministrationprivilegesfortheserver.
Thisaccountisneededforinstallation,maintenanceandupgrades.
1)DownloadUnifier2)ConfigurethedatabaseserverCompletethisstepbeforeconfiguringUnifier.
ThisinformationwillbeusedduringdatabaseconfigurationinUnifierConfigurator.
3)ConfigureWebLogicforUnifier4)InstallandconfiguretheReportsServer.
(Optional)5)InstallOracleWebCenterContent.
(Optional)6)InstallAutoVueServer7)ConfigureUnifierusingtheConfigurator8)DeployUnifierinWebLogic9)ConfiguretheWebServer10)LaunchUnifier11)DownloadingandInstallingUnifierapplicationsInThisSectionDownloadingUnifier13ConfiguringtheOracleDatabaseServer14InstallingtheAutoVueServer15ConfiguringWebLogicforUnifieronWindows.
17InstallingOracleWebCenterContent(Optional)24ConfiguringUnifierUsingtheConfigurator.
24ConfiguringtheOHTTPServer(OHS)39DeployingUnifier44LaunchingUnifier.
46DownloadingUnifierDownloadUnifierbyfollowingthesesteps:1)Gotohttps://edelivery.
oracle.
com/(OracleSoftwareDeliveryCloud)andsignin.
2)NavigatetoaccessthePrimaveraUnifierpage.
UnifierInstallationGuideforOn-Premises14ThePrimaveraUnifierzipfileenablesyoutodownloadthenecessaryfilesforinstallingtheplatformversionoftheproduct,only.
TheplatformversionofUnifiercontainsalltheUnifiermodulesandallowstheuserstocreatetheirowndesigns(BusinessProcessesandAttributeforms).
ThisversionofUnifierdoesnothavepreconfigureddesigns.
InadditiontothePrimaveraUnifierzipfile,youwillseethefollowingzipfolders:ThePrimaveraUnifierToolszipfileenablesyoutodownloadthenecessaryfilesforinstallingvariousUnifier-relatedproducts.
ThePrimaveraUnifierDocumentationenablesyoutodownloadalltheUnifierdocuments.
ThePrimaveraUnifierProjectControlsenablesyoutodownloadthenecessaryfilesforinstallingtheUnifierProjectControlsBaseProduct,whichcontainpreconfigureddesigns(BusinessProcessesandAttributeforms).
ThePrimaveraFacilitiesandRealEstateManagementenablesyoutodownloadthenecessaryfilesforinstallingtheUnifierFacilitiesandRealEstateManagementBaseProduct,whichcontainpreconfigureddesigns(BusinessProcessesandAttributeforms).
IfyourlicensingagreementincludesPrimaveraUnifierProjectControlsand/orUnifierFacilitiesandRealEstateManagementbaseproducts(applications/products),theSiteAdministratorcandownloadandinstallthebaseproducts.
SeetheDownloadingandInstallingUnifierBaseProductssectionfordetails.
RecommendedSetupafterDownloadingUnifierUnifier(Platform)willbeavailableinyourenvironments.
Youneedaminimumoftwoenvironments:1)Development2)ProductionNote:AlthoughtheBASICfileswillbeavailable,sinceUnifier(Platform)isalreadyloaded,enteronlythecompanydetailstousetheUnifier(Platform).
ConfiguringtheOracleDatabaseServerThefollowingisanoverviewofthestepsrequiredtoconfiguretheOracleDatabaseforusewithUnifier.
Formoreinformationandspecificinstructions,refertoyourOracledocumentation.
Note:Forthefulllistofsystemrequirements,applications,andapplicationversionlevelsrefertotheUnifierTestedConfigurationsintheUnifierDocumentationLibrary.
ConfigureanOracleDatabaseforUnifierasfollows:1)Createaninstanceforthedatabase.
InstallingUnifieronWindows15Note:Youcanacceptthedefaultsexceptforthefollowing:EnsuretosetencodingtoUnicode(UTF-8).
2)Createauseraccountonthenewlycreateddatabase.
ForsuccessfulPrimaveraUnifier/uDesignerinstallation,makesureamplefreespaceofatleast2GBisavailableforthedefaulttablespacewherethenewuserwillbelocated.
3)Grantthenewuserwithconnect,resource,createview,andcreatetableprivileges.
Note:ThisinformationwillbeusedlaterforsettingdatabaseinformationintheDatabasetaboftheUnifierConfigurator.
Forexample:createuserunifieridentifiedbyunifiertemporarytablespacetempdefaulttablespaceusers;grantconnect,resource,createview,createtabletounifier;Notes:(Required)EnsurethatmaximumopencursorinOracleDBissetto1000,orabove.
EnsurethatDatabaseuserquotaissettounlimitedontablespaceusers.
ImplementingTransparentDataEncryption(Optional)TransparentDataEncryption(TDE)isanOracleAdvancedSecurityfeaturethatisusedforOracleDatabaseencryption.
TDEprovidesstrongprotectionfrommaliciousaccesstodatabasefilesbyencryptingdatabeforeitiswrittentostorage,decryptingdatawhenbeingreadfromstorage,andofferingbuilt-inkeymanagement.
FormoreinformationaboutTDE,refertotheOracleAdvancedSecurity:http://www.
oracle.
com/technetwork/database/options/advanced-security/overview/index.
html.
InstallingtheAutoVueServerAutoVueinstallationismandatoryifyouplantouseUnifierMarkupfeature,alsoreferredtoasredlining.
WhenattachingdocumentstoaBusinessProcess(BP)form,youcanaddmarkups(textnotesorgraphicalelements)thatdisplaydirectlyonthedocument.
Note:Themarkupsdonotalterthedocument.
Thissectiondescribesthefollowingprocedures:DownloadingandinstallingAutoVueConfiguringAutoVueDeployingCustomGUIAutoVueappletsUnifierInstallationGuideforOn-Premises16Notes:YoumusthavealicensetoinstallAutoVue.
TheAutoVueserverishigh-intensivewithregardtoCPU,I/O,memory,andgraphics.
So,foroptimalperformance,ensurethatthemachinerunningtheAutoVueserverisnotbeingusedforotherapplications.
Formoreinformation,refertoOracleAutoVueClient/ServerDeploymentInstallationandConfigurationGuideavailableonOracleDocumentationwebsite.
Note:Forthefulllistofsystemrequirements,applications,andapplicationversionlevelsrefertothePrimaveraUnifierTestedConfigurationsinthePrimaveraUnifierDocumentationLibrary.
DownloadingandInstallingAutoVueDownloadandinstallAutovue.
Forsupportedversions,refertothePrimaveraUnifierTestedConfigurationsinthePrimaveraUnifierDocumentationLibrary.
RefertotheOracleAutoVuedocumentationsiteforinstallationinstructions.
Note:Forthefulllistofsystemrequirements,applications,andapplicationversionlevelsrefertothePrimaveraUnifierTestedConfigurationsinthePrimaveraUnifierDocumentationLibrary.
Afterthedownloadiscompleted:1)Extractthezipfileandgotothisdirectoryinwhichyouhaveextractedthezipfile.
2)RuntheAutoVueinstallerexecutable.
3)Gotothedirectoryinwhichyouhaveextractedthezipfile.
4)Locatethejvueserver.
propertiesfileandopen.
5)Addthefollowinglineattheendofthe\bin\jvueserver.
propertiesfile:jvueserver.
authentication.
enable=falseConfiguringAutoVueAfterinstallingAutoVue,configureAutoVuebyenteringinformationinthefollowingtabsoftheUnifierConfigurator:IntheGeneralTab,entertheServerinternalURLfieldtoaccessAutoVue.
IntheMarkupServerTab,completeallfieldsinthistab.
DeployingUnifierGUIAppletstoAutoVueAutoVueprovidestheoptionofcustomizingthird-partygraphicaluserinterface(GUI).
ThefollowingUnifierappletGUIfilesareprovidedtointegratewithAutoVue:InstallingUnifieronWindows17default.
guidefaultcons.
guidefaultNoMarkup.
guidefaultview.
guiTodeploytheUnifierappletGUIfilestoAutoVue:1)DownloadthecurrentversionofthePrimaveraUnifierToolsfilefromtheOracleSoftwareDeliveryCloud(https://edelivery.
oracle.
com/).
2)UnziptheAutoVueMenus.
zipfileintothelocationspecifiedinthejvueserver.
users.
directoryparameterinthe\bin\jvueserver.
propertiesfile.
3)FollowtherecommendationintheOracleAutoVuedocumentationsite.
Note:Forthefulllistofsystemrequirements,applications,andapplicationversionlevelsrefertothePrimaveraUnifierTestedConfigurationsinthePrimaveraUnifierDocumentationLibrary.
ConfiguringWebLogicforUnifieronWindowsThissectiondescribeshowtoconfigureWebLogicforUnifier.
Itincludes:CreatingaWebLogicDomainforUnifieronWindows(onpage17)StartingtheWebLogicAdminServeronWindows(onpage23)StoppingtheWebLogicAdminServeronWindows(onpage23)ConfiguringWebLogicasaServiceonWindows(Optional)(onpage24)CreatingaWebLogicDomainforUnifieronWindowsCreateaWebLogicdomainforUnifierasfollows:1)RuntheWebLogicConfigurationWizard.
2)IntheWelcomewindow:a.
SelectCreateanewWebLogicdomain.
b.
ClickNext.
3)IntheSelectDomainSourcewindow,clickNexttoacceptthedefaultselections.
4)IntheSpecifyDomainNameandLocation:a.
Enteradomainnameforthenewdomaintobecreated.
b.
Enterthelocationofthenewdomainontheserver.
c.
ClickNext.
5)IntheConfigureAdministratorUserNameandPasswordwindow:a.
EntertheUserNameandPasswordfortheAdministratorthatwillbecreated.
ThisusernamewillbeusedtologintotheWebLogicconsole.
b.
ClickNext.
6)IntheConfigureServerStartModeandJDKwindow:UnifierInstallationGuideforOn-Premises18a.
Intheleftpane,selectProductionMode.
b.
Intherightpane,selecttheJDKyouinstalledearlier.
c.
ClickNext.
7)IntheSelectOptionalConfigurationwindow:a.
SelecttheAdministrationServeroption.
b.
ClickNext.
8)(Optional)IntheConfiguretheAdministrationServerwindow:a.
SelecttheSSLEnabledoptionandsettheSSLlistenportifyouareenablingSecureSocketsLayercommunication.
Seehttp://download.
oracle.
com/docs/cd/E12840_01/wls/docs103/secmanage/ssl.
htmlformoredetailsonsettingSSLforWebLogic.
Note:OraclerecommendsyoualwaysuseSSLinaproductionenvironmentforsecurecommunications.
b.
ClickNext.
9)IntheConfigurationSummarywindow,clickCreate.
Ifgiventheoption,youcanclickDonenow.
Otherwise,continuetothenextstep.
10)IntheCreatingDomainwindow,selectStartAdminServer,andthenclickDone.
11)Whenprompted,entertheAdministratorUserNameandPasswordthatyouenteredabove.
ConfiguringtheWebLogicDomainforUnifier(MobileDevice)AccessingUnifierthroughmobiledeviceswithbrowsercapabilitiesToenablebasicauthenticationformobileRESTAPIonWebLogicserver,youmustfirstdisablethebasicauthenticationperformedbyWebLogicserver,whichisenforcedbydefault.
Fordetails,refertotheWebLogicserverdocumentation:UnderstandingBASICAuthenticationwithUnsecuredResources(http://docs.
oracle.
com/middleware/1221/wls/SCPRG/thin_client.
htm#SCPRG150)1)Changetotheweblogic_home/user_projects/domains/your_domaindirectory2)Editconfig/config.
xmlbyaddingthefollowingtagwithinthetag:false3)Startorrestartallserversinthedomain.
CreatingaWeblogicDomainforUnifierRESTServicesThissectiondescribesthestepsrequiredtocreateandconfigureaWeblogicdomainforUnifierRESTservices.
InstallingUnifieronWindows19PreparingtheDatabaseTopreparethedatabase:1)StartRCUbyenteringthefollowingcommand:C:\Oracle\MiddlewareOWSM\Oracle_Home\oracle_common\bin\rcu.
bat2)OntheWelcomescreen,selectNext.
Note:SelectNextoneachscreentoadvancetothenextstep.
3)OntheCreateRepositoryscreen,selectCreateRepositoryandSystemLoadandProductLoad.
4)OntheDatabaseConnectionDetailsscreen,enterthefollowingdetails:DatabaseType:SelectOracleDatabase.
Note:Forthefulllistofsystemrequirements,applications,andapplicationversionlevelsrefertotheUnifierTestedConfigurationsintheUnifierDocumentationLibrary.
HostName:ThehostnameortheserverIPaddressfortheUnifierdatabase.
Port:AuniqueportnumberfortheUnifierdatabaseschema.
Portnumber1521displaysbydefault.
ServiceName:Theglobaldatabasename.
Forexample,orcl.
us.
oracle.
com.
Username:TheusernamewithDBAorSYSDBAprivilegeswhocaninstallaschema.
Password:Thepasswordforusernameprovidedabove.
Role:RoleoftheuserwhowillbecreatingtheMDSschema.
SelectSYSDBA.
5)OntheCheckingPrerequisitesscreen,selectOKifallcheckspass.
6)OntheSelectComponentsscreen:a.
Createanewprefix.
Makeanoteoftheprefixyouchoose.
b.
ExpandASCommonSchemasandintheComponentssection,selectthefollowing:MetadataServicesAuditServicesAuditServicesAppendAuditServicesViewerOraclePlatformSecurityServicesCommonInfrastructureServices7)OntheCheckingPrerequisitesscreen,selectOKifallcheckspass.
8)OntheSchemaPasswordsscreen,selecttheUsesamepasswordsforallschemas,andenterthepassword.
Makenoteofthepasswordyouuse.
9)OntheMapTablespacesscreen,selectthedefaults.
Makenotesofyourselections.
10)OntheConfirmationscreen,selectOK.
11)OntheCreatingTablespacesscreen,selectOK.
12)OntheSummaryscreen,reviewyourselectedinstallationoptionsandselectCreate.
13)OntheCompletionSummaryscreen,selectClose.
UnifierInstallationGuideforOn-Premises20ConfiguringaWeblogicDomainforRESTServicesRuntheOracleFusionMiddlewareConfigurationWizardtocreateaWebLogicdomainasfollows:Note:SelectNextoneachscreentoadvancetothenextstep.
1)OntheCreateDomainscreen,selectthefollowing:CreateanewdomainDomainLocation:EnterthelocationforinstallingthedomainforRESTservices2)OntheCreateDomainUsingProductTemplatesscreen,selectthefollowingtemplates:OracleEnterpriseManagerOracleWSMPolicyManagerOracleJRFWebLogicCoherenceClusterExtension3)OntheApplicationLocationscreen,selectBrowseandselectthelocationfortheUnifierapplication.
4)OntheAdministrationAccountandtheDomainModeandJDKscreens,selectNexttoacceptthedefaults.
5)OntheDatabaseConfigurationTypescreen,selectthefollowing:SpecifyAutoConfigurationOptionsUsing:selectRCUData.
Vendor:EnterOracleasthedatabasevendor.
Driver:Selectthedriverthatisapplicabletothedatabasefromthedrop-downlist.
DBMS/Service:Entertheserverhostname.
HostName:Enterthehostnameofthedatabaseserver.
Port:Entertheportforthedatabase.
SchemaOwner:Enteranamefortheschemaowner.
SchemaPassword:Enterthecase-sensitivepasswordfortheschemaowner.
ItisthepasswordthatwasenteredwhenexecutingtheRCUutility.
SelecttheGetRCUConfigurationbuttontotesttheconnection.
6)OntheComponentDatasourcesscreen,selectthefollowing:Vendor:EnterOracleasthedatabasevendor.
Driver:Selectthedriverthatisapplicabletothedatabasefromthedrop-downlist.
DBMS/Service:Entertheserverhostname.
HostName:Enterthehostnameofthedatabaseserver.
Port:Entertheportforthedatabase.
SchemaOwner:Enteranamefortheschemaowner.
SchemaPassword:Enterthecase-sensitivepasswordfortheschemaowner.
ItisthepasswordthatwasenteredwhenexecutingtheRCUutility.
Selectallthecomponentschema.
7)OntheJDBCTestscreen,selecttheTestSelectedConnectionsbutton.
InstallingUnifieronWindows218)OntheAdvancedConfigurationscreen,selectAdministrationServer.
9)OntheAdministrationServerscreen,enterthefollowinginformation:ServerName:Enterthenamefortheadministrationserver.
ListenAddress:SelecttheListenaddressfortheadministrationserverfromthedrop-downlist.
ListenPort:Entertheportnumberfortheadministrationserver.
ServerGroups:SelectJRF-MAN-SVR,WSM-CACHE-SVRandWSMPM-MAN-SVRoptions.
10)OntheConfigurationSummaryscreen,clickCreate.
11)OntheConfigurationSuccessscreen,clickFinish.
CreatingRolesTocreateroles:1)EnsurethattheUnifierdomainisrunning.
2)LogintotheWeblogicAdministrationServerConsolefortheUnifierdomain:a.
Openabrowserandenterthefollowinglocation:http://:/consoleUsethehostnameandportoftheUnifierdomain.
b.
EntertheWeblogicadministratorusernameandpassword.
3)IntheChangeCenterpane,selectLockandEditbeforeyoumakeanychangestothedomain.
4)IntheDomainStructurepane,selectSecurityRealms.
5)IntheSummaryofSecurityRealmsscreen,selectmyrealm.
6)OntheSettingsformyrealmscreen,selecttheRolesandPoliciestab.
a.
IntheRolestable,expandGlobalRolesandthenexpandRoles.
b.
SelectNew.
c.
Entertherole:UnifierWSAdmin.
d.
SelectAddConditions.
e.
FromthePredicateList,selectGroup.
f.
SelectNext.
g.
FortheGroupArgumentName,enterUnifierWSAdminandselectAdd.
Groupnamesmustbeidenticaltothecreatedrole.
h.
SelectFinish,thenSave.
CreatingGroupsTocreategroups:1)IntheDomainStructurepane,selectSecurityRealms.
2)IntheSummaryofSecurityRealmsscreen,selectmyrealm.
3)IntheSettingsformyrealmscreen,selecttheUsersandGroupstab.
UnifierInstallationGuideforOn-Premises224)SelecttheGroupstab.
5)SelectNew.
FortheNamefield,enterthenameofthegroup.
Forexample,UnifierWSAdmin.
FortheDescriptionfield,enterthepurposeofthegroup.
FortheProviderfield,usethedefault(DefaultAuthenticator)value.
6)SelectOk.
CreatingUsersTocreateusers:1)IntheDomainStructurepane,selectSecurityRealms.
2)IntheSummaryofSecurityRealmsscreen,selectmyrealm.
3)IntheSettingsformyrealmscreen,selecttheUsersandGroupstab.
4)SelecttheUserstab.
5)SelectNew.
a.
Enteranameanddescriptionfortheuser.
b.
Enterapasswordfortheuserandconfirmit.
c.
SelectOK.
d.
Selectthecheckboxadjacenttotheusername,andselecttheuser.
e.
IntheSettingsforpane,selecttheGroupstab.
f.
DependingontherolethatyouwouldliketoassigntotheuserinUnifier.
SelectoneormoreparentgroupsfromtheAvailableboxtotheChosenbox.
6)SelectSave.
7)SelectActivateChanges.
8)SelectReleaseConfiguration.
SettingupOWSMAuthenticationTocreatetheWSMPolicy:1)LogintoOracleEnterpriseManagerfortheUnifierapplication:http://:/em2)ExpandtheWeblogicDomainnodeandselecttheUnifierdomainnode.
3)SelectWebServices,andthenselectWSMPolicySets.
4)OntheWSMPolicySetSummaryscreen,selectCreate.
5)CreatepolicysetsforUnifier_REST_API_servicesasfollows.
Name:EnteradescriptivenamefortheWSMpolicyset,forexample:Unifier_REST_API_Service.
Enabled:Ensurethisoptionisselected.
TypeofResources:SelectRESTfulResource.
Description:EnterDefaultpolicyforUnifierRESTAPIservice.
InstallingUnifieronWindows23Note:SelectNextoneachscreentoadvancetothenextstep.
6)IntheRESTfulApplication,Service,orWebServiceEndpointNamefield,enterUnifierRestService.
7)OntheEnterConstraintspage,selectNext.
8)Attachthebasicauthenticationpolicyasfollows:a.
Selectoracle/wss_http_token_service_policyfromthebottomgrid.
b.
SelectAttach.
9)OntheSummaryscreen,selectSave.
ThiscompletessettingupOWSMforusingexternalwebservicesofPrimaveraUnifier.
InstallingandConfiguringtheReportsServer(Optional)ConsultyourOracledocumentationforinstructionsoninstallingOracleBusinessIntelligencePublisher.
Note:Forthefulllistofsystemrequirements,applications,andapplicationversionlevelsrefertothePrimaveraUnifierTestedConfigurationsinthePrimaveraUnifierDocumentationLibrary.
ForconfigurationinformationforintegratingUnifierandBIPublisher,refertotheUnifierBIPublisherConfigurationGuide.
StartingtheWebLogicAdminServeronWindowsTodeployUnifierinWebLogic,starttheadminserverasfollows:1)FromtheStartmenu,navigatetotheOracleWebLogicsubmenu.
2)ChooseUserProjects,domain,Yourdomain,StartServer.
(user_projects,domain,,StartServer)3)IfpromptedforausernameandpasswordintheWebLogicconsolewindow,entertheadministrativeusernameandpasswordthatwasspecifiedwhencreatingthedomain.
Note:IfyouturnedontheWebLogicprecompileoption,theWebLogicconsoledisplays"ServerstartedinRUNNINGmode"whenprecompilingfinishes.
Fordetailedinformationaboutturningonprecompilation,seeyourWebLogicServerdocumentation.
StoppingtheWebLogicAdminServeronWindowsStopWebLogicadminserverasfollows:1)FromtheStartmenu,navigatetotheOracleWebLogicsubmenu.
2)ChooseUserProjects,domain,Yourdomain,StopServer.
(user_projects,domain,,StopServer)UnifierInstallationGuideforOn-Premises243)IfpromptedforausernameandpasswordintheWebLogicconsolewindow,entertheadministrativeusernameandpasswordthatwasspecifiedwhencreatingthedomain.
Note:TheWebLogicconsolewindowwillcloseautomaticallywhenitisshutdown.
ConfiguringWebLogicasaServiceonWindows(Optional)ToautomaticallystartWebLogiconareboot,completethefollowingstepstostartWebLogicadminserverasaserviceonWindowsoperatingsystem:1)SetWL_HOMEassystemenvironmentvariableormodifyitin/weblogic/setenv.
bat.
WL_HOMEistherootdirectoryoftheWebLogicinstallation.
Fordetailedinstructions,refertothetopic,CreatingaWebLogicDomainforUnifieronWindows(onpage17)tocreatetheDomainHomeforweblogic.
Forexample:C:\Oracle\Middleware\Oracle_Home\wlsserver\server2)Insetenv.
bat,setthejava_homevariabletospecifythejavahomeusedbytheUnifierdomain.
FordetailedinstructionsonsettingtheenvironmentvariablesforUnifier,refertoChangingUnifierConfiguratorSettingsonWindows(onpage25).
3)LoginasaWebLogicAdministrator.
4)Accessthe/weblogicfolderandrunthefollowingscripts:Runservice.
batinstalltoinstalltheserviceforthefirsttimeusing"beasvc%DOMAIN_NAME%_AdminServer"astheservicename.
Runservice.
batstarttostarttheweblogicserverwithname"beasvc%DOMAIN_NAME%_AdminServer"Runservice.
batstoptostoptheweblogicserverwithname"beasvc%DOMAIN_NAME%_AdminServer"Runservice.
batuninstalltoremovetheservicenamed"beasvc%DOMAIN_NAME%_AdminServer"fromthesystem.
where%DOMAIN_NAME%istheWebLogicdomainnameusedfordeployingUnifier.
Forexample:unifier_domainTip:Checkifthebeasvc%DOMAIN_NAME%_%SERVER_NAME%serviceexists,runs,orstopsfromtheControlPanel,AdministrativeTools,Servicesmenuoption.
InstallingOracleWebCenterContent(Optional)ConsultOracledocumentationforinstructionsoninstallingtheOracleWebCenter.
ForconfigurationinformationforintegratingUnifierandWebCentercontent,refertoUnifierContentRepositoryConfigurationGuide.
ConfiguringUnifierUsingtheConfiguratorThissectiondescribeshowtousetheUnifierConfiguratortoconfigureUnifier.
InstallingUnifieronWindows25EditingtheSetEnv.
batFileonWindowsEditthesetenv.
batfileasfollows:Setthedomain_homevariabletospecifythepathofthedomainhomefolderthatwillbeusedbyUnifier.
SettheadminurlvariabletospecifyhostnameandportnumberusedbytheUnifierdomain.
Setthejava_homevariabletotheJDKinstalleddirectory.
SettheUSER_MEM_ARGSvariablespecifytheJVMmaximummemorysetting.
ChangingUnifierConfiguratorSettingsonWindowsTheUnifierenvironmentisconfiguredthroughtheUnifierConfiguratorwindow.
TochangesettingsinUnifierConfigurator:1)OpentheWebLogicdirectoryintheUnifierHomefolder.
2)Runconfigure.
bat.
3)Configurethesettingsforeachtab.
4)ClickSaveoneachtab.
5)RestartUnifierforthechangestobeoperative.
GeneralTabServerType:ThesettingthatdefinesthemodeUnifierserverisrunning.
SetServerTypetoProductionifthisUnifierinstallationisactingastheUnifierproductionenvironment.
Inthisenvironment,youcannotpublishconfigurationpackages.
SetServerTypetoDevelopmentifthisUnifierinstallationisactingasthedevelopmentserverfortestingofbusinessprocessesandotherUnifierdesignsandconfigurations.
YoucannotconvertaDevelopmentenvironmenttoaProductionenvironmentbecauseallthedesigns,inuDesigner,mustbepublishedintheProductionenvironment.
IfyoudonotselectDevelopment,youwillnotbeabletoedituDesignerdesignssincedesignsareavailableasread-onlyintheTest,orProduction.
SetServerTypetoTestifthisUnifierinstallationisactingasthetestserverfortestingofbusinessprocessesandotherUnifierdesignsandconfigurations.
Inthisenvironment,youcannotpublishconfigurationpackagesandmodifyBPdesigns.
Youcanmodifyothersetups,configurationsandimportunpublishedconfigurationpackage.
Note:YoumustsettheServerTypetoDevelopmentifyouwanttomodifyuDesignerdesigns.
TemporaryDirectory:EnterthetemporarydirectoryforUnifierserveroperations.
TheTemporaryDirectorymustbelocaltotheserver.
IfyoudonotwanttoplacetheTemporaryDirectoryonalocalserver,thenyoumustselectadifferentvalueforthesharedlocation.
UnifierInstallationGuideforOn-Premises26BackgroundJobDisabled:Selecttodisablebackgroundjobs.
EnableRESTServices:Selecttoenablecompany-levelRESTservices.
Inaddition,youmustensurethatOWSMissetupinUnifierservertohandleauthentication.
ServerInternalURL:EntertheWebLogicServerURLrunningtheUnifier(Forexample:http://host1.
example.
com:7001)Note:BIPublisherandMarkupserversusethisURLtocommunicatewithUnifier.
LoginSessionTimeout:LoginSessionTimeoutisusedtocontroltheamountoftimeausercanbeidlebeforehavingtologbackintoUnifier.
Theunitisseconds.
Forsecurityreasons,therecommendedtimeoutsettingisbetween30minutesand4hours.
LateNoticeInterval:Interval,inminutes,usedbytheinternaljobserverfornotificationtasks.
Thesuggestedintervalis15minutes.
Averysmallintervalmaydegradeperformance.
Max.
Concurrence:Themaximumnumberofconcurrence.
ServerLabel:ThisfielddisplaysonlyforTestservers.
EnteracustomnamefortheTestserver.
Thenamecannotexceed30charactersandcannotbelabeledDevelopmentorProduction.
Itcanincludeallspecialcharactersexcept-(dash/hyphen)and_(underscore).
UPKHelpURL:EntertheURLwheretheUserProductivityKit(UPK)helpcontentistobehosted(asagenericexample,http://servername/contextroot,orasaspecificexampleishttp://localhost/unifierupk).
UnifierHelpURL:TodeployalocalversionoftheUnifieronlinehelp,entertheURLwherethehelpfileistobehosted.
Bydefault,theonlinehelpisdeployedfromthesitehostedbyOracle.
RepositoryTab(CMIS)ThefollowingfieldsdisplaywhenyouselectCMISintheFileRepositoryfield.
CMISLoginName:Entertheusernameforyourcontentrepository.
CMISPassword:PasswordfortheCMISloginname.
CMISRepositoryName:Thecontentrepositoryname.
CMISDocumentationHome:Thedocumentationhome.
CMISWebServiceURL:TheURLforyourwebserviceshome.
InstallingUnifieronWindows27Notes:ItisimportanttoplanwherethesedirectoriesarelocatedbecausetheyarewhereUnifierdataisstored.
AnysubsequentupgradeinstallationsneedtopointtothesesamelocationinorderforUnifierto'see'datapreviouslyentered.
Theserepositories,inadditiontoyourdatabase,shouldbebackedupregularly.
Whennamingthefolders,besuretherearenospacesinthefoldernames.
Thesefilesmustbeonashareddrivethatisaccessiblebyotherservermachinesthatareoperatinginaclusteringenvironment.
IndexDirectory:ThisfolderisforindexfilesusedinDocumentManagersearchfunction.
ThisfieldisnotvisiblewhenrepositoryissettoCMIS.
LogFileDirectory:Thefolderwherethelogfilesarestored.
WhenUnifierisinstalledonamultibyteserverandconnectingtoSharePointorCMIS:Add"-Djavax.
xml.
parsers.
DocumentBuilderFactory=com.
sun.
org.
apache.
xerces.
internal.
jaxp.
DocumentBuilderFactoryImpl"Javaoptiontosetenv.
sh/setenv.
batfile.
RestartUnifier.
TheabovesettingsenableyoutoviewdocumentsinCMIS.
ExamplesSettinginsetenv.
batfile:SETJAVA_OPTIONS=%JAVA_OPTIONS%-Djavax.
xml.
parsers.
DocumentBuilderFactory=com.
sun.
org.
apache.
xerces.
internal.
jaxp.
DocumentBuilderFactoryImplSettinginsetenv.
shfile:exportJAVA_OPTIONS="$JAVA_OPTIONS-Djavax.
xml.
parsers.
DocumentBuilderFactory=com.
sun.
org.
apache.
xerces.
internal.
jaxp.
DocumentBuilderFactoryImpl"RepositoryTab(Database)ThefollowingfieldsdisplaywhenyouselectDatabaseintheFileRepositoryfield.
HostName:Enterthehostnameofthecomputerwhereyouinstalledthedatabase.
InstanceID:TheInstanceIDfieldintheConfiguratorcanacceptthefollowingvalues:AnOracleSIDAnOracleservicename(OracleDatabase)UnifierInstallationGuideforOn-Premises28Note:Forthefulllistofsystemrequirements,applications,andapplicationversionlevelsrefertotheUnifierTestedConfigurationsintheUnifierDocumentationLibrary.
WhenyouenteraservicenameforanOracleservicename(OracleDatabase),youmustprefacethenamewithaforwardslash(/),forexample,/servicename.
Ifyoudonotprefacethenamewithaforwardslash(/),thesystempresumesthatyouhave:EnteredanOracleSID,ifyouhadselectedOraclefromthedrop-downlist.
Port:EnterthePortnumbertobeusedbyUnifiertocommunicatewiththedatabase(Forexample:1521).
UserName:Enterthedatabaseloginuseraccountname(createdinOracle)tobeusedbyUnifier.
ThedatabaseloginuseraccountneedstohavesufficientpermissionstocreatetablesinorderforUnifiertoworkcorrectly.
UserPassword:EnterthedatabaseloginuseraccountpasswordtobeusedbyUnifier.
Theuserhastohavethefollowingpermissions:ConnectResourcectxappCreatejobexecuteonctxsys.
ctx_ddlexecuteondbms_schedulerLogFileDirectory:Thefolderwherethelogfilesarestored.
RepositoryTab(NetworkFileSystem)ThistopicapplieswhenyouselectNetworkFileSystemfortheFileRepositoryfield.
Therearetwodatarepositories(foldersinwhichUnifierdataisstored),whichUnifierrequiresyoutoconfigure.
Thereareadditionalrepositories,suchasthearchivedirectoryforprojectarchiving,thatareusedwithspecificfeatures,asdescribedbelow.
Thesecanbelocatedonalocalbutseparateharddrive,oronamappeddriveonyournetwork.
FileRepository:Inthisfield,selectNetworkFileSystemfromthedrop-downlist.
InstallingUnifieronWindows29Notes:ItisimportanttoplanwherethesedirectoriesarelocatedbecausetheyarewhereUnifierdataisstored.
AnysubsequentupgradeinstallationsneedtopointtothesesametwodirectoriesinorderforUnifierto'see'datapreviouslyentered.
Theserepositories,inadditiontoyourdatabase,shouldbebackedupregularly.
Whennamingthefolders,besuretherearenospacesinthefoldernames.
FileDirectory:Enter(orBrowseto)thepathwhereuploadedorattachedfilesarestored.
ThisrepositoryisforstoringdocumentswithintheDocumentManager,suchasdrawings,plans,Worddocuments,etc.
ThesefileswillbeavailableforviewingorattachingtobusinessprocessformswithinUnifier.
Italsostoresimportedschedulefiles.
Notes:Thesefilesmustbeonashareddrivethatisaccessiblebyotherservermachinesthatareoperatinginaclusteringenvironment.
EnsurethattheuserwhohasstartedtheUnifierapplicationisanetworkuserandhasaccesstonetworkfilesystem.
EnsurethattheFiledirectoryvalueissameinallthemachinesinthecluster.
UsetherepositorymachinenameorIPaddresstospecifytheshareddrivelocation.
Ensurethatenoughdiskspaceisavailableonthenetworkfilesystem.
IndexDirectory:ThisisthepathnametothelocationwheretheSearchIndexfilesarestored.
LogFileDirectory:Thefolderwherethelogfilesarestored.
RepositoryTab(WebCenterContent)ThistopicapplieswhenyouselectWebCenterContentfortheFileRepositoryfield.
FileRepository:SelectWebCenterContent.
WebCenterContentServerHost:ThisistheIPaddressoftheWebCenterContentserver.
WebCenterContentServerPort:ThisistheportoftheWebCenterContentserver.
WebCenterContentUser:ThisistheuserwhowilladddocumentsthroughtheAPI.
TheusershouldexistintheWebCenterContentserver.
WebCenterContentRootFolder:TherootfolderinWebCenterContentunderwhichallUnifierfolderswillbecreated.
Notes:ItisimportanttoplanwherethesedirectoriesarelocatedbecausetheyarewhereUnifierdataisstored.
AnysubsequentupgradeUnifierInstallationGuideforOn-Premises30installationsneedtopointtothesesamelocationinorderforUnifierto'see'datapreviouslyentered.
Theserepositories,inadditiontoyourdatabase,shouldbebackedupregularly.
Whennamingthefolders,besuretherearenospacesinthefoldernames.
Thesefilesmustbeonashareddrivethatisaccessiblebyotherservermachinesthatareoperatinginaclusteringenvironment.
LogFileDirectory:Thefolderwherethelogfilesarestored.
TestWebCenter:Enablesyoutovalidatetheconfigurationsettingsthatyouhaveentered.
DatabaseTab(Oracle)Theinformationenteredinthistabisbasedonyourearlierdatabaseanduseraccountcreation.
DatabaseType:SelectOracle.
HostName:Enterthehostnameofthecomputerwhereyouinstalledthedatabase.
InstanceID:TheInstanceIDfieldintheConfiguratorcanacceptthefollowingvalues:AnOracleSIDAnOracleservicename(OracleDatabase)Note:Forthefulllistofsystemrequirements,applications,andapplicationversionlevelsrefertotheUnifierTestedConfigurationsintheUnifierDocumentationLibrary.
WhenyouenteraservicenameforanOracleservicename(OracleDatabase),youmustprefacethenamewithaforwardslash(/),forexample,/servicename.
Ifyoudonotprefacethenamewithaforwardslash(/),thesystempresumesthatyouhaveenteredanOracleSID.
Port:EnterthePortnumbertobeusedbyUnifiertocommunicatewiththedatabase(Forexample:1521).
UserName:Enterthedatabaseloginuseraccountname(createdinOracle)tobeusedbyUnifier.
ThedatabaseloginuseraccountneedstohavesufficientpermissionstocreatetablesinorderforUnifiertoworkcorrectly.
UserPassword:EnterthedatabaseloginuseraccountpasswordtobeusedbyUnifier.
Max.
Connections:Thesettingthatdefinesthemaximumconnectionstothedatabase.
Themaximumis400;therecommendedmaximumis80to100.
Min.
Connections:Thesettingthatdefinestheminimumconnectionsthatmustbeconnectedtothedatabase.
TestConnection:ClickTestConnectiontoverifythattheApplicationserverandthedatabaseareconnectedandcommunicating.
ATestissuccessfulmessagewillappeariftestissuccessful.
Twoconditionsaretested:InstallingUnifieronWindows31AbilityofUnifiertoconnecttothedatabaseLevelofpermissionsgrantedtothedatabaseloginuseraccountEmailTabOutbound(SMTP)E-mailServer:(Required)EntertheIPaddressortheURL/machinename.
E-mailSenderPrefix:EntertheemailprefixthatwillbeusedintheSender'snamewheneveranemailisgeneratedfromauserfromwithinUnifier,forexample,Unifier.
LateemailnotificationsshowtheE-mailSenderPrefix,only.
SupportContactInformation:Thisfieldcontainsthemessagetextthatisincludedinallsupport-relatedemailnotifications.
Toenableanemailaddressasahyperlink,usethefollowingformat:name@example.
comOutbound(SMTP)AuthenticationRequired:SelectifauthenticationisrequiredbytheoutboundSMTPemailserver.
ProxyServerURLforAPNsServerURLoftheproxyserverusedtoconnecttoApplePushNotificationService.
ProxyServerPortforAPNsServerPortoftheproxyserverusedtoconnecttoApplePushNotificationService.
Outbound(SMTP)EmailAccount:EntertheoutboundEmailaccount.
Outbound(SMTP)EmailPassword:EnterthepasswordthatcorrespondstotheoutboundEmailaccount.
Note:UnifiersupportsoutboundemailwithoutauthenticationorwithauthenticationusingSSL.
SystemNotificationE-mailAddress:ThisfieldcontainstheemailIDthatthesystemdisplaysasthe"Sender's"emailaddressforallemailsgeneratedbytheUnifiersystem,forexample,admin@example.
com.
ProjectEmailPatter:Thisfieldhasthefollowingvalues:SuffixandPrefixanddeterminestheprojectemailIDsupported(-@oracle.
comor+@oracleindustry.
com).
SystemErrorNotificationE-mailAddress:ThisfieldcontainstheemailaddresswhereUnifiersendsanotificationifUnifierlosesconnectiontothedatabasewhilethesystemisrunning.
Theemailaddressescanbeseparatedbysemicolon.
LicenseNotificationE-mailAddress:ThisfieldcontainstheemailaddresswhereUnifiersendslicensingnotifications,forexample,ifthenumberofusersexceedsthenumberofavailablelicenses.
Ifthenumberofusersexceedsthenumberofavailablelicenses,thenthesystemsendsnotificationstothefollowing:Usersspecifiedintheconfigurator(UnifierConfiguratorWebLogic).
UserswhohaveNotifypermissionintheLicenseManager,whichwassetinAccessControl.
UnifierInstallationGuideforOn-Premises32InboundE-mailprotocol:Selecttheprotocolusedbytheinboundemailserverthatcanreceiveemail.
ThesupportedprotocolsarePOP3,IMAP,POP3S,andIMAPS.
EachUnifierenvironment(Development,Test,andProduction)mustbeconfiguredwithitsowninboundemailaccount.
Topreventundesiredresults,donotusethesameinboundemailforalltheenvironments.
InboundE-mailServer:Entertheserverthatcanreceiveemail,forexample,ifausertakesactionviaemailonabusinessprocess.
ThiscanbetheservernameorIPaddress.
(Optional)YoucanspecifytheportnumberaftertheservernameofIPaddress,forexample,example.
com:1521.
InboundE-mailAccount:Entertheemailaccounttoreceiveresponseemailfromtheuser.
TousetheprojectorshellMailbox,whichallowsexternalemailmessagestobesenttoandstoredwithinacentralprojectorshellmailbox,usethefollowingformatfortheinboundemailaccount.
Thisallowsacceptanceofinboundemailssenttothesystem-generatedproject/shellemailaddresses:*-inboundemailname@example.
com.
Thisconfigurationisneededontheemailserver,notwithintheUnifierConfigurator.
InboundE-mailPassword:Thisfieldcontainsthepasswordthatcorrespondstotheinboundemailaccount.
Thispasswordisusedwhenemailisretrieved.
TestInboundConnection:EnablesyoutotesttheInboundE-mailServer,InboundE-mailAccount,andInboundE-mailPassword.
TestOutboundConnection:EnablesyoutotesttheoutboundE-mailServer,outboundE-mailAccount,andoutboundE-mailPassword.
AboutInboundE-mailIfyouareusingaopen-sourcehMailServertoconfigureUnifierforinboundemails,ensurethatyouturnoffthe"autoban"feature.
Ifyoudonotturnoffthe"autoban"feature,thenyouwillnotbeabletouseUnifierfunctionalitiessuchasProjectMailboxandWorkflowactionviewE-mail.
TheProjectMailboxfunctionalityrelyonemailaddressusedforBPActionviaEmail.
IftheInboundemailaddressisunifier_oracle@unifiermail.
com,thentheemailaddressofaProject/Shellcouldbeoneofthefollowing,dependingonthepropertyvalueintheskire.
project.
email.
patterninskire.
propertiesfile.
Thispropertycanhavetwovalues:"prefix"orblankand"suffix.
"Thispropertycanbeseteithermanually(intheskire.
propertiesfile)orbyselectingtheappropriatevaluefromUnifierConfigurator-EmailTabandsavingthechanges.
Incasethepropertyvalueis"prefix"orblankTheemailaddressofanyUnifierProject/Shellwillfollowthepattern-unifier_oracle@unifiermail.
comusedforProjectMailboxfunctionality.
Forexample,iftheprojectidis1001,thenemailaddressforthisparticularProject/Shellwillbe1001-unifier_oracle@unifiermail.
com.
Forthistofunction,youhavetosetupanemailforwardingruleonyourmailserversuchthatanyemailssentto.
*-unifier_oracle@unifiermail.
comwillbeautomaticallyforwardedtounifier_oracle@unifiermail.
comInbox.
InstallingUnifieronWindows33Incasethepropertyvalueis"suffix"TheemailaddressofanyUnifierProject/Shellwillfollowthepatternunifier_oracle+@unifiermail.
comusedforProjectMailboxfunctionality.
Forexample,iftheprojectidis1001,thenemailaddressforthisparticularProject/Shellwillbeunifier_oracle+1001@unifiermail.
com.
Forthistofunction,youhavetosetupanemailforwardingruleonyourmailserversuchthatanyemailssenttounifier_oracle+.
*@unifiermail.
comwillbeautomaticallyforwardedtounifier_oracle@unifiermail.
comInbox.
Ifyouareusinganemailaddressonoracleindustry.
comdomain,youmustusethe"suffix"pattern,andyoumust,explicitly,setskire.
project.
email.
pattern=suffixbecausethispropertyisnotexposedincurrentUnifierconfigurator.
Theemailforwardingrule(forsuffixpattern)isenabledonthisdomainbydefault.
OnUnifierconfigurator,ensurethatyouincludetheportnumberforthecurrentprotocolinInboundE-mailServerfield,forexample,unifiermail.
com:110ororacleindustry.
com:993.
Theprotocolandportmappingareasfollows:POP3-port110IMAP-port143IMAPS-port993POP3S-port995TopreventthespamemailstogointheProjectMailbox,thesystemacceptsemailsfromemailaddressesassociatedwithUnifieruseraccountortheemailaddresseslistedinApprovedEmailListbyCompanyAdmin,only.
MarkupServerTabUseServerInternalURL:(Optional)SelectthisoptiononlyifserverinternalURLaddressmustbeusedbymarkupservertocommunicatewithUnifier.
Ifnotselected(default),Theuser'sloginbaseURLaddressisusedbymarkupservertocommunicatewithUnifier.
MarkupServerHostName:Enterthehostnameofthemarkupserver.
MarkupServerPort:Entertheportnumberofthemarkupserver.
ThedefaultportnumberforAutoVueis5099.
ImportantinformationaboutAutoVueWhenUnifierisinstalledonamultibyteserverandconnectingtoAutoVue,orwhenyouarehavingissueswithviewingdocumentsinAutoVuefromUnifier:1)Add"-Djavax.
xml.
parsers.
DocumentBuilderFactory=oracle.
xml.
jaxp.
JXDocumentBuilderFactory"Javaoptiontosetenv.
batfile.
2)RestartUnifier.
TheabovesettingsenableyoutoviewdocumentsinAutoVue.
ExampleUnifierInstallationGuideforOn-Premises34Settinginsetenv.
batfile:SETJAVA_OPTIONS=%JAVA_OPTIONS%-Djavax.
xml.
parsers.
DocumentBuilderFactory=oracle.
xml.
jaxp.
JXDocumentBuilderFactorySettinginsetenv.
shfile:exportJAVA_OPTIONS="$JAVA_OPTIONS-Djavax.
xml.
parsers.
DocumentBuilderFactory=oracle.
xml.
jaxp.
JXDocumentBuilderFactory"ReportTabBIPEndpointURL:EntertheBIPWebServicesendpointURL.
Forexample:http://host1.
example.
com:9502BIPUserName:EntertheusernamecreatedfortheBIPublisherserver.
BIPPassword:EnterthepasswordfortheBIPublisheruser.
BIPDataSource:EntertheJDBCdatasourcenamethatwasenteredwhentheJDBCDataSourceBIPublisherBIPReportFolder:ThefolderunderthedefaultlocationintheBIPublishercatalog.
Reportsresideinthisfolderbasedoncompanyregistry.
BIPExternalReportFolder:ThefolderunderthedefaultlocationintheBIPublishercatalog.
ExternalReports,synchronizedinUnifier,resideinthisfolder.
Note:ThevaluesusedintheBIPUserName,BIPPassword,BIPDataSource,andBIPReportfolderfieldsarethesameasthosecreatedwhenusingtheUnifierBIPublisherConfigurationGuide.
OBIEEAnalyticsURL:TheURLtoOBIEEAnalyticsservice.
ThisURLshouldbeaccessibleviainternet.
TestReportConnection:Enablesyoutovalidatetheconfigurationsettingsthatyouhaveentered.
GeoMapTabMapServerUrl:Enterhttps://elocation.
oracle.
com.
ThisistheOracleMapserverbaseURLwheretheOracleMapVeiwerapplicationisdeployedwiththecontext"mapviewer".
Thisiswheretheserverobtainsthemapimage.
MapTile:Enterelocation.
world_map.
Thisisthenameofthemaptilelayer(thebasemapusedformaprendering)thatwaspre-definedontheOracleMapserver.
Thisisthemapdatasource.
MapGeocoderUrl:Enterhttps://elocation.
oracle.
com.
ThisistheserverURLwheretheOracleGeocoderapplicationisdeployedwiththecontext"geocoder.
"Thisisthelocationservice.
AuthenticationTab(Native)AuthenticationType:NativeInstallingUnifieronWindows35TheUnifierdefaultauthenticationmechanismisused.
LoginURL:EntertheURLtologintoUnifier.
AuthenticationTab(OIM/OAM)AuthenticationType:OIM/OAMThesystemdetermineswhetherintegrationofPrimaveraUnifierwithOracleIdentityManager(OIM)andOracleAccessManager(OAM)isenabled.
SSOLogout:ThelogoutURLforOracleAccessManager(OAM)oranythird-partySingleSignOn(SSO)configuration.
Formoredetails,refertoOracleAccessManagerdocumentation.
LoginURL:EntertheURLtologintoUnifier.
AuthenticationTab(WebLogic)AuthenticationType:WeblogicForm-basedauthenticationisusedtointegratewithWebLogicauthenticationmethods.
AfterWebLogicauthenticatestheuser,UnifierdeterminesiftheuserisavalidUnifieruserbeforegrantingaccesstotheapplication.
Realm:Weblogicrealmthatisusedforauthentication.
Group(s)(commaseparated):Weblogicgroupname,acommaseparatedlist,usedformappingWeblogicgroupsto"unifieruser"role.
LoginURL:EntertheURLtologintoUnifier.
AuthenticationTab(LDAPSimpleBind)TheLightweightDirectoryAccessProtocol(LDAP)isaprotocolforquerying,andmodifying,directoryservices.
TheAdministratorcanconfiguretheservertouseeithersimple-bindordouble-bindauthentication.
AuthenticationType:LDAPSimpleBindLoginURL:EntertheURLtologintoUnifier.
Provider:ToconnecttheLDAPserver(URL),forexample,ldap://ldap.
zyz.
com:636SSL:ToconnecttotheSecureSocketsLayer(SSL)enabledportoftheLDAPserver.
Note:OraclerecommendsyoualwaysuseSSLinaproductionenvironmentforsecurecommunications.
WhenUnifierisconfiguredwithJDK8andintegratedwithLDAPSSL:Add"-Djdk.
tls.
client.
protocols=TLSv1"Javaoptiontosetenv.
shfile.
RestartUnifier.
TheabovesettingsenableyoutologinusingLDAPSSL.
UnifierInstallationGuideforOn-Premises36ExampleSettinginsetenv.
shfile:exportJAVA_OPTIONS="$JAVA_OPTIONS-Djdk.
tls.
clent.
protocols=TLSv1"SecurityPrincipalTemplate:Toauthenticatedirectly,basedontheusernameandpassword(SimpleBind).
Thetemplateisusedtoconstructtheuser'sDistinguishedName(DN),forexample,cn={0},l=amer,dc=oracle,dc=comAdminUserBypass:ToallowadministratorstobypassLDAPlogin.
AuthenticationTab(LDAPDoubleBind)TheLightweightDirectoryAccessProtocol(LDAP)isaprotocolforquerying,andmodifying,directoryservices.
TheAdministratorcanconfiguretheservertouseeithersimple-bindordouble-bindauthentication.
AuthenticationType:LDAPDoubleBindLoginURL:EntertheURLtologintoUnifier.
Provider:ToconnecttheLDAPserver(URL),forexample,ldap://ldap.
zyz.
com:636SSL:ToconnecttotheSecureSocketsLayer(SSL)enabledportoftheLDAPserver.
WhenUnifierisconfiguredwithJDK8andintegratedwithLDAPSSL:Add"-Djdk.
tls.
client.
protocols=TLSv1"Javaoptiontosetenv.
shfile.
RestartUnifier.
TheabovesettingsenableyoutologinusingLDAPSSL.
ExampleSettinginsetenv.
shfile:exportJAVA_OPTIONS="$JAVA_OPTIONS-Djdk.
tls.
clent.
protocols=TLSv1"ProviderBase:(Optional)WhenyouselecttheDoubleBindmethodofauthentication,youneedtofindtheuser'sDNandthenauthenticatethem.
Findingtheuser'sDNisusedasthebaseforsearchingtheLDAPtree.
IftheProvidedBaseisnotset,therootisassumedbythesystem:ldap.
provider.
baseAuthorizedUser:WhenusingtheDoubleBindmethodofauthentication,findtheuser'sDistinguishedName(DN)andthenauthenticate.
Thisisusedasthe"trusted"or"search"loginuser'sDN(firstbind).
AuthorizedUserPassword:WhenusingtheDoubleBindmethodofauthentication,thisistheauthorizeduser'sloginpassword.
SearchField:Thedefaultvalueis"cn.
"Youneedtoenterthenodefieldthatyouwanttosearch.
AdminUserBypass:ToallowtheadministratorbypasstheLDAPlogin.
TestUserName(notSaved):EntertheLDAPusernametotesttheLDAPserver.
TestUserPassword(notSaved):EntertheLDAPpasswordtotesttheLDAPserver.
InstallingUnifieronWindows37AuthenticationTab(GenericSSO)UserAuthenticationType:GenericSSOLoginURL:EntertheURLtologintoUnifier.
SSOHeader:HeadervalueusedwhileconfiguringSSO.
Note:ForOAMSSO,thevalueisOAM_REMOTE_USERandforShibboleth,thevalueisREMOTE_USER.
SSOLogout:ThelogoutURLforOracleAccessManager(OAM)oranythird-partySingleSignOn(SSO)configuration.
Formoredetails,refertoOracleAccessManagerdocumentation.
Note:IfUnifierisconfiguredwithShibbolethasSPandIDP,addthefollowingoptionProxyPreserveHostOninthehttpd-ssl.
conffileintheShibbolethSP.
AdvancedTabEnablePasswordEncryptionWhenthepasswordencryptionisenabled,thesystemsavesthesignatureinbluedoorpropertiesfile,orasecurelocation.
SecureKeyLocationThedirectorypathwherethefilecontainingfile"unifier.
properties"willbestored.
The"unifier.
properties"filewillcontainthe"unifier.
secure.
seed"property.
Thissettingisoptional.
Ifnotset,thesecurekey(arandomstring)willbegeneratedbytheConfiguratorandstoredinthe"skire.
properties"file.
Ifafolderlocationisgivenasasecurekeylocation,thenthekeywillbestoredinanadditionalpropertyfileinthegivenfolderforextrasecurity(assumingthatthesecurekeyfolderisafolderwithveryselectiveaccessthatisnotreadablebymostITpersonnel).
ThislocationmustbeaccessiblefromUnifierserver.
PartnerLoginURLTheJVMdefaulttimezone.
Thistimezonemustmatchthejavastartupparameters.
Forexample:Duser.
timezone=America/Chicago.
Ifset,Unifiergeneratedemailsenttopartneruser(usersthatdonotbelongtotheownercompany)containingthegivenloginURL.
AlluseremailswillhavethesameloginURLdefinedintheemailtab,normally.
ThisloginURLisusedinCloudenvironmentwheretheownerandpartnerusedifferentSSOsolution.
ServerTimeZoneTheservertimezone.
BackgroundJobThreadsUnifierInstallationGuideforOn-Premises38Thenumberofthreadsforbackgroundjobs.
HighPriorityJobThreadsThenumberofthreadsforhighpriorityjobs.
OracleMapServer:ProxyServerURLTheURLfortheproxyserverthatisusedtoconnecttoOracleMap/Geocoderserver.
Unifierconnecttoelocation.
oracle.
comtogetlocationinformationfromtheUSaddress.
Thisistheproxysettingrequired(ifnecessary)forUnifierservertoconnecttoelocationserver.
OraclemapServer:ProxyServerPortPortfortheproxyserverthatisusedtoconnecttoOracleMap/Geocoderserver.
Unifierconnecttoelocation.
oracle.
comtogetlocationinformationfromtheUSaddress.
Thisistheproxysettingrequired(ifnecessary)forUnifierservertoconnecttoelocationserver.
SavingtheConfigurationSettingsYoumustsaveyourconfigurationdatatoaconfigurationfile.
IntheUnifierConfigurationwindow,clickFile,Save.
Note:RestartUnifierforthechangestobeoperative.
ChangingConfigurationSettingsonWindowsAfterinitiallyinstallingandconfiguringUnifier,followthisproceduretomakeanysubsequentchangestotheconfigurationsettings:1)StoppingUnifierinWebLogiconWindows(onpage38)2)EditingConfigurationDataonWindows(onpage38)3)StartingUnifierinWebLogiconWindows(onpage39)StoppingUnifierinWebLogiconWindowsTostoptheUnifierapplicationinWebLogic:1)OpentheWebLogicdirectorywithintheUnifierHomefolder.
2)Runthestop.
batfile.
3)Ifprompted,entertheWebLogicusernameandpassword.
EditingConfigurationDataonWindowsAfterstoppingUnifierinWebLogic,makechangestotheUnifierconfigurationsettingsasfollows:1)IntheWebLogicdirectorywithintheUnifierHomefolder,locatetheconfigure.
batfile.
2)Runconfigure.
bat.
3)MakenecessaryconfigurationchangesandclickSave.
InstallingUnifieronWindows394)RestartUnifierinWebLogic.
StartingUnifierinWebLogiconWindowsAfteranewinstallation,Unifiermustbestoppedbeforeyoucanmakeanychangestotheconfigurationsettings.
Besuretorestartitafterward.
TostarttheUnifierapplicationinWebLogic:1)OpentheWebLogicdirectorywithintheUnifierHomefolder.
2)Runthestartup.
batfile.
3)Ifprompted,entertheWebLogicusernameandpassword.
CopyingtheConfigurationDataFileTheconfigurationdatafortheConfiguratorisstoredautomaticallyundertheinstallationfolderinthe/configurator/bluedoor.
propertiesfile.
Ifnecessary,youcantransfertheconfigurationsettingsfromoneenvironmenttoanotherbycopyingtheconfigurationdatafileandeditingitwiththenewconfigurationsettings.
ConfiguringtheOHTTPServer(OHS)AfterinstallingOHTTPServer(OracleHTTPServer),orOHS,configureasfollows:1)Modifythe$ORACLE_INSTANCE/config/OHS/ohs1/httpd.
conffileasfollows:a.
Changethedefaultlistenportfrom7777to80.
Note:Beforemakingtheabovechange,disableorturn-offanyotherapplicationthatisusingport80(suchasIISorWindows).
b.
AddsettingsafterDocumentRootasfollows:DocumentRoot/apps/ROOTc.
Addparametersbetweensoitappearsasfollows:/apps/ROOT">OptionsIncludesFollowSymLinksAllowOverrideNoneRequireallgrantedDirectoryIndexindex.
html/apps/ROOT/WEB-INF">Requirealldeniedd.
#SupportHttpmethodGET/POSTonlyRewriteEngineOnRewriteCond%{REQUEST_METHOD}!
^(GET|POST)RewriteRule.
*-[F]UnifierInstallationGuideforOn-Premises40e.
HeadersetContent-Security-Policy"default-src'self';frame-src*;child-src*;script-src'self''unsafe-inline''unsafe-eval'http://elocation.
oracle.
comhttps://elocation.
oracle.
com*.
oracle.
com;style-src'self''unsafe-inline';img-src'self'data:http://elocation.
oracle.
comhttps://elocation.
oracle.
com*.
oracle.
com"HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"InstallingUnifieronWindows41HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"UnifierInstallationGuideforOn-Premises42HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"Notes:istheunifierinstallationdirectory.
ThesessionaboutSupportingHttpmethodGET/POSTonlycanbe(ormaybe)addedattheendofhttp.
conffile.
2)Addthefollowingtothe$ORACLE_INSTANCE/config/OHS/ohs1/mod_wl_ohs.
conffile:SetHandlerweblogic-handlerWebLogicHostlocalhostWebLogicPort7001ExpiresActiveonExpiresDefault"accessplus6month"HeadersetX-Content-Type-Options"nosniff"InstallingUnifieronWindows43HeadersetX-XSS-Protection"1;mode=block"LoadModuledeflate_module"${ORACLE_HOME}/ohs/modules/mod_deflate.
so"SetOutputFilterDEFLATEDeflateBufferSize20000Note:Modifytheenteries(#2)underasnecessary:WebLogicHost:WeblogicserverhostnameorIPaddress.
ForWebLogicPort:Weblogicserverportnumber.
The"deflate_module"mustbeloadedbefore"/instances/instance1/config/OHS/ohs1/mime.
types3.
Modifythe$ORACLE_INSTANCE/config/OHS/ohs1/ssl.
conffileasfollows:ForOHTTP,orOHS,version:Note:Forthefulllistofsystemrequirements,applications,andapplicationversionlevelsrefertothePrimaveraUnifierTestedConfigurationsinthePrimaveraUnifierDocumentationLibrary.
Replace:SSLProtocolnzos_Version_1_0nzos_Version_3_0With:SSLProtocol-all+TLSv1.
2Replace:SSLCipherSuiteSSL_RSA_WITH_RC4_128_MD5,SSL_RSA_WITH_RC4_128_SHA,SSL_RSA_WITH_3DES_EDE_CBC_SHA,SSL_RSA_WITH_DES_CBC_SHA,TLS_RSA_WITH_AES_128_CBC_SHA,TLS_RSA_WITH_AES_256_CBC_SHAWith:SSLCipherSuiteHIGHNote:OraclerecommendstheSSLv3protocolforOHS11gversionandtheTLSv1.
2forOHS12cversion.
4.
OnWindows:RunstartNodeManager.
cmdandstartComponent.
cmdohs1OnLinux:Run.
/startNodeManager.
shand.
/startCOmponent.
shohs1Note:IfOAMisusedtosetupUnifierthenloginintoOAMconsole,navigatetoresourcestabandadd3resourcesinit:/jVue/**,/VueServlet/**and/jvueDMS/**.
TheProtectionlevelshouldbeexcludedforthenewlycreatedresources.
IfanyotherSSOserverisUnifierInstallationGuideforOn-Premises44usedthenperformthesimilarstepsinthisserver.
InstallingSSLCertificate(Optional)UnifierworksinSecureorNon-securemode.
InstallingaSecureSocketLayer(SSL)certificateisoptional.
DataBackupRecommendationsOraclePrimaverarecommendsthatPrimaveraUnifierdatabeincorporatedintoyourcompanybackupprocedures.
PrimaveraUnifierdataisstoredintwoplaces:UnifierdatabaseFilesRepositoryTheserepositoriesneedtobebackedupregularly.
DeployingUnifierTodeployUnifierintotheWebLogicdomain,completethefollowingprocedures:1)CreatinganEARFileFromtheConfigurator(onpage44)2)DeploythegeneratedEARfileusinganyofthefollowingmethods:DeployingUnifierFromtheUnifier_HomeDirectoryonWindows(onpage44)DeployingUnifierfromtheWebLogicAdministrationConsole(onpage45)CreatinganEARFileFromtheConfiguratorCompletethefollowingstepstocreatean.
EARfilefromtheconfigurator:1)AccesstheConfigurator.
2)Intheconfigurator,selectCreateEAR.
3)Bydefault,the.
EARfileiscreatedintheunifier/weblogicdirectory.
4)Savethefileasunifier.
ear.
5)Proceedtodeployunifier.
earinWebLogicusinganyofthefollowingmethods:DeployingUnifierFromtheUnifier_HomeDirectoryonWindows(onpage44)DeployingUnifierfromtheWebLogicAdministrationConsole(onpage45)DeployingUnifierFromtheUnifier_HomeDirectoryonWindowsAftercreatingthe.
EARfile,deployUnifierasfollows:1)Inthe\weblogicdirectory,createasetenv.
batfilebycopyingthesetenv_sample.
batfile.
2)Editthesetenv.
batfileasfollows:InstallingUnifieronWindows45Setthedomain_homevariabletospecifythepathofthedomainhomefolderthatwillbeusedbyUnifier.
SettheadminurlvariabletospecifyhostnameandportnumberusedbytheUnifierdomain.
Setthejava_homevariabletotheJDKinstalleddirectory.
SettheUSER_MEM_ARGSvariablespecifytheJVMmaximummemorysetting.
3)SavesetEnv.
bat.
4)Runstartup.
bat.
5)Rundeploy.
bat.
6)Whenprompted,entertheWebLogicusernameandpassword.
UnifierisdeployedinWebLogicusingthevariablessetinsetEnv.
bat.
Note:Thisprocessmaytakeseveralminutes.
DeployingUnifierfromtheWebLogicAdministrationConsoleAftercreatingthe.
EARfileintheConfigurator,deploythefilefromtheWebLogicAdministrationConsoleasfollows:1)IntheChangeCenterpane,selectLock&Edit.
2)IntheDomainStructurepane,selectDeployments.
3)IntheSummaryofDeploymentspane,selectInstall.
4)IntheInstallApplicationAssistantpane:a.
Specifythepathtotheunifier.
earfileandclickNext.
Forexample:c:\\weblogic\unifier.
ear.
b.
SelectInstallthisdeploymentasanapplicationandclickNext.
c.
AcceptthedefaultsandclickNext.
d.
ReviewtheconfigurationsettingsyouhavechosenandselectFinishtocompletetheinstallation.
5)IntheSettingsforunifierwindow,selectSave.
6)IntheChangeCenterpane,selectActivateChanges.
7)IntheDomainStructurepane,selectDeployments.
8)IntheSummaryofDeploymentspane:a.
Selectunifier.
b.
SelectthedownarrowtotherightoftheStartbuttonandselectServicingallrequests.
9)IntheStartApplicationAssistantpane,selectYes.
Note:TheunifierstatecolumnshouldbeActive.
IfthestateisStartRunning,refreshthescreenuntilthestatusischangedtoActive.
UnifierInstallationGuideforOn-Premises46LaunchingUnifierThissectiondescribeshowto:StartUnifierforthefirsttimeInstallUnifierapplicationsSetupyourcompanyBeforelaunchingPrimaveraUnifier,ensurethatyouhavereadtheGettingStartedsectionoftheUnifierHelp,whichcontainsimportantinformationaboutconfiguringyourbrowserforusewithPrimaveraUnifier.
UnifierURL(WebLogic)Inyourbrowser,navigatetotheURLthatlaunchestheUnifierapplicationlocally.
Forexample:http://unifier.
oracle.
com:7001StartingUnifierfortheFirstTimeIntheSignInwindow,signintoUnifierwiththedefaultAdministratorusername(Administrator)andpassword(Administrator).
Unifierimmediatelypromptsyoutochangeyourpassword.
Werecommendyoudosoimmediatelyforsecurityreasons.
Onceyouchangeyourpassword,UnifiercreatesyourAdministratoraccount.
TheAdministratoraccountistheonlyaccountwithpermissionsautomaticallysetforallfeatures.
TheAdministratorcannotbeamemberofanyproject,evenifcreatedintheHostingCompany.
DeployingUnifierOnlineHelpBydefaultUnifieronlinehelpisdeployedfromsitehostedbyOracle.
TodeployUnifierhelplocally,orfromanalternativeURL,proceedasfollows:1)FromtheHelptopicofthePrimaveraUnifierDocumentationLibrary,downloadhelp.
zip.
2)Extractthecontentsofthehelp.
ziptothefolderspecifiedintheUnifierHelpURLfieldintheGeneraltaboftheConfigurator.
47InstallingUnifieronLinuxCompletethefollowingprocedurestoinstallandconfigureUnifierforafirsttimeinstallation.
Eachstepcorrespondstoasectioninthisguide.
Note:Beforeyoubegin,createaninstallationaccountthathasfulladministrationprivilegesfortheserver.
Thisaccountisneededformaintenanceandupgrades.
1)DownloadUnifier.
2)Configurethedatabaseserver.
CompletethisstepbeforeconfiguringUnifier.
ThisinformationwillbeusedduringdatabaseconfigurationinUnifierConfigurator.
3)ConfigureWebLogicforUnifier.
4)InstallandconfiguretheReportsServer.
(Optional)5)InstallOracleWebCenterContent.
(Optional)6)InstallAutoVueServer.
7)ConfigureUnifierusingtheConfigurator.
8)ConfiguretheWebServer.
9)DeployUnifierinWebLogic.
10)LaunchUnifierandinstallUnifierapplications.
InThisSectionDownloadingUnifier47ConfiguringtheOracleDatabaseServer48InstallingtheAutoVueServer49ConfiguringWebLogicforUnifieronLinux.
51InstallingandConfiguringtheReportsServer(Optional)58InstallingOracleWebCenterContent(Optional)59ConfiguringUnifierUsingtheConfigurator.
59ConfiguringtheOHTTPServer(OHS)74DeployingUnifier79LaunchingUnifier.
81DownloadingUnifierDownloadUnifierbyfollowingthesesteps:1)Gotohttps://edelivery.
oracle.
com/(OracleSoftwareDeliveryCloud)andsignin.
2)NavigatetoaccessthePrimaveraUnifierpage.
UnifierInstallationGuideforOn-Premises48ThePrimaveraUnifierzipfileenablesyoutodownloadthenecessaryfilesforinstallingtheplatformversionoftheproduct,only.
TheplatformversionofUnifiercontainsalltheUnifiermodulesandallowstheuserstocreatetheirowndesigns(BusinessProcessesandAttributeforms).
ThisversionofUnifierdoesnothavepreconfigureddesigns.
InadditiontothePrimaveraUnifierzipfile,youwillseethefollowingzipfolders:ThePrimaveraUnifierToolszipfileenablesyoutodownloadthenecessaryfilesforinstallingvariousUnifier-relatedproducts.
ThePrimaveraUnifierDocumentationenablesyoutodownloadalltheUnifierdocuments.
ThePrimaveraUnifierProjectControlsenablesyoutodownloadthenecessaryfilesforinstallingtheUnifierProjectControlsBaseProduct,whichcontainpreconfigureddesigns(BusinessProcessesandAttributeforms).
ThePrimaveraFacilitiesandRealEstateManagementenablesyoutodownloadthenecessaryfilesforinstallingtheUnifierFacilitiesandRealEstateManagementBaseProduct,whichcontainpreconfigureddesigns(BusinessProcessesandAttributeforms).
IfyourlicensingagreementincludesPrimaveraUnifierProjectControlsand/orUnifierFacilitiesandRealEstateManagementbaseproducts(applications/products),theSiteAdministratorcandownloadandinstallthebaseproducts.
SeetheDownloadingandInstallingUnifierBaseProductssectionfordetails.
RecommendedSetupafterDownloadingUnifierUnifier(Platform)willbeavailableinyourenvironments.
Youneedaminimumoftwoenvironments:1)Development2)ProductionNote:AlthoughtheBASICfileswillbeavailable,sinceUnifier(Platform)isalreadyloaded,enteronlythecompanydetailstousetheUnifier(Platform).
ConfiguringtheOracleDatabaseServerThefollowingisanoverviewofthestepsrequiredtoconfiguretheOracleDatabaseforusewithUnifier.
Formoreinformationandspecificinstructions,refertoyourOracledocumentation.
Note:Forthefulllistofsystemrequirements,applications,andapplicationversionlevelsrefertotheUnifierTestedConfigurationsintheUnifierDocumentationLibrary.
ConfigureanOracleDatabaseforUnifierasfollows:1)Createaninstanceforthedatabase.
InstallingUnifieronLinux49Note:Youcanacceptthedefaultsexceptforthefollowing:EnsuretosetencodingtoUnicode(UTF-8).
2)Createauseraccountonthenewlycreateddatabase.
ForsuccessfulPrimaveraUnifier/uDesignerinstallation,makesureamplefreespaceofatleast2GBisavailableforthedefaulttablespacewherethenewuserwillbelocated.
3)Grantthenewuserwithconnect,resource,createview,andcreatetableprivileges.
Note:ThisinformationwillbeusedlaterforsettingdatabaseinformationintheDatabasetaboftheUnifierConfigurator.
Forexample:createuserunifieridentifiedbyunifiertemporarytablespacetempdefaulttablespaceusers;grantconnect,resource,createview,createtabletounifier;Notes:(Required)EnsurethatmaximumopencursorinOracleDBissetto1000,orabove.
EnsurethatDatabaseuserquotaissettounlimitedontablespaceusers.
ImplementingTransparentDataEncryption(Optional)TransparentDataEncryption(TDE)isanOracleAdvancedSecurityfeaturethatisusedforOracleDatabaseencryption.
TDEprovidesstrongprotectionfrommaliciousaccesstodatabasefilesbyencryptingdatabeforeitiswrittentostorage,decryptingdatawhenbeingreadfromstorage,andofferingbuilt-inkeymanagement.
FormoreinformationaboutTDE,refertotheOracleAdvancedSecurity:http://www.
oracle.
com/technetwork/database/options/advanced-security/overview/index.
html.
InstallingtheAutoVueServerAutoVueinstallationismandatoryifyouplantouseUnifierMarkupfeature,alsoreferredtoasredlining.
WhenattachingdocumentstoaBusinessProcess(BP)form,youcanaddmarkups(textnotesorgraphicalelements)thatdisplaydirectlyonthedocument.
Note:Themarkupsdonotalterthedocument.
Thissectiondescribesthefollowingprocedures:DownloadingandinstallingAutoVueConfiguringAutoVueDeployingCustomGUIAutoVueappletsUnifierInstallationGuideforOn-Premises50Notes:YoumusthavealicensetoinstallAutoVue.
TheAutoVueserverishigh-intensivewithregardtoCPU,I/O,memory,andgraphics.
So,foroptimalperformance,ensurethatthemachinerunningtheAutoVueserverisnotbeingusedforotherapplications.
Formoreinformation,refertoOracleAutoVueClient/ServerDeploymentInstallationandConfigurationGuideavailableonOracleDocumentationwebsite.
Note:Forthefulllistofsystemrequirements,applications,andapplicationversionlevelsrefertothePrimaveraUnifierTestedConfigurationsinthePrimaveraUnifierDocumentationLibrary.
DownloadingandInstallingAutoVueDownloadandinstallAutovue.
Forsupportedversions,refertothePrimaveraUnifierTestedConfigurationsinthePrimaveraUnifierDocumentationLibrary.
RefertotheOracleAutoVuedocumentationsiteforinstallationinstructions.
Note:Forthefulllistofsystemrequirements,applications,andapplicationversionlevelsrefertothePrimaveraUnifierTestedConfigurationsinthePrimaveraUnifierDocumentationLibrary.
Afterthedownloadiscompleted:1)Extractthezipfileandgotothisdirectoryinwhichyouhaveextractedthezipfile.
2)RuntheAutoVueinstallerexecutable.
3)Gotothedirectoryinwhichyouhaveextractedthezipfile.
4)Locatethejvueserver.
propertiesfileandopen.
5)Addthefollowinglineattheendofthe\bin\jvueserver.
propertiesfile:jvueserver.
authentication.
enable=falseConfiguringAutoVueAfterinstallingAutoVue,configureAutoVuebyenteringinformationinthefollowingtabsoftheUnifierConfigurator:IntheGeneralTab,entertheServerinternalURLfieldtoaccessAutoVue.
IntheMarkupServerTab,completeallfieldsinthistab.
DeployingUnifierGUIAppletstoAutoVueAutoVueprovidestheoptionofcustomizingthird-partygraphicaluserinterface(GUI).
ThefollowingUnifierappletGUIfilesareprovidedtointegratewithAutoVue:InstallingUnifieronLinux51default.
guidefaultcons.
guidefaultNoMarkup.
guidefaultview.
guiTodeploytheUnifierappletGUIfilestoAutoVue:1)DownloadthecurrentversionofthePrimaveraUnifierToolsfilefromtheOracleSoftwareDeliveryCloud(https://edelivery.
oracle.
com/).
2)UnziptheAutoVueMenus.
zipfileintothelocationspecifiedinthejvueserver.
users.
directoryparameterinthe\bin\jvueserver.
propertiesfile.
3)FollowtherecommendationintheOracleAutoVuedocumentationsite.
Note:Forthefulllistofsystemrequirements,applications,andapplicationversionlevelsrefertothePrimaveraUnifierTestedConfigurationsinthePrimaveraUnifierDocumentationLibrary.
ConfiguringWebLogicforUnifieronLinuxThissectiondescribeshowtoconfigureWebLogicforUnifieronaLinux64-bitoperatingsystem.
Itincludes:CreatingaWebLogicDomainforUnifieronLinux(onpage51)StartingtheWebLogicAdminServeronLinux(onpage57)StoppingtheWebLogicAdminServeronLinux(onpage57)ConfiguringWebLogicandOHSasaServiceonLinux(onpage57)CreatingaWebLogicDomainforUnifieronLinuxTocreateaWebLogicdomain:1)RuntheWebLogicConfigurationWizard.
2)IntheWelcomewindow:a.
SelectCreateanewWebLogicdomain.
b.
ClickNext.
3)IntheSelectDomainSourcewindow,clickNexttoacceptthedefaultselections.
4)IntheSpecifyDomainNameandLocation:a.
Enteradomainnameforthenewdomaintobecreated.
b.
Enterthelocationofthenewdomainontheserver.
c.
ClickNext.
5)IntheConfigureAdministratorUserNameandPasswordwindow:a.
EntertheUserNameandPasswordfortheAdministratorthatwillbecreated.
ThisusernamewillbeusedtologintotheWebLogicconsole.
b.
ClickNext.
6)IntheConfigureServerStartModeandJDKwindow:UnifierInstallationGuideforOn-Premises52a.
Intheleftpane,selectProductionMode.
b.
Intherightpane,selecttheJDKyouinstalledearlier.
c.
ClickNext.
7)IntheSelectOptionalConfigurationwindow:a.
SelecttheAdministrationServeroption.
b.
ClickNext.
8)(Optional)IntheConfiguretheAdministrationServerwindow:a.
SelecttheSSLenabledoptionandsettheSSLlistenportifyouareenablingSecureSocketsLayercommunication.
Seehttp://download.
oracle.
com/docs/cd/E12840_01/wls/docs103/secmanage/ssl.
htmlformoredetailsonsettingSSLforWebLogic.
Note:OraclerecommendsyoualwaysuseSSLinaproductionenvironmentforsecurecommunications.
b.
ClickNext.
9)IntheConfigurationSummarywindow,clickCreate.
10)ClickDoneafterthedomainiscreated.
11)Whenprompted,entertheAdministratorUserNameandPasswordthatyouenteredabove.
ConfiguringWebLogicBasicAuthenticationonLinuxAuthorizationThesystemauthenticatesallUnifierusers'requestsbasedontheAuthorizationheader.
Inastand-aloneUnifierenvironment,theusernameandpasswordisdeterminedbasedontheBasicAuthorizationheaderEnsurethatyoudisabletheBasicAuthenticationbyfollowingthesesteps:UnderstandingBASICAuthenticationwithUnsecuredResources(http://docs.
oracle.
com/middleware/1221/wls/SCPRG/thin_client.
htm#SCPRG150)1)Changetotheweblogic_home/user_projects/domains/your_domaindirectory2)Editconfig/config.
xmlbyaddingthefollowingtagwithinthetag:false3)Startorrestartallserversinthedomain.
CreatingaWeblogicDomainforUnifierRESTServicesThissectiondescribesthestepsrequiredtocreateandconfigureaWeblogicdomainforUnifierRESTservices.
PreparingtheDatabaseTopreparethedatabase:InstallingUnifieronLinux531)StartRCUbyenteringthefollowingcommand:C:\Oracle\MiddlewareOWSM\Oracle_Home\oracle_common\bin\rcu.
bat2)OntheWelcomescreen,selectNext.
Note:SelectNextoneachscreentoadvancetothenextstep.
3)OntheCreateRepositoryscreen,selectCreateRepositoryandSystemLoadandProductLoad.
4)OntheDatabaseConnectionDetailsscreen,enterthefollowingdetails:DatabaseType:SelectOracleDatabase.
Note:Forthefulllistofsystemrequirements,applications,andapplicationversionlevelsrefertotheUnifierTestedConfigurationsintheUnifierDocumentationLibrary.
HostName:ThehostnameortheserverIPaddressfortheUnifierdatabase.
Port:AuniqueportnumberfortheUnifierdatabaseschema.
Portnumber1521displaysbydefault.
ServiceName:Theglobaldatabasename.
Forexample,orcl.
us.
oracle.
com.
Username:TheusernamewithDBAorSYSDBAprivilegeswhocaninstallaschema.
Password:Thepasswordforusernameprovidedabove.
Role:RoleoftheuserwhowillbecreatingtheMDSschema.
SelectSYSDBA.
5)OntheCheckingPrerequisitesscreen,selectOKifallcheckspass.
6)OntheSelectComponentsscreen:a.
Createanewprefix.
Makeanoteoftheprefixyouchoose.
b.
ExpandASCommonSchemasandintheComponentssection,selectthefollowing:MetadataServicesAuditServicesAuditServicesAppendAuditServicesViewerOraclePlatformSecurityServicesCommonInfrastructureServices7)OntheCheckingPrerequisitesscreen,selectOKifallcheckspass.
8)OntheSchemaPasswordsscreen,selecttheUsesamepasswordsforallschemas,andenterthepassword.
Makenoteofthepasswordyouuse.
9)OntheMapTablespacesscreen,selectthedefaults.
Makenotesofyourselections.
10)OntheConfirmationscreen,selectOK.
11)OntheCreatingTablespacesscreen,selectOK.
12)OntheSummaryscreen,reviewyourselectedinstallationoptionsandselectCreate.
13)OntheCompletionSummaryscreen,selectClose.
UnifierInstallationGuideforOn-Premises54ConfiguringaWeblogicDomainforRESTServicesRuntheOracleFusionMiddlewareConfigurationWizardtocreateaWebLogicdomainasfollows:Note:SelectNextoneachscreentoadvancetothenextstep.
1)OntheCreateDomainscreen,selectthefollowing:CreateanewdomainDomainLocation:EnterthelocationforinstallingthedomainforRESTservices2)OntheCreateDomainUsingProductTemplatesscreen,selectthefollowingtemplates:OracleEnterpriseManagerOracleWSMPolicyManagerOracleJRFWebLogicCoherenceClusterExtension3)OntheApplicationLocationscreen,selectBrowseandselectthelocationfortheUnifierapplication.
4)OntheAdministrationAccountandtheDomainModeandJDKscreens,selectNexttoacceptthedefaults.
5)OntheDatabaseConfigurationTypescreen,selectthefollowing:SpecifyAutoConfigurationOptionsUsing:selectRCUData.
Vendor:EnterOracleasthedatabasevendor.
Driver:Selectthedriverthatisapplicabletothedatabasefromthedrop-downlist.
DBMS/Service:Entertheserverhostname.
HostName:Enterthehostnameofthedatabaseserver.
Port:Entertheportforthedatabase.
SchemaOwner:Enteranamefortheschemaowner.
SchemaPassword:Enterthecase-sensitivepasswordfortheschemaowner.
ItisthepasswordthatwasenteredwhenexecutingtheRCUutility.
SelecttheGetRCUConfigurationbuttontotesttheconnection.
6)OntheComponentDatasourcesscreen,selectthefollowing:Vendor:EnterOracleasthedatabasevendor.
Driver:Selectthedriverthatisapplicabletothedatabasefromthedrop-downlist.
DBMS/Service:Entertheserverhostname.
HostName:Enterthehostnameofthedatabaseserver.
Port:Entertheportforthedatabase.
SchemaOwner:Enteranamefortheschemaowner.
SchemaPassword:Enterthecase-sensitivepasswordfortheschemaowner.
ItisthepasswordthatwasenteredwhenexecutingtheRCUutility.
Selectallthecomponentschema.
7)OntheJDBCTestscreen,selecttheTestSelectedConnectionsbutton.
8)OntheAdvancedConfigurationscreen,selectAdministrationServer.
InstallingUnifieronLinux559)OntheAdministrationServerscreen,enterthefollowinginformation:ServerName:Enterthenamefortheadministrationserver.
ListenAddress:SelecttheListenaddressfortheadministrationserverfromthedrop-downlist.
ListenPort:Entertheportnumberfortheadministrationserver.
ServerGroups:SelectJRF-MAN-SVR,WSM-CACHE-SVRandWSMPM-MAN-SVRoptions.
10)OntheConfigurationSummaryscreen,clickCreate.
11)OntheConfigurationSuccessscreen,clickFinish.
CreatingRolesTocreateroles:1)EnsurethattheUnifierdomainisrunning.
2)LogintotheWeblogicAdministrationServerConsolefortheUnifierdomain:a.
Openabrowserandenterthefollowinglocation:http://:/consoleUsethehostnameandportoftheUnifierdomain.
b.
EntertheWeblogicadministratorusernameandpassword.
3)IntheChangeCenterpane,selectLockandEditbeforeyoumakeanychangestothedomain.
4)IntheDomainStructurepane,selectSecurityRealms.
5)IntheSummaryofSecurityRealmsscreen,selectmyrealm.
6)OntheSettingsformyrealmscreen,selecttheRolesandPoliciestab.
a.
IntheRolestable,expandGlobalRolesandthenexpandRoles.
b.
SelectNew.
c.
Entertherole:UnifierWSAdmin.
d.
SelectAddConditions.
e.
FromthePredicateList,selectGroup.
f.
SelectNext.
g.
FortheGroupArgumentName,enterUnifierWSAdminandselectAdd.
Groupnamesmustbeidenticaltothecreatedrole.
h.
SelectFinish,thenSave.
CreatingGroupsTocreategroups:1)IntheDomainStructurepane,selectSecurityRealms.
2)IntheSummaryofSecurityRealmsscreen,selectmyrealm.
3)IntheSettingsformyrealmscreen,selecttheUsersandGroupstab.
4)SelecttheGroupstab.
UnifierInstallationGuideforOn-Premises565)SelectNew.
FortheNamefield,enterthenameofthegroup.
Forexample,UnifierWSAdmin.
FortheDescriptionfield,enterthepurposeofthegroup.
FortheProviderfield,usethedefault(DefaultAuthenticator)value.
6)SelectOk.
CreatingUsersTocreateusers:1)IntheDomainStructurepane,selectSecurityRealms.
2)IntheSummaryofSecurityRealmsscreen,selectmyrealm.
3)IntheSettingsformyrealmscreen,selecttheUsersandGroupstab.
4)SelecttheUserstab.
5)SelectNew.
a.
Enteranameanddescriptionfortheuser.
b.
Enterapasswordfortheuserandconfirmit.
c.
SelectOK.
d.
Selectthecheckboxadjacenttotheusername,andselecttheuser.
e.
IntheSettingsforpane,selecttheGroupstab.
f.
DependingontherolethatyouwouldliketoassigntotheuserinUnifier.
SelectoneormoreparentgroupsfromtheAvailableboxtotheChosenbox.
6)SelectSave.
7)SelectActivateChanges.
8)SelectReleaseConfiguration.
SettingupOWSMAuthenticationTocreatetheWSMPolicy:1)LogintoOracleEnterpriseManagerfortheUnifierapplication:http://:/em2)ExpandtheWeblogicDomainnodeandselecttheUnifierdomainnode.
3)SelectWebServices,andthenselectWSMPolicySets.
4)OntheWSMPolicySetSummaryscreen,selectCreate.
5)CreatepolicysetsforUnifier_REST_API_servicesasfollows.
Name:EnteradescriptivenamefortheWSMpolicyset,forexample:Unifier_REST_API_Service.
Enabled:Ensurethisoptionisselected.
TypeofResources:SelectRESTfulResource.
Description:EnterDefaultpolicyforUnifierRESTAPIservice.
InstallingUnifieronLinux57Note:SelectNextoneachscreentoadvancetothenextstep.
6)IntheRESTfulApplication,Service,orWebServiceEndpointNamefield,enterUnifierRestService.
7)OntheEnterConstraintspage,selectNext.
8)Attachthebasicauthenticationpolicyasfollows:a.
Selectoracle/wss_http_token_service_policyfromthebottomgrid.
b.
SelectAttach.
9)OntheSummaryscreen,selectSave.
ThiscompletessettingupOWSMforusingexternalwebservicesofPrimaveraUnifier.
StartingtheWebLogicAdminServeronLinuxTodeployUnifierinWebLogic,starttheAdminserverasfollows:1)Changetotheweblogic_home/user_projects/domains/your_domaindirectory.
2)RunthestartWebLogic.
shscript.
3)IfpromptedforausernameandpasswordintheWebLogicconsolewindow,typeintheadministrativeusernameandpasswordyouspecifiedwhencreatingthedomain.
Note:IfyouturnedontheWebLogicprecompileoption,theWebLogicconsoledisplays"ServerstartedinRUNNINGmode"whenprecompilingfinishes.
Fordetailedinformationaboutturningonprecompilation,seeyourWebLogicServerdocumentation.
StoppingtheWebLogicAdminServeronLinuxWhenyouarefinishedworkingintheWebLogicAdministrationConsole,stoptheWebLogicadminserverasfollows:1)Changetotheweblogic_home/user_projects/domains/domain_home/bindirectory.
2)RunthestopWebLogic.
shscript.
3)IfpromptedforausernameandpasswordintheWebLogicconsolewindow,entertheadministrativeusernameandpasswordthatwasspecifiedwhencreatingthedomain.
Note:TheWebLogicconsolewindowwillcloseautomaticallyatshutdown.
ConfiguringWebLogicandOHSasaServiceonLinuxCompletethefollowingstepstoinstallWebLogicandOracleHTTPSServer(OHS)asaserviceonaLinux64-bitoperatingsystem.
UnifierInstallationGuideforOn-Premises581)SetWL_HOMEassystemenvironmentvariableormodifyitin/weblogic/setenv.
sh.
WL_HOMEistherootdirectoryoftheWebLogicinstallation.
Fordetailedinstructions,refertothetopic,CreatingaWebLogicDomainforUnifieronWindows(onpage17)tocreatetheDomainHomeforweblogic.
Forexample:C:\Oracle\Middleware\wlserver_11\server2)SettheenvironmentvariablesforUnifier.
Fordetailedinstructions,refertoChangingUnifierConfiguratorSettingsonWindows(onpage25).
3)ForWebLogicinstalledinproductionmode,createboot.
propertiesat$DOMAIN_HOME/servers//security.
4)EnsureallvariablesaresetforaROOT_USER.
5)LogintoLinuxasaROOT_USER.
6)Inthe/weblogic/unifier,modifyvaluesforthefollowingparameters:OHS_INSTANCE_HOME:ThehomedirectoryofOHS.
UNIFIER_HOME:ThehomedirectoryofPrimaveraUnifier.
OHS_USER:UserwhocanstartOHS.
Alternatively,locatetheuserinthehttpd.
conffile.
WL_USER:UserwhocanstartWebLogic.
Note:Changethecommandtostartweblogicinaccordancetotheuserprivilegeonthesystem.
7)EnsurethatwhentheserverisrestartedtheXvfbprocessisalsostartedwiththesameDISPLAYvalueasfollowsfortheROOT_USER:a.
InstallXvfbyuminstallXvfbb.
startXvfblocateXvfb(whereXvfbisinstalled)/usr/bin/Xvfb:99-screen01x1x8&c.
Edittheunifierfiletoadd:exportDISPLAY=:998)Copytheunifierscriptintothe/etc/rc.
d/init.
dfolder9)Tomakethefileexecutable,runthecommand:chmod755unifier10)Toaddtheserviceatsystemreboot,runthecommand:chkconfig--addunifier11)Tostarttheunifierservicefromtheconsole,runthecommand:serviceunifierstartStoppingtheServiceTostoptheunifierservicefromtheconsole,runthecommand:serviceunifierstopUninstallingtheServiceToremovetheservice,runthecommand:chkconfig--delunifierInstallingandConfiguringtheReportsServer(Optional)ConsultyourOracledocumentationforinstructionsoninstallingOracleBusinessIntelligencePublisher.
InstallingUnifieronLinux59Note:Forthefulllistofsystemrequirements,applications,andapplicationversionlevelsrefertothePrimaveraUnifierTestedConfigurationsinthePrimaveraUnifierDocumentationLibrary.
ForconfigurationinformationforintegratingUnifierandBIPublisher,refertotheUnifierBIPublisherConfigurationGuide.
InstallingOracleWebCenterContent(Optional)ConsultOracledocumentationforinstructionsoninstallingtheOracleWebCenter.
ForconfigurationinformationforintegratingUnifierandWebCentercontent,refertoUnifierContentRepositoryConfigurationGuide.
ConfiguringUnifierUsingtheConfiguratorThissectiondescribeshowtousetheUnifierConfiguratortoconfigureUnifier.
EditingtheSetEnv.
shFileonLinuxEnsurethatthefollowingvariablesaresavedinthesetenv.
shfile:Setthedomain_homevariabletospecifythepathofthedomainhomefolderthatwillbeusedbyUnifier.
SettheadminurlvariabletospecifyhostnameandportnumberusedbytheUnifierdomain.
Setthejava_homevariabletotheJDKinstalleddirectory.
SettheUSER_MEM_ARGSvariablespecifytheJVMmaximummemorysetting.
ChangingUnifierConfiguratorSettingsonLinuxTheUnifierenvironmentisconfiguredthroughtheUnifierConfiguratorwindow.
TochangesettingsinUnifierConfigurator:1)OpentheWebLogicdirectoryintheUnifierHomefolder.
2)Runconfigure.
sh.
3)Configurethesettingsforeachtab.
4)ClickSaveoneachtab.
5)RestartUnifierforthechangestobeoperative.
GeneralTabServerType:ThesettingthatdefinesthemodeUnifierserverisrunning.
UnifierInstallationGuideforOn-Premises60SetServerTypetoProductionifthisUnifierinstallationisactingastheUnifierproductionenvironment.
Inthisenvironment,youcannotpublishconfigurationpackages.
SetServerTypetoDevelopmentifthisUnifierinstallationisactingasthedevelopmentserverfortestingofbusinessprocessesandotherUnifierdesignsandconfigurations.
YoucannotconvertaDevelopmentenvironmenttoaProductionenvironmentbecauseallthedesigns,inuDesigner,mustbepublishedintheProductionenvironment.
IfyoudonotselectDevelopment,youwillnotbeabletoedituDesignerdesignssincedesignsareavailableasread-onlyintheTest,orProduction.
SetServerTypetoTestifthisUnifierinstallationisactingasthetestserverfortestingofbusinessprocessesandotherUnifierdesignsandconfigurations.
Inthisenvironment,youcannotpublishconfigurationpackagesandmodifyBPdesigns.
Youcanmodifyothersetups,configurationsandimportunpublishedconfigurationpackage.
Note:YoumustsettheServerTypetoDevelopmentifyouwanttomodifyuDesignerdesigns.
TemporaryDirectory:EnterthetemporarydirectoryforUnifierserveroperations.
TheTemporaryDirectorymustbelocaltotheserver.
IfyoudonotwanttoplacetheTemporaryDirectoryonalocalserver,thenyoumustselectadifferentvalueforthesharedlocation.
BackgroundJobDisabled:Selecttodisablebackgroundjobs.
EnableRESTServices:Selecttoenablecompany-levelRESTservices.
Inaddition,youmustensurethatOWSMissetupinUnifierservertohandleauthentication.
ServerInternalURL:EntertheWebLogicServerURLrunningtheUnifier(Forexample:http://host1.
example.
com:7001)Note:BIPublisherandMarkupserversusethisURLtocommunicatewithUnifier.
LoginSessionTimeout:LoginSessionTimeoutisusedtocontroltheamountoftimeausercanbeidlebeforehavingtologbackintoUnifier.
Theunitisseconds.
Forsecurityreasons,therecommendedtimeoutsettingisbetween30minutesand4hours.
LateNoticeInterval:Interval,inminutes,usedbytheinternaljobserverfornotificationtasks.
Thesuggestedintervalis15minutes.
Averysmallintervalmaydegradeperformance.
Max.
Concurrence:Themaximumnumberofconcurrence.
ServerLabel:ThisfielddisplaysonlyforTestservers.
EnteracustomnamefortheTestserver.
Thenamecannotexceed30charactersandcannotbelabeledDevelopmentorProduction.
Itcanincludeallspecialcharactersexcept-(dash/hyphen)and_(underscore).
UPKHelpURL:EntertheURLwheretheUserProductivityKit(UPK)helpcontentistobehosted(asagenericexample,http://servername/contextroot,orasaspecificexampleishttp://localhost/unifierupk).
UnifierHelpURL:TodeployalocalversionoftheUnifieronlinehelp,entertheURLwherethehelpfileistobehosted.
Bydefault,theonlinehelpisdeployedfromthesitehostedbyOracle.
InstallingUnifieronLinux61RepositoryTab(CMIS)ThefollowingfieldsdisplaywhenyouselectCMISintheFileRepositoryfield.
CMISLoginName:Entertheusernameforyourcontentrepository.
CMISPassword:PasswordfortheCMISloginname.
CMISRepositoryName:Thecontentrepositoryname.
CMISDocumentationHome:Thedocumentationhome.
CMISWebServiceURL:TheURLforyourwebserviceshome.
Notes:ItisimportanttoplanwherethesedirectoriesarelocatedbecausetheyarewhereUnifierdataisstored.
AnysubsequentupgradeinstallationsneedtopointtothesesamelocationinorderforUnifierto'see'datapreviouslyentered.
Theserepositories,inadditiontoyourdatabase,shouldbebackedupregularly.
Whennamingthefolders,besuretherearenospacesinthefoldernames.
Thesefilesmustbeonashareddrivethatisaccessiblebyotherservermachinesthatareoperatinginaclusteringenvironment.
IndexDirectory:ThisfolderisforindexfilesusedinDocumentManagersearchfunction.
ThisfieldisnotvisiblewhenrepositoryissettoCMIS.
LogFileDirectory:Thefolderwherethelogfilesarestored.
WhenUnifierisinstalledonamultibyteserverandconnectingtoSharePointorCMIS:Add"-Djavax.
xml.
parsers.
DocumentBuilderFactory=com.
sun.
org.
apache.
xerces.
internal.
jaxp.
DocumentBuilderFactoryImpl"Javaoptiontosetenv.
sh/setenv.
batfile.
RestartUnifier.
TheabovesettingsenableyoutoviewdocumentsinCMIS.
ExamplesSettinginsetenv.
batfile:SETJAVA_OPTIONS=%JAVA_OPTIONS%-Djavax.
xml.
parsers.
DocumentBuilderFactory=com.
sun.
org.
apache.
xerces.
internal.
jaxp.
DocumentBuilderFactoryImplSettinginsetenv.
shfile:exportJAVA_OPTIONS="$JAVA_OPTIONS-Djavax.
xml.
parsers.
DocumentBuilderFactory=com.
sun.
org.
apache.
xerces.
internal.
jaxp.
DocumentBuilderFactoryImpl"RepositoryTab(Database)ThefollowingfieldsdisplaywhenyouselectDatabaseintheFileRepositoryfield.
UnifierInstallationGuideforOn-Premises62HostName:Enterthehostnameofthecomputerwhereyouinstalledthedatabase.
InstanceID:TheInstanceIDfieldintheConfiguratorcanacceptthefollowingvalues:AnOracleSIDAnOracleservicename(OracleDatabase)Note:Forthefulllistofsystemrequirements,applications,andapplicationversionlevelsrefertotheUnifierTestedConfigurationsintheUnifierDocumentationLibrary.
WhenyouenteraservicenameforanOracleservicename(OracleDatabase),youmustprefacethenamewithaforwardslash(/),forexample,/servicename.
Ifyoudonotprefacethenamewithaforwardslash(/),thesystempresumesthatyouhave:EnteredanOracleSID,ifyouhadselectedOraclefromthedrop-downlist.
Port:EnterthePortnumbertobeusedbyUnifiertocommunicatewiththedatabase(Forexample:1521).
UserName:Enterthedatabaseloginuseraccountname(createdinOracle)tobeusedbyUnifier.
ThedatabaseloginuseraccountneedstohavesufficientpermissionstocreatetablesinorderforUnifiertoworkcorrectly.
UserPassword:EnterthedatabaseloginuseraccountpasswordtobeusedbyUnifier.
Theuserhastohavethefollowingpermissions:ConnectResourcectxappCreatejobexecuteonctxsys.
ctx_ddlexecuteondbms_schedulerLogFileDirectory:Thefolderwherethelogfilesarestored.
RepositoryTab(NetworkFileSystem)ThistopicapplieswhenyouselectNetworkFileSystemfortheFileRepositoryfield.
Therearetwodatarepositories(foldersinwhichUnifierdataisstored),whichUnifierrequiresyoutoconfigure.
Thereareadditionalrepositories,suchasthearchivedirectoryforprojectarchiving,thatareusedwithspecificfeatures,asdescribedbelow.
Thesecanbelocatedonalocalbutseparateharddrive,oronamappeddriveonyournetwork.
FileRepository:Inthisfield,selectNetworkFileSystemfromthedrop-downlist.
InstallingUnifieronLinux63Notes:ItisimportanttoplanwherethesedirectoriesarelocatedbecausetheyarewhereUnifierdataisstored.
AnysubsequentupgradeinstallationsneedtopointtothesesametwodirectoriesinorderforUnifierto'see'datapreviouslyentered.
Theserepositories,inadditiontoyourdatabase,shouldbebackedupregularly.
Whennamingthefolders,besuretherearenospacesinthefoldernames.
FileDirectory:Enter(orBrowseto)thepathwhereuploadedorattachedfilesarestored.
ThisrepositoryisforstoringdocumentswithintheDocumentManager,suchasdrawings,plans,Worddocuments,etc.
ThesefileswillbeavailableforviewingorattachingtobusinessprocessformswithinUnifier.
Italsostoresimportedschedulefiles.
Notes:Thesefilesmustbeonashareddrivethatisaccessiblebyotherservermachinesthatareoperatinginaclusteringenvironment.
EnsurethattheuserwhohasstartedtheUnifierapplicationisanetworkuserandhasaccesstonetworkfilesystem.
EnsurethattheFiledirectoryvalueissameinallthemachinesinthecluster.
UsetherepositorymachinenameorIPaddresstospecifytheshareddrivelocation.
Ensurethatenoughdiskspaceisavailableonthenetworkfilesystem.
IndexDirectory:ThisisthepathnametothelocationwheretheSearchIndexfilesarestored.
LogFileDirectory:Thefolderwherethelogfilesarestored.
RepositoryTab(WebCenterContent)ThistopicapplieswhenyouselectWebCenterContentfortheFileRepositoryfield.
FileRepository:SelectWebCenterContent.
WebCenterContentServerHost:ThisistheIPaddressoftheWebCenterContentserver.
WebCenterContentServerPort:ThisistheportoftheWebCenterContentserver.
WebCenterContentUser:ThisistheuserwhowilladddocumentsthroughtheAPI.
TheusershouldexistintheWebCenterContentserver.
WebCenterContentRootFolder:TherootfolderinWebCenterContentunderwhichallUnifierfolderswillbecreated.
Notes:ItisimportanttoplanwherethesedirectoriesarelocatedbecausetheyarewhereUnifierdataisstored.
AnysubsequentupgradeUnifierInstallationGuideforOn-Premises64installationsneedtopointtothesesamelocationinorderforUnifierto'see'datapreviouslyentered.
Theserepositories,inadditiontoyourdatabase,shouldbebackedupregularly.
Whennamingthefolders,besuretherearenospacesinthefoldernames.
Thesefilesmustbeonashareddrivethatisaccessiblebyotherservermachinesthatareoperatinginaclusteringenvironment.
LogFileDirectory:Thefolderwherethelogfilesarestored.
TestWebCenter:Enablesyoutovalidatetheconfigurationsettingsthatyouhaveentered.
DatabaseTab(Oracle)Theinformationenteredinthistabisbasedonyourearlierdatabaseanduseraccountcreation.
DatabaseType:SelectOracle.
HostName:Enterthehostnameofthecomputerwhereyouinstalledthedatabase.
InstanceID:TheInstanceIDfieldintheConfiguratorcanacceptthefollowingvalues:AnOracleSIDAnOracleservicename(OracleDatabase)Note:Forthefulllistofsystemrequirements,applications,andapplicationversionlevelsrefertotheUnifierTestedConfigurationsintheUnifierDocumentationLibrary.
WhenyouenteraservicenameforanOracleservicename(OracleDatabase),youmustprefacethenamewithaforwardslash(/),forexample,/servicename.
Ifyoudonotprefacethenamewithaforwardslash(/),thesystempresumesthatyouhaveenteredanOracleSID.
Port:EnterthePortnumbertobeusedbyUnifiertocommunicatewiththedatabase(Forexample:1521).
UserName:Enterthedatabaseloginuseraccountname(createdinOracle)tobeusedbyUnifier.
ThedatabaseloginuseraccountneedstohavesufficientpermissionstocreatetablesinorderforUnifiertoworkcorrectly.
UserPassword:EnterthedatabaseloginuseraccountpasswordtobeusedbyUnifier.
Max.
Connections:Thesettingthatdefinesthemaximumconnectionstothedatabase.
Themaximumis400;therecommendedmaximumis80to100.
Min.
Connections:Thesettingthatdefinestheminimumconnectionsthatmustbeconnectedtothedatabase.
TestConnection:ClickTestConnectiontoverifythattheApplicationserverandthedatabaseareconnectedandcommunicating.
ATestissuccessfulmessagewillappeariftestissuccessful.
Twoconditionsaretested:InstallingUnifieronLinux65AbilityofUnifiertoconnecttothedatabaseLevelofpermissionsgrantedtothedatabaseloginuseraccountEmailTabOutbound(SMTP)E-mailServer:(Required)EntertheIPaddressortheURL/machinename.
E-mailSenderPrefix:EntertheemailprefixthatwillbeusedintheSender'snamewheneveranemailisgeneratedfromauserfromwithinUnifier,forexample,Unifier.
LateemailnotificationsshowtheE-mailSenderPrefix,only.
SupportContactInformation:Thisfieldcontainsthemessagetextthatisincludedinallsupport-relatedemailnotifications.
Toenableanemailaddressasahyperlink,usethefollowingformat:name@example.
comOutbound(SMTP)AuthenticationRequired:SelectifauthenticationisrequiredbytheoutboundSMTPemailserver.
ProxyServerURLforAPNsServerURLoftheproxyserverusedtoconnecttoApplePushNotificationService.
ProxyServerPortforAPNsServerPortoftheproxyserverusedtoconnecttoApplePushNotificationService.
Outbound(SMTP)EmailAccount:EntertheoutboundEmailaccount.
Outbound(SMTP)EmailPassword:EnterthepasswordthatcorrespondstotheoutboundEmailaccount.
Note:UnifiersupportsoutboundemailwithoutauthenticationorwithauthenticationusingSSL.
SystemNotificationE-mailAddress:ThisfieldcontainstheemailIDthatthesystemdisplaysasthe"Sender's"emailaddressforallemailsgeneratedbytheUnifiersystem,forexample,admin@example.
com.
ProjectEmailPatter:Thisfieldhasthefollowingvalues:SuffixandPrefixanddeterminestheprojectemailIDsupported(-@oracle.
comor+@oracleindustry.
com).
SystemErrorNotificationE-mailAddress:ThisfieldcontainstheemailaddresswhereUnifiersendsanotificationifUnifierlosesconnectiontothedatabasewhilethesystemisrunning.
Theemailaddressescanbeseparatedbysemicolon.
LicenseNotificationE-mailAddress:ThisfieldcontainstheemailaddresswhereUnifiersendslicensingnotifications,forexample,ifthenumberofusersexceedsthenumberofavailablelicenses.
Ifthenumberofusersexceedsthenumberofavailablelicenses,thenthesystemsendsnotificationstothefollowing:Usersspecifiedintheconfigurator(UnifierConfiguratorWebLogic).
UserswhohaveNotifypermissionintheLicenseManager,whichwassetinAccessControl.
UnifierInstallationGuideforOn-Premises66InboundE-mailprotocol:Selecttheprotocolusedbytheinboundemailserverthatcanreceiveemail.
ThesupportedprotocolsarePOP3,IMAP,POP3S,andIMAPS.
EachUnifierenvironment(Development,Test,andProduction)mustbeconfiguredwithitsowninboundemailaccount.
Topreventundesiredresults,donotusethesameinboundemailforalltheenvironments.
InboundE-mailServer:Entertheserverthatcanreceiveemail,forexample,ifausertakesactionviaemailonabusinessprocess.
ThiscanbetheservernameorIPaddress.
(Optional)YoucanspecifytheportnumberaftertheservernameofIPaddress,forexample,example.
com:1521.
InboundE-mailAccount:Entertheemailaccounttoreceiveresponseemailfromtheuser.
TousetheprojectorshellMailbox,whichallowsexternalemailmessagestobesenttoandstoredwithinacentralprojectorshellmailbox,usethefollowingformatfortheinboundemailaccount.
Thisallowsacceptanceofinboundemailssenttothesystem-generatedproject/shellemailaddresses:*-inboundemailname@example.
com.
Thisconfigurationisneededontheemailserver,notwithintheUnifierConfigurator.
InboundE-mailPassword:Thisfieldcontainsthepasswordthatcorrespondstotheinboundemailaccount.
Thispasswordisusedwhenemailisretrieved.
TestInboundConnection:EnablesyoutotesttheInboundE-mailServer,InboundE-mailAccount,andInboundE-mailPassword.
TestOutboundConnection:EnablesyoutotesttheoutboundE-mailServer,outboundE-mailAccount,andoutboundE-mailPassword.
AboutInboundE-mailIfyouareusingaopen-sourcehMailServertoconfigureUnifierforinboundemails,ensurethatyouturnoffthe"autoban"feature.
Ifyoudonotturnoffthe"autoban"feature,thenyouwillnotbeabletouseUnifierfunctionalitiessuchasProjectMailboxandWorkflowactionviewE-mail.
TheProjectMailboxfunctionalityrelyonemailaddressusedforBPActionviaEmail.
IftheInboundemailaddressisunifier_oracle@unifiermail.
com,thentheemailaddressofaProject/Shellcouldbeoneofthefollowing,dependingonthepropertyvalueintheskire.
project.
email.
patterninskire.
propertiesfile.
Thispropertycanhavetwovalues:"prefix"orblankand"suffix.
"Thispropertycanbeseteithermanually(intheskire.
propertiesfile)orbyselectingtheappropriatevaluefromUnifierConfigurator-EmailTabandsavingthechanges.
Incasethepropertyvalueis"prefix"orblankTheemailaddressofanyUnifierProject/Shellwillfollowthepattern-unifier_oracle@unifiermail.
comusedforProjectMailboxfunctionality.
Forexample,iftheprojectidis1001,thenemailaddressforthisparticularProject/Shellwillbe1001-unifier_oracle@unifiermail.
com.
Forthistofunction,youhavetosetupanemailforwardingruleonyourmailserversuchthatanyemailssentto.
*-unifier_oracle@unifiermail.
comwillbeautomaticallyforwardedtounifier_oracle@unifiermail.
comInbox.
InstallingUnifieronLinux67Incasethepropertyvalueis"suffix"TheemailaddressofanyUnifierProject/Shellwillfollowthepatternunifier_oracle+@unifiermail.
comusedforProjectMailboxfunctionality.
Forexample,iftheprojectidis1001,thenemailaddressforthisparticularProject/Shellwillbeunifier_oracle+1001@unifiermail.
com.
Forthistofunction,youhavetosetupanemailforwardingruleonyourmailserversuchthatanyemailssenttounifier_oracle+.
*@unifiermail.
comwillbeautomaticallyforwardedtounifier_oracle@unifiermail.
comInbox.
Ifyouareusinganemailaddressonoracleindustry.
comdomain,youmustusethe"suffix"pattern,andyoumust,explicitly,setskire.
project.
email.
pattern=suffixbecausethispropertyisnotexposedincurrentUnifierconfigurator.
Theemailforwardingrule(forsuffixpattern)isenabledonthisdomainbydefault.
OnUnifierconfigurator,ensurethatyouincludetheportnumberforthecurrentprotocolinInboundE-mailServerfield,forexample,unifiermail.
com:110ororacleindustry.
com:993.
Theprotocolandportmappingareasfollows:POP3-port110IMAP-port143IMAPS-port993POP3S-port995TopreventthespamemailstogointheProjectMailbox,thesystemacceptsemailsfromemailaddressesassociatedwithUnifieruseraccountortheemailaddresseslistedinApprovedEmailListbyCompanyAdmin,only.
MarkupServerTabUseServerInternalURL:(Optional)SelectthisoptiononlyifserverinternalURLaddressmustbeusedbymarkupservertocommunicatewithUnifier.
Ifnotselected(default),Theuser'sloginbaseURLaddressisusedbymarkupservertocommunicatewithUnifier.
MarkupServerHostName:Enterthehostnameofthemarkupserver.
MarkupServerPort:Entertheportnumberofthemarkupserver.
ThedefaultportnumberforAutoVueis5099.
ImportantinformationaboutAutoVueWhenUnifierisinstalledonamultibyteserverandconnectingtoAutoVue,orwhenyouarehavingissueswithviewingdocumentsinAutoVuefromUnifier:1)Add"-Djavax.
xml.
parsers.
DocumentBuilderFactory=oracle.
xml.
jaxp.
JXDocumentBuilderFactory"Javaoptiontosetenv.
batfile.
2)RestartUnifier.
TheabovesettingsenableyoutoviewdocumentsinAutoVue.
ExampleUnifierInstallationGuideforOn-Premises68Settinginsetenv.
batfile:SETJAVA_OPTIONS=%JAVA_OPTIONS%-Djavax.
xml.
parsers.
DocumentBuilderFactory=oracle.
xml.
jaxp.
JXDocumentBuilderFactorySettinginsetenv.
shfile:exportJAVA_OPTIONS="$JAVA_OPTIONS-Djavax.
xml.
parsers.
DocumentBuilderFactory=oracle.
xml.
jaxp.
JXDocumentBuilderFactory"ReportTabBIPEndpointURL:EntertheBIPWebServicesendpointURL.
Forexample:http://host1.
example.
com:9502BIPUserName:EntertheusernamecreatedfortheBIPublisherserver.
BIPPassword:EnterthepasswordfortheBIPublisheruser.
BIPDataSource:EntertheJDBCdatasourcenamethatwasenteredwhentheJDBCDataSourceBIPublisherBIPReportFolder:ThefolderunderthedefaultlocationintheBIPublishercatalog.
Reportsresideinthisfolderbasedoncompanyregistry.
BIPExternalReportFolder:ThefolderunderthedefaultlocationintheBIPublishercatalog.
ExternalReports,synchronizedinUnifier,resideinthisfolder.
Note:ThevaluesusedintheBIPUserName,BIPPassword,BIPDataSource,andBIPReportfolderfieldsarethesameasthosecreatedwhenusingtheUnifierBIPublisherConfigurationGuide.
OBIEEAnalyticsURL:TheURLtoOBIEEAnalyticsservice.
ThisURLshouldbeaccessibleviainternet.
TestReportConnection:Enablesyoutovalidatetheconfigurationsettingsthatyouhaveentered.
GeoMapTabMapServerUrl:Enterhttps://elocation.
oracle.
com.
ThisistheOracleMapserverbaseURLwheretheOracleMapVeiwerapplicationisdeployedwiththecontext"mapviewer".
Thisiswheretheserverobtainsthemapimage.
MapTile:Enterelocation.
world_map.
Thisisthenameofthemaptilelayer(thebasemapusedformaprendering)thatwaspre-definedontheOracleMapserver.
Thisisthemapdatasource.
MapGeocoderUrl:Enterhttps://elocation.
oracle.
com.
ThisistheserverURLwheretheOracleGeocoderapplicationisdeployedwiththecontext"geocoder.
"Thisisthelocationservice.
AuthenticationTab(Native)AuthenticationType:NativeInstallingUnifieronLinux69TheUnifierdefaultauthenticationmechanismisused.
LoginURL:EntertheURLtologintoUnifier.
AuthenticationTab(OIM/OAM)AuthenticationType:OIM/OAMThesystemdetermineswhetherintegrationofPrimaveraUnifierwithOracleIdentityManager(OIM)andOracleAccessManager(OAM)isenabled.
SSOLogout:ThelogoutURLforOracleAccessManager(OAM)oranythird-partySingleSignOn(SSO)configuration.
Formoredetails,refertoOracleAccessManagerdocumentation.
LoginURL:EntertheURLtologintoUnifier.
AuthenticationTab(WebLogic)AuthenticationType:WeblogicForm-basedauthenticationisusedtointegratewithWebLogicauthenticationmethods.
AfterWebLogicauthenticatestheuser,UnifierdeterminesiftheuserisavalidUnifieruserbeforegrantingaccesstotheapplication.
Realm:Weblogicrealmthatisusedforauthentication.
Group(s)(commaseparated):Weblogicgroupname,acommaseparatedlist,usedformappingWeblogicgroupsto"unifieruser"role.
LoginURL:EntertheURLtologintoUnifier.
AuthenticationTab(LDAPSimpleBind)TheLightweightDirectoryAccessProtocol(LDAP)isaprotocolforquerying,andmodifying,directoryservices.
TheAdministratorcanconfiguretheservertouseeithersimple-bindordouble-bindauthentication.
AuthenticationType:LDAPSimpleBindLoginURL:EntertheURLtologintoUnifier.
Provider:ToconnecttheLDAPserver(URL),forexample,ldap://ldap.
zyz.
com:636SSL:ToconnecttotheSecureSocketsLayer(SSL)enabledportoftheLDAPserver.
Note:OraclerecommendsyoualwaysuseSSLinaproductionenvironmentforsecurecommunications.
WhenUnifierisconfiguredwithJDK8andintegratedwithLDAPSSL:Add"-Djdk.
tls.
client.
protocols=TLSv1"Javaoptiontosetenv.
shfile.
RestartUnifier.
TheabovesettingsenableyoutologinusingLDAPSSL.
UnifierInstallationGuideforOn-Premises70ExampleSettinginsetenv.
shfile:exportJAVA_OPTIONS="$JAVA_OPTIONS-Djdk.
tls.
clent.
protocols=TLSv1"SecurityPrincipalTemplate:Toauthenticatedirectly,basedontheusernameandpassword(SimpleBind).
Thetemplateisusedtoconstructtheuser'sDistinguishedName(DN),forexample,cn={0},l=amer,dc=oracle,dc=comAdminUserBypass:ToallowadministratorstobypassLDAPlogin.
AuthenticationTab(LDAPDoubleBind)TheLightweightDirectoryAccessProtocol(LDAP)isaprotocolforquerying,andmodifying,directoryservices.
TheAdministratorcanconfiguretheservertouseeithersimple-bindordouble-bindauthentication.
AuthenticationType:LDAPDoubleBindLoginURL:EntertheURLtologintoUnifier.
Provider:ToconnecttheLDAPserver(URL),forexample,ldap://ldap.
zyz.
com:636SSL:ToconnecttotheSecureSocketsLayer(SSL)enabledportoftheLDAPserver.
WhenUnifierisconfiguredwithJDK8andintegratedwithLDAPSSL:Add"-Djdk.
tls.
client.
protocols=TLSv1"Javaoptiontosetenv.
shfile.
RestartUnifier.
TheabovesettingsenableyoutologinusingLDAPSSL.
ExampleSettinginsetenv.
shfile:exportJAVA_OPTIONS="$JAVA_OPTIONS-Djdk.
tls.
clent.
protocols=TLSv1"ProviderBase:(Optional)WhenyouselecttheDoubleBindmethodofauthentication,youneedtofindtheuser'sDNandthenauthenticatethem.
Findingtheuser'sDNisusedasthebaseforsearchingtheLDAPtree.
IftheProvidedBaseisnotset,therootisassumedbythesystem:ldap.
provider.
baseAuthorizedUser:WhenusingtheDoubleBindmethodofauthentication,findtheuser'sDistinguishedName(DN)andthenauthenticate.
Thisisusedasthe"trusted"or"search"loginuser'sDN(firstbind).
AuthorizedUserPassword:WhenusingtheDoubleBindmethodofauthentication,thisistheauthorizeduser'sloginpassword.
SearchField:Thedefaultvalueis"cn.
"Youneedtoenterthenodefieldthatyouwanttosearch.
AdminUserBypass:ToallowtheadministratorbypasstheLDAPlogin.
TestUserName(notSaved):EntertheLDAPusernametotesttheLDAPserver.
TestUserPassword(notSaved):EntertheLDAPpasswordtotesttheLDAPserver.
InstallingUnifieronLinux71AuthenticationTab(GenericSSO)UserAuthenticationType:GenericSSOLoginURL:EntertheURLtologintoUnifier.
SSOHeader:HeadervalueusedwhileconfiguringSSO.
Note:ForOAMSSO,thevalueisOAM_REMOTE_USERandforShibboleth,thevalueisREMOTE_USER.
SSOLogout:ThelogoutURLforOracleAccessManager(OAM)oranythird-partySingleSignOn(SSO)configuration.
Formoredetails,refertoOracleAccessManagerdocumentation.
Note:IfUnifierisconfiguredwithShibbolethasSPandIDP,addthefollowingoptionProxyPreserveHostOninthehttpd-ssl.
conffileintheShibbolethSP.
AdvancedTabEnablePasswordEncryptionWhenthepasswordencryptionisenabled,thesystemsavesthesignatureinbluedoorpropertiesfile,orasecurelocation.
SecureKeyLocationThedirectorypathwherethefilecontainingfile"unifier.
properties"willbestored.
The"unifier.
properties"filewillcontainthe"unifier.
secure.
seed"property.
Thissettingisoptional.
Ifnotset,thesecurekey(arandomstring)willbegeneratedbytheConfiguratorandstoredinthe"skire.
properties"file.
Ifafolderlocationisgivenasasecurekeylocation,thenthekeywillbestoredinanadditionalpropertyfileinthegivenfolderforextrasecurity(assumingthatthesecurekeyfolderisafolderwithveryselectiveaccessthatisnotreadablebymostITpersonnel).
ThislocationmustbeaccessiblefromUnifierserver.
PartnerLoginURLTheJVMdefaulttimezone.
Thistimezonemustmatchthejavastartupparameters.
Forexample:Duser.
timezone=America/Chicago.
Ifset,Unifiergeneratedemailsenttopartneruser(usersthatdonotbelongtotheownercompany)containingthegivenloginURL.
AlluseremailswillhavethesameloginURLdefinedintheemailtab,normally.
ThisloginURLisusedinCloudenvironmentwheretheownerandpartnerusedifferentSSOsolution.
ServerTimeZoneTheservertimezone.
BackgroundJobThreadsUnifierInstallationGuideforOn-Premises72Thenumberofthreadsforbackgroundjobs.
HighPriorityJobThreadsThenumberofthreadsforhighpriorityjobs.
OracleMapServer:ProxyServerURLTheURLfortheproxyserverthatisusedtoconnecttoOracleMap/Geocoderserver.
Unifierconnecttoelocation.
oracle.
comtogetlocationinformationfromtheUSaddress.
Thisistheproxysettingrequired(ifnecessary)forUnifierservertoconnecttoelocationserver.
OraclemapServer:ProxyServerPortPortfortheproxyserverthatisusedtoconnecttoOracleMap/Geocoderserver.
Unifierconnecttoelocation.
oracle.
comtogetlocationinformationfromtheUSaddress.
Thisistheproxysettingrequired(ifnecessary)forUnifierservertoconnecttoelocationserver.
ChangingConfiguratorSettingsonLinuxAfterinitiallyinstallingandconfiguringUnifier,youmustfollowthisproceduretomakeanysubsequentchangestotheconfigurationsettings:1)StoppingUnifierinWebLogiconLinux(onpage72)2)EditingConfigurationDataonLinux(onpage72)3)StartingUnifierinWebLogiconLinux(onpage72)StoppingUnifierinWebLogiconLinuxTostopUnifierinWebLogic:1)OpentheWebLogicdirectorywithintheUnifierHomefolder.
2)Runthestop.
shfile.
3)Ifprompted,entertheWebLogicusernameandpassword.
EditingConfigurationDataonLinuxAfterstoppingUnifier,edittheconfigurationsettingsasfollows:1)IntheWebLogicdirectorywithintheUnifierHomefolder,locatetheconfigure.
shfile.
2)Runconfigure.
sh.
3)Makenecessaryconfigurationchanges,andclickSave.
4)StartUnifierinWebLogic.
StartingUnifierinWebLogiconLinuxTostartUnifierinWebLogic:1)OpentheWebLogicdirectorywithintheUnifierHomefolder.
2)Runthestartup.
shfile.
3)Ifprompted,entertheWebLogicusernameandpassword.
InstallingUnifieronLinux73OpeningtheConfiguratorToopentheConfiguratorfollowthesesteps:1.
Installxorg-x11fontsusingfollowingcommands:repoquery-q-f*/xclocksudoyum-yinstallxorg-x11-appssudoyum-yinstallxorg-x11-fonts*sudoyumgroupinstall"DevelopmentTools"sudoyuminstallgtk+-develgtk2-devel2.
GotoUnifier/configuratorandeditthebuild.
xmlfilebyaddingthefollowinglines:3.
GotoJAVA_HOME/jre/lib/fontsandcreateafilelogicalfonts.
propertieswiththefollowingcontent:sans.
regular.
0.
font=LucidaSansRegularsans.
regular.
0.
file=LucidaSansRegular.
ttfsans.
bold.
0.
font=LucidaSansBoldsans.
bold.
0.
file=LucidaSansDemiBold.
ttfmonospace.
regular.
0.
font=LucidaTypewriterRegularmonospace.
regular.
0.
file=LucidaTypewriterRegular.
ttfmonospace.
bold.
0.
font=LucidaTypewriterBoldmonospace.
bold.
0.
file=LucidaTypewriterBold.
ttfserif.
regular.
0.
font=LucidaBrightserif.
regular.
0.
file=LucidaBrightRegular.
ttfserif.
bold.
0.
font=LucidaBrightDemiboldserif.
bold.
0.
file=LucidaBrightDemiBold.
ttfserif.
italic.
0.
font=LucidaBrightItalicUnifierInstallationGuideforOn-Premises74serif.
italic.
0.
file=LucidaBrightItalic.
ttfserif.
bolditalic.
0.
font=LucidaBrightDemiboldItalicserif.
bolditalic.
0.
file=LucidaBrightDemiItalic.
ttfCopyingtheConfigurationDataFileTheconfigurationdatafortheConfiguratorisstoredautomaticallyundertheinstallationfolderinthe/configurator/bluedoor.
propertiesfile.
Ifnecessary,youcantransfertheconfigurationsettingsfromoneenvironmenttoanotherbycopyingtheconfigurationdatafileandeditingitwiththenewconfigurationsettings.
ConfiguringtheOHTTPServer(OHS)AfterinstallingOHTTPServer(OracleHTTPServer),orOHS,configureasfollows:1)Modifythe$ORACLE_INSTANCE/config/OHS/ohs1/httpd.
conffileasfollows:a.
Changethedefaultlistenportfrom7777to80.
Note:Beforemakingtheabovechange,disableorturn-offanyotherapplicationthatisusingport80(suchasIISorWindows).
b.
AddsettingsafterDocumentRootasfollows:DocumentRoot/apps/ROOTc.
Addparametersbetweensoitappearsasfollows:/apps/ROOT">OptionsIncludesFollowSymLinksAllowOverrideNoneRequireallgrantedDirectoryIndexindex.
html/apps/ROOT/WEB-INF">Requirealldeniedd.
#SupportHttpmethodGET/POSTonlyRewriteEngineOnRewriteCond%{REQUEST_METHOD}!
^(GET|POST)RewriteRule.
*-[F]e.
HeadersetContent-Security-Policy"default-src'self';frame-src*;child-src*;script-src'self''unsafe-inline''unsafe-eval'http://elocation.
oracle.
comhttps://elocation.
oracle.
com*.
oracle.
com;style-src'self''unsafe-inline';img-src'self'data:http://elocation.
oracle.
comhttps://elocation.
oracle.
com*.
oracle.
com"InstallingUnifieronLinux75HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"UnifierInstallationGuideforOn-Premises76HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"InstallingUnifieronLinux77HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"HeadersetContent-Security-Policy"connect-src'self'http://localhost:2345http://localhost:7575http://localhost:8888http://localhost:9999https://localhost:2345https://localhost:7575https://localhost:8888https://localhost:9999"Notes:istheunifierinstallationdirectory.
ThesessionaboutSupportingHttpmethodGET/POSTonlycanbe(ormaybe)addedattheendofhttp.
conffile.
2)Addthefollowingtothe$ORACLE_INSTANCE/config/OHS/ohs1/mod_wl_ohs.
conffile:SetHandlerweblogic-handlerWebLogicHostlocalhostWebLogicPort7001ExpiresActiveonExpiresDefault"accessplus6month"HeadersetX-Content-Type-Options"nosniff"HeadersetX-XSS-Protection"1;mode=block"LoadModuledeflate_module"${ORACLE_HOME}/ohs/modules/mod_deflate.
so"SetOutputFilterDEFLATEUnifierInstallationGuideforOn-Premises78DeflateBufferSize20000Note:Modifytheenteries(#2)underasnecessary:WebLogicHost:WeblogicserverhostnameorIPaddress.
ForWebLogicPort:Weblogicserverportnumber.
The"deflate_module"mustbeloadedbefore"/instances/instance1/config/OHS/ohs1/mime.
types3.
Modifythe$ORACLE_INSTANCE/config/OHS/ohs1/ssl.
conffileasfollows:ForOHTTP,orOHS,version:Note:Forthefulllistofsystemrequirements,applications,andapplicationversionlevelsrefertothePrimaveraUnifierTestedConfigurationsinthePrimaveraUnifierDocumentationLibrary.
Replace:SSLProtocolnzos_Version_1_0nzos_Version_3_0With:SSLProtocol-all+TLSv1.
2Replace:SSLCipherSuiteSSL_RSA_WITH_RC4_128_MD5,SSL_RSA_WITH_RC4_128_SHA,SSL_RSA_WITH_3DES_EDE_CBC_SHA,SSL_RSA_WITH_DES_CBC_SHA,TLS_RSA_WITH_AES_128_CBC_SHA,TLS_RSA_WITH_AES_256_CBC_SHAWith:SSLCipherSuiteHIGHNote:OraclerecommendstheSSLv3protocolforOHS11gversionandtheTLSv1.
2forOHS12cversion.
4.
OnWindows:RunstartNodeManager.
cmdandstartComponent.
cmdohs1OnLinux:Run.
/startNodeManager.
shand.
/startCOmponent.
shohs1Note:IfOAMisusedtosetupUnifierthenloginintoOAMconsole,navigatetoresourcestabandadd3resourcesinit:/jVue/**,/VueServlet/**and/jvueDMS/**.
TheProtectionlevelshouldbeexcludedforthenewlycreatedresources.
IfanyotherSSOserverisusedthenperformthesimilarstepsinthisserver.
InstallingSSLCertificate(Optional)UnifierworksinSecureorNon-securemode.
InstallingaSecureSocketLayer(SSL)certificateisoptional.
InstallingUnifieronLinux79DataBackupRecommendationsOraclePrimaverarecommendsthatPrimaveraUnifierdatabeincorporatedintoyourcompanybackupprocedures.
PrimaveraUnifierdataisstoredintwoplaces:UnifierdatabaseFilesRepositoryTheserepositoriesneedtobebackedupregularly.
DeployingUnifierTodeployUnifierintotheWebLogicdomain,completethefollowingprocedures:1)CreatinganEARFileFromtheConfigurator(onpage44)2)DeploythegeneratedEARfileusinganyofthefollowingmethods:DeployingUnifierFromtheUnifier_HomeDirectoryonWindows(onpage44)DeployingUnifierfromtheWebLogicAdministrationConsole(onpage45)CreatinganEARFileFromtheConfiguratorCompletethefollowingstepstocreatean.
EARfilefromtheconfigurator:1)AccesstheConfigurator.
2)Intheconfigurator,selectCreateEAR.
3)Bydefault,the.
EARfileiscreatedintheunifier/weblogicdirectory.
4)Savethefileasunifier.
ear.
5)Proceedtodeployunifier.
earinWebLogicusinganyofthefollowingmethods:DeployingUnifierFromtheUnifier_HomeDirectoryonWindows(onpage44)DeployingUnifierfromtheWebLogicAdministrationConsole(onpage45)DeployingUnifierFromtheUnifier_HomeDirectoryonLinuxAftercreatingthe.
EARfile,deployUnifierasfollows:1)Inthe\weblogicdirectory,createasetEnv.
shfilebycopyingthesetenv_sample.
shfile.
2)Editthesetenv.
shfileasfollows:Setthedomain_homevariabletospecifythepathofthedomainhomefolderthatwillbeusedbyUnifier.
SettheadminurlvariabletospecifyhostnameandportnumberusedbytheUnifierdomain.
Setthejava_homevariabletotheJDKinstalleddirectory.
SettheUSER_MEM_ARGSvariablespecifytheJVMmaximummemorysetting.
3)SavesetEnv.
sh.
4)Runstartup.
sh.
UnifierInstallationGuideforOn-Premises805)Rundeploy.
sh.
6)Whenprompted,entertheWebLogicadministratorusernameandpassword.
TheUnifierapplicationwillbedeployedinWebLogicusingthevariablessetinthesetEnv.
sh.
Note:Thisprocessmaytakeseveralminutes.
DeployingUnifierfromtheWebLogicAdministrationConsoleAftercreatingthe.
EARfileintheConfigurator,deploythefilefromtheWebLogicAdministrationConsoleasfollows:1)IntheChangeCenterpane,selectLock&Edit.
2)IntheDomainStructurepane,selectDeployments.
3)IntheSummaryofDeploymentspane,selectInstall.
4)IntheInstallApplicationAssistantpane:a.
Specifythepathtotheunifier.
earfileandclickNext.
Forexample:c:\\weblogic\unifier.
ear.
b.
SelectInstallthisdeploymentasanapplicationandclickNext.
c.
AcceptthedefaultsandclickNext.
d.
ReviewtheconfigurationsettingsyouhavechosenandselectFinishtocompletetheinstallation.
5)IntheSettingsforunifierwindow,selectSave.
6)IntheChangeCenterpane,selectActivateChanges.
7)IntheDomainStructurepane,selectDeployments.
8)IntheSummaryofDeploymentspane:a.
Selectunifier.
b.
SelectthedownarrowtotherightoftheStartbuttonandselectServicingallrequests.
9)IntheStartApplicationAssistantpane,selectYes.
Note:TheunifierstatecolumnshouldbeActive.
IfthestateisStartRunning,refreshthescreenuntilthestatusischangedtoActive.
DeployingUnifiertoaWebLogicClusteronLinuxTherearetwotypesofclusteringenvironments:1)IndividuallydeployedWebLogicserverthatpointstothesameUnifierDB.
2)WebLogicclusterofmultiplemanagedservers,deployedwithasingleEARfile.
Forbothclusteringenvironments,filesmustbeplacedonashareddrivethatisaccessiblebyotherservermachinesthatareoperatinginaclusteringenvironment.
InstallingUnifieronLinux81Inaddition,fortheWebLogiccluster,thedirectorypathmustbethesameforallWebLogicclusterserversbecausethesameEARfile(andconfigurationsetup)isusedbyallWebLogicclusterservers.
TosetupaWebLogiccluster,refertotheWebLogicdocumentationfordetailedinstructions.
Aftersettingupthecluster,generatetheEARfileanddeployUnifierusingtheEARfileasdescribedinthisguide.
LaunchingUnifierThissectiondescribeshowto:StartUnifierforthefirsttimeInstallUnifierapplicationsSetupyourcompanyBeforelaunchingPrimaveraUnifier,ensurethatyouhavereadtheGettingStartedsectionoftheUnifierHelp,whichcontainsimportantinformationaboutconfiguringyourbrowserforusewithPrimaveraUnifier.
UnifierURL(WebLogic)Inyourbrowser,navigatetotheURLthatlaunchestheUnifierapplicationlocally.
Forexample:http://unifier.
oracle.
com:7001StartingUnifierfortheFirstTimeIntheSignInwindow,signintoUnifierwiththedefaultAdministratorusername(Administrator)andpassword(Administrator).
Unifierimmediatelypromptsyoutochangeyourpassword.
Werecommendyoudosoimmediatelyforsecurityreasons.
Onceyouchangeyourpassword,UnifiercreatesyourAdministratoraccount.
TheAdministratoraccountistheonlyaccountwithpermissionsautomaticallysetforallfeatures.
TheAdministratorcannotbeamemberofanyproject,evenifcreatedintheHostingCompany.
DeployingUnifierOnlineHelpBydefaultUnifieronlinehelpisdeployedfromsitehostedbyOracle.
TodeployUnifierhelplocally,orfromanalternativeURL,proceedasfollows:1)FromtheHelptopicofthePrimaveraUnifierDocumentationLibrary,downloadhelp.
zip.
2)Extractthecontentsofthehelp.
ziptothefolderspecifiedintheUnifierHelpURLfieldintheGeneraltaboftheConfigurator.
UnifierInstallationGuideforOn-Premises82DownloadingandInstallingUnifierBaseProductsIfyourlicensingagreementincludesPrimaveraUnifierProjectControlsand/orUnifierFacilitiesandRealEstateManagementbaseproducts(applications/products),theSiteAdministratorcandownloadandinstallthebaseproductsbyfollowingtheinstructionsbelow.
Note:EnsurethatthePrimaveraUnifier(platform)hasbeeninstalledbeforeyouproceedtodownloadandinstallthebaseproducts(seeDownloadingUnifierfordetails).
DownloadUnifierbaseproductsbyfollowingthesesteps:1)Gotohttps://edelivery.
oracle.
com/(OracleSoftwareDeliveryCloud)andsignin.
2)NavigatetoaccessthePrimaveraUnifierpage.
3)DownloadthePrimaveraUnifierProjectControlsand/orUnifierFacilitiesandRealEstateManagementbaseproducts(applications/products).
ThedownloadedfolderscontainthenecessaryfilesforinstallingthePrimaveraUnifierProjectControlsand/orUnifierFacilitiesandRealEstateManagementbaseproducts(applications/products).
TheseUnifierbaseproductshavethepreconfigureddesigns(BusinessProcessesandAttributeforms).
Note:Ifyoureceiveanerrormessageduringtheinstallationofthebaseproducts,thentrytoreinstallthebaseproductsagain.
Ifreinstallingresultsinreceivingerrormessages,contactOracleSupport.
RecommendedSetupafterDownloadingBaseProductsBasedonyourlicensingagreement,youcansetup/configurethefollowingthreeUnifierenvironments:1)Development2)Test3)ProductionUnifier(Platform)versionwillbeloadedbydefaultinalltheenvironments.
Afterthedownloadiscomplete,theSiteAdministratorcaninstallthePrimaveraUnifierProjectControlsand/orPrimaveraUnifierFacilitiesandRealEstateManagementbaseproductsinDevelopmentandTestenvironmentsbasedonyourlicensingagreement.
DownloadingandInstallingUnifierBaseProducts83Note:Inthistypeofinstallation,thenewdesignscreatedintheDevelopmentenvironmentareunpublisheduntilthecreationofProductionconfigurationpackage.
UnpublishedconfigurationpackagecanbeimportedtotheTestenvironmentfortesting.
AfteraProductionconfigurationpackageiscreated,alldesignsthatareincludedintheconfigurationpackagewillbepublished.
Thefollowingexplainstherecommendedsetup(whichdownloadedfoldersmustbeplacedinwhichenvironment):PrimaveraUnifierProjectControlsDevelopmentTheBASICfiles(alreadyloadedinenvironment)ThemainUnifierapplicationfiles("unifier_#.
zip"(where#representtheUnifierversionnumber)folder)ThefilesinthemainzipfolderfromPrimaveraUnifierProjectControlsdownloadTestTheBASICfiles(alreadyloadedinenvironment).
ThemainUnifierapplicationfiles("unifier_#.
zip"(where#representtheUnifierversionnumber)folder)ThefilesinthemainzipfolderfromPrimaveraUnifierProjectControlsdownloadProductionTheProjectControlsbaseproductcanbetransferredfromdevelopmentenvironmentbyusingtheconfigurationpackagePrimaveraUnifierFacilitiesandRealEstateManagementDevelopmentTheBASICfiles(alreadyloadedinenvironment)ThemainUnifierapplicationfiles("unifier_#.
zip"(where#representtheUnifierversionnumber)folder)ThefilesinthemainzipfolderfromPrimaveraUnifierFacilitiesandRealEstateManagementdownloadTestTheBASICfiles(alreadyloadedinenvironment).
ThemainUnifierapplicationfiles("unifier_#.
zip"(where#representtheUnifierversionnumber)folder)ThefilesinthemainzipfolderfromPrimaveraUnifierFacilitiesandRealEstateManagementdownloadProductionThePrimaveraUnifierFacilitiesandRealEstateManagementbaseproductcanbetransferredfromdevelopmentenvironmentbyusingtheconfigurationpackageNote:SincethecontentofthematerialcreatedbytheUsers(alsoknownasCustomStrings)canbetranslatedintodifferentlanguages,withtheUnifierInstallationGuideforOn-Premises84exceptionofdataorvalueenteredbytheuser,you(UnifierAdministrator)mustsignintoUnifier,navigatetotheCompany,expandtheConfigurationnode,selecttheInternationalizationnode,clicktheRefreshdrop-downlist,andselectAllStringstopopulatetheCustomStringtable.
Ifyoudonotrefreshaftertheinstallation,certainUnifierfunctionswillnotworkproperly.
Thefollowingexplainshowtoinstallthebaseproductsafterdownloadingthefiles:WhenyousigninastheSiteAdministrator,UnifierdisplaystheHometabinAdministrationMode.
1)IntheleftNavigator,clickApplicationsnode.
Unifierdisplaysaninstallpanelontheright-handsideofthewindow.
2)ClickInstalltoopentheInstallPrimaveraUnifierApplicationwindow.
Usethefollowinginformationtocompletethefieldsinthewindowandwhenfinished,clickInstall.
Note:EnsurethattheTemporarydirectoryissetintheConfigurator(Generaltab).
CompanyDetailsInthisfield:Dothis:NameEnterthenameofthecompany.
ShortNameEnteraone-wordshortname,upto60characters.
TheShortNameisaunique,one-wordabbreviatedformofyourcompanyname,andisusedthroughoutPrimaveraUnifierinplaceofthecompanyname.
(Forexample,whenimportinguDesigner-createdbusinessprocesses,andonlogsthatidentifypartnercompanies.
)CurrencyEnterthedefaultcurrencythatwillbeusedbythecompany.
ContactEmailEntertheemailaddressthatwillbeusedforallemailssentfromtheSupportlinkinUnifier.
LicensedUsersEnterthenumberofuserswhowillbelicensedtousetheapplication.
AddressTypeIdentifytheaddressyouareentering,suchasHeadquarters,BillingOffice,orSatelliteOffice.
AddressEnterthecompanyaddress.
CityEnterthecityfortheaddress.
State/ProvinceEnterthestateorprovincefortheaddress.
ZipEnterthezipcodefortheaddress.
Country/RegionEnterthecountryorregionfortheaddress.
DownloadingtheUnifierMobileApp85AdminLoginUsernameEnterthecompanyadministrator'susername.
Defaultiscoadmin.
ThisusernamewillbeautomaticallyaddedtotheCompanyAdministratorsgroup.
Thecoadminuser,bydefault,getsallthepermissionsforthenewdesignsornewmodules.
Essentiallythisuserthatiscompanyadministratorwillhaveallthepermissionsacrossthecompanyandprojects.
PasswordEntertheadministrator'spassword.
ConfirmPasswordRe-enterthepassword.
SelectDownloadedApplicationtoInstallInthisfield:Dothis:ApplicationFileThisfieldisavailableontheDevelopmentserver.
TheApplicationFileisusedtoselectthesampleapplicationsthatyouwanttoinstall.
Note:Ensurethatyoupointtothedownloaded.
zipfile,only.
The.
zipfiledoesnotneedtobeextracted.
DownloadingtheUnifierMobileAppDownloadingUnifierMobileAppforiOS/AndroidGotoAppStore/PlayStoreonyourmobiledeviceanddownloadtheUnifierMobileApp.
ConfiguringLoginandAuthenticationSettingstoUseUnifierMobileAppiOS/AndroidTostarttheapp:1)FindtheUnifierapponyourdevice()andtaptolaunchtheapp.
2)SlidetheSingleSignOn(SSO)switchtoeitherONorOFFposition.
IfyouturnONtheSSOswitch:1)TaptheURLfieldandentertheURLtoyourserver(forexample,http://server:port/).
Note:YouwillneedtospecifytheservernameandportnumberintheURL.
2)TapAuthenticate.
3)EnteryourSSOusernameandpassword.
IfyouturnOFFtheSSOswitch:1)TaptheURLfieldandentertheURLtoyourserver(forexample,http://server:port/).
2)EnteryourUnifierusernameandpassword.
UnifierInstallationGuideforOn-Premises863)TapSignIn.
87AppendixA:InstallingaServicePack(WebLogic)Toobtaintheapplicableservicepack,gotoOracleSupport.
UsetheReadmeassociatedwiththeservicepackforinstructionsabouthowtoapplytheservicepack.
89AppendixB:ArchivingProjectsArchivingallowsSiteAdministratortoarchiveindividualprojects.
ConfiguringPrimaveraUnifierforProjectArchivingSetupthearchiveparameters(ArchiveDirectoryandArchiveTempDirectory).
Referto"RepositoryTab.
"ArchivingProjectsThearchivingprocesscapturesprojectdataandcreates.
csvfilesforallrecords,includingbusinessprocesses,tasks,documents,attachments,users,groups.
Note:Inordertoarchiveprojects,youmusthave"Archive"permissionasaHostingCompanyuser.
(ThispermissionisfoundunderProjects(Standard)inAccessControlorthePermissionstaboftheEditUser/Groupwindow;companymustbeHostingCompany.
)Toarchiveprojects:1)SignintoPrimaveraUnifierasSiteAdministrator.
2)InAdministrationMode,navigatetoSystem,CustomerSupport,Projects.
TheProjectlogopens.
3)Selecttheprojecttoarchive.
Ifaprojecthasnotyetbeenarchived,theArchiveStatuscolumnwilldisplayNotStarted.
4)ClicktheArchiveProjectbutton.
TheArchiveStatuscolumnwillchangetoScheduled.
Abackgroundprocesspicksuptherequestandrunsthearchiveprocess.
Onceitisdone,thestatuswillchangetoReady.
Thelocationofthezipfilethatcontainsthedatawillbelocatedinthedirectoryyouspecifiedduringconfiguration.
91AppendixC:WebLogicClusteringforHighAvailabilityAboutWebLogicClusteringWebLogicServerclustersprovidescalabilityandreliabilityforyourapplicationsbydistributingtheworkloadamongmultipleinstancesofWebLogicServer.
IncomingrequestscanberoutedtoaWebLogicServerinstanceintheclusterbasedonthevolumeofworkbeingprocessed.
Incaseofhardwareorotherfailures,sessionstateisavailabletootherclusternodesthatcanresumetheworkofthefailednode.
AWebLogicserverclusterconsistsofmultipleWebLogicserverinstancesrunningsimultaneouslytoprovideincreasedscalabilityandreliability.
AclusterappearstoclientstobeasingleWebLogicserverinstance.
Theserverinstancesthatconstituteaclustercanrunonthesamemachine,orbelocatedondifferentmachines.
Youcanincreaseacluster'scapacitybyaddingadditionalserverinstancestotheclusteronanexistingmachine,oryoucanaddmachinestotheclustertohosttheincrementalserverinstances.
Note:EachserverinstanceinaclustermustrunthesameversionofWebLogic.
RelationshipbetweenClustersandDomainsAdomainisaninterrelatedsetofWebLogicserverresourcesthataremanagedasaunit.
AdomainincludesoneormoreWebLogicserverinstances,whichcanbeclustered,non-clustered,oracombinationofclusteredandnon-clusteredinstances.
Adomaincanincludemultipleclusters.
Adomainalsocontainstheapplicationcomponentsdeployedinthedomain,andtheresourcesandservicesrequiredbythoseapplicationcomponentsandtheserverinstancesinthedomain.
Examplesoftheresourcesandservicesusedbyapplicationsandserverinstancesincludemachinedefinitions,optionalnetworkchannels,connectors,andstartupclasses.
Ineachdomain,oneWebLogicserverinstanceactsastheAdministrationServer—theserverinstancethatconfigures,manages,andmonitorsallotherserverinstancesandresourcesinthedomain.
EachdomaincontainsoneAdministrationServeronly.
Ifadomaincontainsmultipleclusters,eachclusterinthedomainhasthesameAdministrationServer.
Allserverinstancesinaclustermustresideinthesamedomain;youcannotsplitaclusterovermultipledomains.
Similarly,youcannotshareaconfiguredresourceorsubsystembetweendomains.
ClusteredWebLogicserverinstancesbehavesimilarlytonon-clusteredinstances,exceptthattheyprovidefailoverandloadbalancing.
TheprocessandtoolsusedtoconfigureclusteredWebLogicserverinstancesarethesameasthoseusedtoconfigurenon-clusteredinstances.
However,toachievetheloadbalancingandfailoverbenefitsthatclusteringenables,youmustadheretocertainguidelinesforclusterconfiguration.
UnifierInstallationGuideforOn-Premises92HighAvailabilitywithWebLogicClusteringUnifiercanutilizeWebLogicclusteringtocontinueprocessingdatawhenaserverinstancefails.
YouclusterUnifierbydeployingitonmultipleserverinstancesinthecluster.
IfaserverinstanceonwhichUnifierisrunningfails,thenanotherrunningserverinstanceonwhichUnifierisdeployedcancontinuetoprocessdata.
Foramorecomprehensiveproductoverview,documentation,andcommunityforumsforWebLogicanditsclusteringfunctionality,referto:http://www.
oracle.
com/technetwork/middleware/weblogic/overview/index.
htmlIntroductiontoHighAvailabilityHighavailabilityallowsapplicationprocessingtocontinuewhenaserverinstancefailsandprovidesareliableenvironmentwithminimalornolossofservice.
HighAvailabilityisoftenachievedthroughtheuseofclusters,unitsofserversrunningconcurrentlytoprovideapplicationfailoverandloadbalancing.
Enterpriseapplicationdeploymentscanbenefitfromtheadditionalrelianceandflexibilityhighavailabilitysystemsprovide.
ReasonsforImplementingHighAvailabilityMissioncriticalcomputersystemsneedtobeavailable24hoursaday,7daysaweek,and365daysayear.
However,partorallofthesystemmaybeinoperableduringplannedorunplanneddowntime.
Asystem'savailabilityismeasuredbytheamountoftimethatitprovidesserviceoverthetotaltimeelapsedsincethesystem'sinitialdeployment.
Systemdowntimemaybecategorizedasplannedorunplanned.
Planneddowntimereferstoscheduledoperationsthatrenderthesystemunavailable.
Theeffectofplanneddowntimeonendusersistypicallyminimizedbyschedulingdowntimewhensystemtrafficisslow.
Unplanneddowntimeisanysortofunexpectedfailure.
Unplanneddowntimemayhaveagreatereffectthanplanneddowntimebecauseitcanhappenatpeakhours,disruptbusinessoperations,orleadtolostproductivityorrevenue.
WhendesigningyourUnifierimplementation,itisimportanttorecognizethecostofdowntimetounderstandhowyourservicescanbenefitfromavailabilityimprovements.
HighAvailabilityOptionsforUnifierWebLogicClusteringenablesyoutoprovidehighavailabilityforUnifierapplications,ensuringyourservicesremainscalableandresilientagainstunexpectedfailures.
PrerequisitesforWebLogicClusteringThisguideassumesthatyouhavealreadyinstalledandconfiguredUnifier.
Note:TheinstallationwizarddeploysUnifiertoasinglemanagedserverassignedtoaclusterwithinaWebLogicdomain.
InadditiontotheprerequisitestoenableWebLogicclusteringonyourinitialUnifierdeployment,whicharedescribedineitherInstallationPrerequisitesoftheInstallationandConfigurationGuideorPrerequisitesinManualDeploymentGuide,youwillneedtoinstallasupportedversionofOracleHTTPServer.
ForasupportedversionofOracleHTTPServer,refertoTestedConfigurations.
AppendixC:WebLogicClusteringforHighAvailability93DeployingUnifierwithWebLogicclusteringrequiresyoutoinstallWebLogiconeachmachinethatwillusetheUnifierdomain,whichwascreatedbytheUnifierconfigurationwizard.
Note:YoumustinstallthesameversionofWebLogiconeachmachine.
SettingUpWebLogicClusteringforUnifierApplicationsAfteryouhaveinstalledandconfiguredUnifier,youcanaddnewmachines,servers,andclustersusingtheWebLogicAdministrationConsole.
Youmustthenaddanynewserverstodifferentmachinesandcreateaclustertoutilizehighavailabilityforyourapplicationdeployments.
Aftercreatingacluster,youmustaddserverstothecluster.
ToaddnewserverstoyourclustersandestablishhighavailabilityforyourUnifierapplications,completethefollowingtopicsintheorderthattheyarelisted:AddingNewMachinesinWebLogicAddingNewServersinWebLogicAddingNewClustersinWebLogicAssigningServerstoClustersAssociatingServerswithMachinesCopyingtheUnifierDomaintoAdditionalMachinesRunningNodeManagerasaServiceStartingNodeManagersandManagedServersonAdditionalMachinesAftertheservershavebeenaddedtoyourcluster,deploytheUnifierWebLogicdomaintonewmachinesbycreatingazipfileofthedomain,extractingitscontentstothedomainsfolderinOracleMiddlewareHome,andthenupdatingnodemanager.
propertieswiththecorrectListenAddresshostname.
FortheprocedurestodeploytheUnifierdomaintonewmachines,refertoCopyingtheUnifierDomaintoAdditionalMachines.
WhendeployingUnifiertomanagedserversinaclusterrunningacrossdifferentphysicalmachinestothedomain'sadministrationserver,youmustmodifytheWebServiceManager(WSM)PolicyManagerontheremotemachinessothattheadditionalmanagedserverscanusetheWSMPolicyFramework.
TomodifytheWSMPolicyManager,refertoModifyingtheWSMPolicyManager.
Lastly,configuretheWebLogicproxyplugindriver(mod_wl_ohs)ofanOracleHTTPServer(OHS)instancetoconnecttotheUnifierWebLogicclusterusingtheinstructionsinConfiguringtheWebLogicProxyPluginDriverofanOracleHTTPServerandthenstartyournodemanagersandmanagedserversusingtheinstructionsinStartingtheNodeManagersandManagedServersonAdditionalMachines.
AddingNewMachinesinWebLogicToaddnewmachinesinWebLogic:1)LogintotheWebLogicAdministrationConsolewiththefollowingURL:http://:/console2)IntheChangeCenterpane,clickLock&Edit.
3)IntheDomainStructurepane,clickEnvironmentandthenclickMachines.
4)ClickNew.
5)OntheCreateaNewMachinepage,completethefollowing:UnifierInstallationGuideforOn-Premises94a.
IntheNamefield,enteralogicalnameforthemachine(forexample,Machine1).
b.
IntheMachineOSlist,selectUnixifthemachineusesaUnixoperatingsystemorselectOtherifthemachineusesanon-Unixoperatingsystem,suchasWindows.
c.
ClickNext.
6)OntheCreateaNewMachinepage,completethefollowing:a.
IntheTypelist,selecttheprotocolwithwhichthenodemanageronthemachinecommunicateswithitsservers.
TheprotocoloptionsareSSL(defaultoption),Plain,RSH,andSSH.
b.
IntheListenAddressfield,enterthehostnameorIPAddressoftheremoteserver.
c.
InthePortfield,entertheportnumberfortheremoteserveronwhichthenodemanagerwillrun.
d.
ClickFinish.
7)ClickActivateChanges.
AddingNewServersinWebLogicToaddnewserversinWebLogic:1)LogintotheWebLogicAdministrationConsolewiththefollowingURL:http://:/console2)IntheChangeCenterpane,clickLock&Edit.
3)IntheDomainStructurepane,clickEnvironmentandthenclickServers.
4)ClickNew.
5)OntheCreateaNewServerpage,completethefollowing:a.
IntheServerNamefield,enteranameforthemanagedserver.
b.
IntheServerListenAddressfield,enterthehostnameorIPAddressoftheremoteserver.
c.
Note:IfyouplantoaddanewmanagedserveronthesamephysicalserverastheAdministrationserver,youcanleavethisfieldblank.
Thisallowsalllocallisteningaddressesontheservertobeutilized.
d.
IntheServerListenPortfield,entertheportnumberfromwhichyouwanttoaccesstheserverinstance.
e.
Youcanmoreeasilymanageandmaintaintheserversinyourclusterbyusingthesameportnumberacrossallofyourmanagedservers.
f.
SelectYes,makethisserveramemberofanexistingcluster.
g.
Selectacluster.
h.
ClickFinish.
6)ClickActivateChanges.
AddingNewClustersinWebLogicAddingNewClustersinWebLogicToaddnewclustersinWebLogic:1)LogintotheWebLogicAdministrationConsolewiththefollowingURL:http://:/consoleAppendixC:WebLogicClusteringforHighAvailability952)IntheChangeCenterpane,clickLock&Edit.
3)IntheDomainStructurePane,clickEnvironment,thenclickClusters.
4)ClickNew,thenselectCluster.
5)OntheCreateaNewClusterpage,completethefollowing:a.
EnteranamefortheclusterintheNamefield.
b.
Selectamessagingmodeforthecluster,UnicastorMulticast.
c.
IfyouselectedUnicast,enteraUnicastBroadcastChannel.
d.
IfyouselectedMulticast,enteraMulticastAddressandaMulticastPortnumber.
6)ClickOk.
7)ClickActivateChanges.
8)TolearnmoreaboutWebLogicclusters,clusterconfiguration,andapplicationdeployment,refertotheofficialWebLogicdocumentation:http://docs.
oracle.
com/middleware/12211/wls/CLUST/toc.
htmAssigningServerstoClustersToassignserverstoclustersinWebLogic:1)LogintotheWebLogicAdministrationConsolewiththefollowingURL:http://:/console2)IntheChangeCenterpane,clickLock&Edit.
3)IntheDomainStructurePane,clickEnvironment,thenclickClusters.
4)Clickthenameoftheclusteryouwanttowhichyouwanttoassignservers.
5)OntheSettingsforpage,clicktheServerstab.
6)OntheServerstab,intheServerstable,clickAdd.
7)SelectSelectanexistingserver,andadditasamemberofthiscluster,toaddapreexistingservertothecluster.
8)SelectaserverintheSelectaserverlist.
9)ClickNext.
10)ClickActivateChanges.
AssociatingServerswithMachinesToassociateaserverwithamachine:1)LogintotheWebLogicAdministrationConsolewiththefollowingURL:http://:/console2)IntheChangeCenterpane,clickLock&Edit.
3)IntheDomainStructurepane,clickEnvironmentandthenclickMachines.
4)Clickthenameofthemachinetowhichyouwanttoaddaserver.
5)UndertheConfigurationtab,clickServers.
6)ClickAdd.
7)OntheAddServertoMachinepage,completethefollowing:a.
SelectSelectanexistingserver,andassociateitwiththismachine.
UnifierInstallationGuideforOn-Premises96b.
IntheSelectaServerlist,selectthenameoftheserverthatyouwanttoaddtothemachine.
c.
ClickFinish.
8)ClickActivateChanges.
CopyingtheUnifierDomaintoAdditionalMachinesAfteryouhaveaddednewmanagedserverstoyourUnifierclusterandmodifiedtheWSMPolicyManager,createazipfileofyourinitialUnifierdomain.
Afterthezipfileiscreated,extracttheWebLogicdomainandcomponentsontheremotemachineswhichcontainadditionalmanagedservers.
AfteryouhavesuccessfullyextractedtheWebLogicdomaintoadditionalmachines,modifythenodemanager.
propertiesfilewithinformationaboutthehostnameonwhichtheadministrationserverruns.
ToaddtheUnifierdomaintoadditionalmachines:1)NavigatetotheOracleMiddlewareHomeofthemachineonwhichyoucreatedtheinitialUnifierdomain.
2)CreateazipfileoftheuserprojectsfolderoftheUnifierdomain.
3)Copythezipfiletothemachinesonwhichyouhavecreatedadditionalservers.
4)ExtractthezipfiletotheOracleMiddlewareHomefolderontheadditionalmachines.
Note:Whencopyingthedomain,ensurethatthedirectorystructureofeachadditionalWebLogicinstanceissimilartothedirectorystructureoftheWebLogicinstancewhereyouinitiallyinstalledtheUnifierdomain.
5)Navigateto/user_projects/domains/primavera/nodemanager.
6)Editnodemanager.
properties.
7)ModifytheListenAddresshostnameandListenPortnumbertomatchthehostnameandportnumberofyourcurrentmachineandthensaveyourchanges.
RunningNodeManagerasaServiceTorunthenodemanagerasabackgroundprocessuponsystemstartup,youcanrunthenodemanagerasaserviceonWindowsoryoucanconfigurethenodemanagerasadaemononUnix.
ForUnixTostartthenodemanageruponsystemstartupandtorunitinthebackground:1)Openaterminalandrunthefollowingscript:nohup/user_projects/domains//bin/startNodeManager.
sh>logfilename.
log2>&1&2)Createashellscriptusingthefollowingsamplescript:#!
/bin/bash##wlsnmdOracleWeblogicNodeManagerservice##chkconfig:3458515AppendixC:WebLogicClusteringforHighAvailability97#description:OracleWeblogicNodeManagerservicecase"$1"instart)exportWL_HOME=/wlserver/$WL_HOME/.
.
/user_projects/domains//bin/startNodeManager.
sh;;*)echo"Usage:$0{start}"exit1esacexit_status3)Savethescriptto/etc/init.
d/nodemgr.
4)Runthefollowingcommandwithrootprivileges:#chmod+x/etc/init.
d/nodemgr#chkconfig--addnodemgrForWindowsTocreateandrunanodemanagerasaWindowsservice:1)Logintoamachinewithadministrativeprivileges.
2)Goto:/wlserver/server/bin.
a.
EditinstallNodeMgrSvc.
cmd.
b.
Commentoutthefollowinglines:setNODEMGR_HOST=setNODEMGR_PORT=c.
Saveyourchangesandthenclosethefile.
3)Goto:/user_projects/domains//bin.
a.
EditinstallNodeMgrSvc.
cmd.
b.
Commentoutthefollowinglines:setNODEMGR_HOST=setNODEMGR_PORT=c.
Saveyourchangesandthenclosethefile.
4)Openacommandpromptandthencompletethefollowing:a.
Changeyourdirectoryto/user_projects/domains//bin.
b.
RuninstallNodeMgrSvc.
cmd.
UnifierInstallationGuideforOn-Premises98Note:Ifthenodemanagerservicehasalreadybeeninstalled,thefollowingmessagewilldisplay:CreateServicefailed-Thespecifiedservicealreadyexists.
c.
Closethecommandprompt.
5)GotoControlPanel\AllControlPanelItems\AdministrativeToolsandthenclickServices.
6)Right-clickOracleWebLogicNodeManagerandthenclickStart.
StartingNodeManagersandManagedServersonAdditionalMachinesAftertheUnifierdomainhasbeenmodifiedonmachinesonwhichtheyreside,youmuststartthenodemanageroneachmachinetocontrolthemanagedserversfromtheWebLogicAdministrationConsole.
Tostartamanagedserver:1)LogintotheDomain'sAdministrationConsole.
2)IntheleftpaneoftheAdministrationConsole,expandEnvironmentandselectServers.
3)Intherightpane,selecttheControltab.
4)IntheServerStatustable,selectthecheckboxnexttothenameoftheserveryouwanttostartandclickStart.
5)ClickYestoconfirm.
Tostartthenodemanager:1)Goto/user_projects/domains//bin.
2)Dependingonyouroperatingsystem,completethefollowing:ForWindows,run:startManagedWeblogic.
batt3://:ForUnix,run:.
/startNodeManager.
sh99OraclePrimaveraUnifierInstallationGuideforOn-PremisesCopyright1998,2018,Oracleand/oritsaffiliates.
Allrightsreserved.
OracleandJavaareregisteredtrademarksofOracleand/oritsaffiliates.
Othernamesmaybetrademarksoftheirrespectiveowners.
IntelandIntelXeonaretrademarksorregisteredtrademarksofIntelCorporation.
AllSPARCtrademarksareusedunderlicenseandaretrademarksorregisteredtrademarksofSPARCInternational,Inc.
AMD,Opteron,theAMDlogo,andtheAMDOpteronlogoaretrademarksorregisteredtrademarksofAdvancedMicroDevices.
UNIXisaregisteredtrademarkofTheOpenGroup.
Thissoftwareandrelateddocumentationareprovidedunderalicenseagreementcontainingrestrictionsonuseanddisclosureandareprotectedbyintellectualpropertylaws.
Exceptasexpresslypermittedinyourlicenseagreementorallowedbylaw,youmaynotuse,copy,reproduce,translate,broadcast,modify,license,transmit,distribute,exhibit,perform,publishordisplayanypart,inanyform,orbyanymeans.
Reverseengineering,disassembly,ordecompilationofthissoftware,unlessrequiredbylawforinteroperability,isprohibited.
Theinformationcontainedhereinissubjecttochangewithoutnoticeandisnotwarrantedtobeerror-free.
Ifyoufindanyerrors,pleasereportthemtousinwriting.
IfthisissoftwareorrelateddocumentationthatisdeliveredtotheU.
S.
GovernmentoranyonelicensingitonbehalfoftheU.
S.
Government,thefollowingnoticeisapplicable:U.
S.
GOVERNMENTENDUSERS:Oracleprograms,includinganyoperatingsystem,integratedsoftware,anyprogramsinstalledonthehardware,and/ordocumentation,deliveredtoU.
S.
Governmentendusersare"commercialcomputersoftware"pursuanttotheapplicableFederalAcquisitionRegulationandagency-specificsupplementalregulations.
Assuch,use,duplication,disclosure,modification,andadaptationoftheprograms,includinganyoperatingsystem,integratedsoftware,anyprogramsinstalledonthehardware,and/ordocumentation,shallbesubjecttolicensetermsandlicenserestrictionsapplicabletotheprograms.
NootherrightsaregrantedtotheU.
S.
Government.
Thissoftwareorhardwareisdevelopedforgeneraluseinavarietyofinformationmanagementapplications.
Itisnotdevelopedorintendedforuseinanyinherentlydangerousapplications,includingapplicationsthatmaycreateariskofpersonalinjury.
Ifyouusethissoftwareorhardwareindangerousapplications,thenyoushallberesponsibletotakeallappropriatefailsafe,backup,redundancy,andothermeasurestoensureitssafeuse.
OracleCorporationanditsaffiliatesdisclaimanyliabilityforanydamagescausedbyuseofthissoftwareorhardwareindangerousapplications.
Thissoftwareorhardwareanddocumentationmayprovideaccesstoorinformationoncontent,productsandservicesfromthird-parties.
OracleCorporationanditsaffiliatesarenotresponsibleforandexpresslydisclaimallwarrantiesofanykindwithrespecttothird-partycontent,products,andservices.
OracleCorporationanditsaffiliateswillnotberesponsibleforanyloss,costs,ordamagesincurredduetoyouraccesstooruseofthird-partycontent,products,orservices.
LegalNotices