2017062820PM-SMC Standalone Setup for HCM

SMC high level overview

HcmCore and Coresetup are merged into EarHcmUIApp
All the service endpoints (e.g TransactionService, Jobservice etc) are deployed in EarHcmServiceApp
All the project jars (model/Ui) will be placed in below paths (under $AVR/fusionapps/hcm/sharedlibs/) based on the project type set on your jpr file.
1. oracle.apps.fa.model.ear (All the model jars)
2. oracle.apps.fa.view.war (All the Ui jars)
3. oracle.apps.fa.rpx.model.war (If the jar name starts with "AdfJarREST" then those Jars are copied to RPX Shared Library)
4. oracle.apps.fatp.model.ear (All the 3rd party dependent jars)
5. oracle.apps.fatp.view.war(All the 3rd party dependent jars)
Pre deployment EAR file will be created on $AVR/fusionapps/consolidateApps
All the deployed ear's will be on $MW_HOME_STANDALONE/user_projects/domains/fusion_domain/servers/AdminServer/upload directory. Note that it won't be exploded directory , it will be compressed Ear/War file

Step 1: Prepare the environment

Create a new view on clean Bronze label - Since the shared libs are view specific , make sure to create separate view only for deployment related activities
identify a DB to connect. If you are creating your own zip DB , please follow the steps on ZipDBCreationSteps.doc
Open .cshrc file in your home directory and check for ADE_SKIP_HARDCODED_EXPANDS, make sure the value is set to 0
Run the command - > ade expand $AVR/fusionapps/ -recurse
cp $ADE_VIEW_ROOT/fatools/tools/wlsconfig/fadev/ps7st/fusion_apps_wls.properties $HOME
Modify properties in $HOME/fusion_apps_wls.properties
    Comment out below line
       #ldapSvr=adc60061fems.us.oracle.com:4612:cn=wlsproxyuser,cn=users,dc=us,dc=oracle,dc=com:welcome1:st2_d8b3
   Modify below properties
       domainType=adminall
       domainName=fusion_domain
       wlName=<wls_admin_username>
       wlPassword=<wls_admin_password>
       listenPort=<admin_port> (Ex: 7011)
       ESSrunTime=no
       familyName=HCM
       dbConnection= (host:port:SID)

Step 2: Configure weblogic server

cd $ADE_VIEW_ROOT/fatools/tools/wlsconfig
sh ./wlsconfig.sh -p $HOME/fusion_apps_wls.properties
Start the weblogic server - > $MW_HOME_STANDALONE/user_projects/domains/fusion_domain/startWebLogic.sh –Xmx4096m –Xms1024m
Import users : Go to WLS console -> security realms -> My realm -> providers -> Default Authenticator -> Migration -> Import -> upload Ldift file -> Choose /net/slc05cvh/scratch/repo/ldift/R13/WLS_Users_and_Groups.ldift for the ldift path.

Step 3: Register environment

This is one time process to register your environment in fre. All the subsequent deployments will be using this environment id
Login to http://fre.us.oracle.com:7777/cgi-bin/freDem using your bug db account and create new environment
Provide a unique Env Name (alias Env ID) and provide the details as highlighted below. Make sure domain(1) is unchecked, also make sure to include http:// in the weblogicadminurl.
Select the 'FABUILDTOOLS_PT.V2MIB_LINUX for 'Label Series'
Click on create
cd to $ADE_VIEW_ROOT, and run the command ant uploadDomainConfig -Denvid= (generated from above steps)

Step 4: Generate manifest

cd $ADE_VIEW_ROOT/fusionapps/hcm/
ant -f build-core.xml sharedlib
ant -f build-coresetup.xml sharedlib
Manifest files will be generated in the directory:fusionapps/hcm/deploy. (Verify its created)
Manifest files should be generated before proceeding with the next step. Basically this will have list of jar files that needs to be deployed on fa.model and fa.view

Step 5: Generate Ear for deploy

cd $ADE_VIEW_ROOT/fusionapps
ant -DearsToDeploy=EarHcmCore,EarHcmCoreSetup -DskipMergeJars=true generateAppForLocalDeploy
Note : This will create shared libraries and pillar apps (Service, UI and ESS) for selected Ear profiles. The location of these generated artifacts as is as below

Shared Libraries Manifest File : $ADE_VIEW_ROOT/fusionapps/hcm/deploy/__SharedLibManifest.xml

   Shared Libraries : $ADE_VIEW_ROOT/fusionapps/sharedLibs/deploy/

   Pillar Consolidated Apps : $ADE_VIEW_ROOT/fusionapps/consolidatedApps/
    The Shared Libraries and Pillar Apps will deleted and recreated every time when you run the target generateAppForLocalDeploy.
Copy jazn-data.xml - > cp $ADE_VIEW_ROOT/fusionapps/hcm/components/hcmCore/src/META-INF/jazn-data.x* $ADE_VIEW_ROOT/fusionapps/consolidatedApps/EarHcmUIApp.ear/META-INF/
Modify policy store entry - > $ADE_VIEW_ROOT/fusionapps/consolidatedApps/EarHcmServiceApp.ear/META-INF/weblogic-application.xml and $ADE_VIEW_ROOT/fusionapps/consolidatedApps/EarHcmUIApp.ear/META-INF/weblogic-application.xml
jps.policystore.migration

MERGE

Step 6: Deploy HcmUi

setenv ANT_OPTS "-Xms1g -Xmx5g -XX:MaxPermSize=1g"
cp /net/slc12aps/scratch/rnerolu/codeshare/AdfHcmRecCandidateExpJetProtectedModel.jar $AVR/fusionapps/sharedLibs/deploy/oracle.apps.fa.model.ear/APP-INF/lib
cp /net/slc12aps/scratch/rnerolu/codeshare/AdfHcmCompVarCompSetupProtectedModel.jar $AVR/fusionapps/sharedLibs/deploy/oracle.apps.fa.model.ear/APP-INF/lib
cp /net/slc12aps/scratch/rnerolu/codeshare/AdfHcmCompCommonPublicUi.jar $AVR/fusionapps/sharedLibs/deploy/oracle.apps.fa.view.war/WEB-INF/lib
cd $ADE_VIEW_ROOT/fusionapps/
ant -Denvid= -DearsToDeploy=EarHcmCore,EarHcmCoreSetup -DskipMergeJars=true -DmergeJazn=true -DskipGenerateApps=true j2eeConsolidatedDeploy (Note that this is only for the first time deployment)

Your application should be deployed in above command. Note that the build output will always be SUCCESSFUL, even if the deployment is failed. Make sure the lines above build output says the deployment is successful

Step 7: Import the root menu

$MW_HOME/oracle_common/common/bin/wlst.sh
connect('weblogic','weblogic1','t3://host:port')
importMetadata(application='EarHcmUIApp',server='AdminServer',fromLocation='/net/slc12aps/scratch/rnerolu/codeshare/',docs='/oracle/apps/menu/root_menu.xml')
importMetadata(application='EarHcmUIApp',server='AdminServer',fromLocation='/net/slc12aps/scratch/rnerolu/codeshare/',docs='/oracle/apps/menu/ResourcesAttrBundle.xlf')

Step 8: Patching the jars

If you have modified some code and want to patch the jars then copy the particular jar file into $AVR/fusionapps/sharedLibs/deploy/oracle.apps.fa.model.ear/APP-INF/lib or $AVR/fusionapps/sharedLibs/deploy/oracle.apps.fa.view.war/WEB-INF/lib depending on model or view project
Run the below command to re deploy the application. Note that DskipGenerateApps will not generate the sharedLibs again, whatever jars in the sharedLibs directory it will just deploy those
ant -Denvid= -DearsToDeploy=EarHcmCore,EarHcmCoreSetup -DskipMergeJars=true -DskipGenerateApps=true j2eeConsolidatedDeploy

Step 9: Re deploying HcmUi

cd $ADE_VIEW_ROOT/fusionapps/hcm
ant -f build-core.xml sharedlib
ant -f build-coresetup.xml sharedlib
cd $ADE_VIEW_ROOT/fusionapps
ant -DearsToDeploy=EarHcmCore,EarHcmCoreSetup -DskipMergeJars=true generateAppForLocalDeploy
ant -Denvid= -DearsToDeploy=EarHcmCore,EarHcmCoreSetup -DskipMergeJars=true -DskipGenerateApps=true j2eeConsolidatedDeploy