Project : Athena Essbase Administration Services installation PPD-PROD environment
Monoprix Page 1 / 27
Monoprix Athena Project Essbase Administration Services installation PPD-PROD Environment Hyperion System 9.3.1.0
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Page 1 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment
Monoprix Page 2 / 27
Global documentation information Modification historic Date
version
author(s)
16/06/2008
V 1.0
Olivier ROCHON
Approval by
remarks initial version
Diffusion Company
Name
email
Hyperion
olivier rochon
[email protected]
Hyperion
Henri Baudou
[email protected]
Support
Related Documents Reference
Version 1.0
Version
Title
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Page 2 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment
Monoprix Page 3 / 27
Content 1 OBJECTIVES.................................................................................. 5 2 REQUIREMENT..............................................................................6 2.1 GENERAL REQUIREMENTS......................................................................................................6 3 INSTALLATION.............................................................................7 3.1 EAS 9.3.1 PACKAGE INSTALLATION.......................................................................................7 3.1.1 Launch Setup.....................................................................................................................7 3.1.2 Setup choices.....................................................................................................................7 3.1.3 Setup result........................................................................................................................8 3.2 PATCH EAS 9.3.1.0 WITH HBR 9.3.1.1.3.........................................................................11 3.2.1 patch eas.ear ...................................................................................................................11 3.2.2 replace easserverplugin.jar..............................................................................................11 3.2.3 replace easclientplugin.jar and CmdLnLauncher.jar......................................................11 3.2.4 copy IdentityMigration.jar and MigrateIdentities.bat....................................................11 3.3 PATCH EAS 9.3.1.1.3 WITH CSS 9.3.1.0.3.....................................................................12 3.3.1 replace css9.3.1.jar ........................................................................................................12 3.3.2 patch eas.ear.93113 with CSS 93103 .............................................................................12 4 CONFIGURATION........................................................................13 4.1 EAS CONFIGURATION........................................................................................................13 4.1.1 Launch configuration tool...............................................................................................13 4.1.2 Product choice ................................................................................................................13 4.1.3 configuration choice........................................................................................................13 4.1.4 Registration into shared Services....................................................................................14 4.1.5 Database configuration...................................................................................................14 4.1.6 Resuse database during the configuration on server n°2................................................15 4.1.7 J2EE Configuration.........................................................................................................15 4.1.8 Configuration result........................................................................................................16 4.2 FINALIZE THE CONFIGURATION...............................................................................................18 4.2.1 Change BEA configuration for AAS..............................................................................18 4.2.2 Externalise EAS security into Shared Services...............................................................19 4.2.3 Externalise Essbase security into Shared Services.........................................................25 5 TEST INSTALLATION.................................................................... 27
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Page 3 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Monoprix Page 4 / 27
Page 4 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment
Monoprix Page 5 / 27
1 Objectives The purpose of this document is to list all steps for the Essbase Administration Services installation on PPDPROD environment of the company Monoprix for the Athena project. This document don't replace the official installation documentation. But it define all specific configurations done for the customer.
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Page 5 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment
Monoprix Page 6 / 27
2 Requirement 2.1 General requirements –
This product will be installed on : [Web1]
PREPROD hm001w81 PROD – –
[Web2] hm001w82
hm001w70 hm001w71
account DOM_SMB\SRVHYPERION DOM_SMB\SRVHYPERIONPRD
HYPERION_HOME will be : E:\sysapp\Hyperion EAS HOME will be : E:\sysapp\Hyperion\EAS
Use TSE in console mode mstsc /console – Remove user variables TMP and TEMP
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Page 6 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment
Monoprix Page 7 / 27
3 Installation 3.1 EAS 9.3.1 Package installation 3.1.1 Launch Setup cd /d F:\_SourceHyperion\02EAS\eas_9310_win32_V1118701 setup.exe console
3.1.2 Setup choices ... Please select the HYPERION_HOME folder.. Select the Hyperion Home directory: E:\sysapp\Hyperion Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1] Essbase Administration Services Install Location Please specify a directory or press Enter to accept the default directory. Directory Name: [E:\sysapp\Hyperion\AnalyticAdministrationServices] E:\sysapp\Hyperion\EAS Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1] Choose the setup type that best suits your needs. [X] 1 Typical The program will be installed with the suggested configuration. Recommended for most users. [ ] 2 Custom The program will be installed with the features you choose. Recommended for advanced users. To select an item enter its number, or 0 when you are finished: [0] Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1] Select ESSLANG value: [ ] 1 Arabic (ISO88596)
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Page 7 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment
Monoprix Page 8 / 27
[ ] 2 Arabic (MS1256) [ ] 3 Croation (ISO88592) [ ] 4 Croation (MS1250) [ ] 5 CyrillicSerbian (ISO88595) [ ] 6 CyrillicSerbian (MS1251) [ ] 7 Czeck (ISO88592) [ ] 8 Czeck (MS1250) [ ] 9 Danish (Latin1) [ ] 10 Danish (ISO885915) [ ] 11 Danish (IBM500) [ ] 12 Danish (MS1252) [ ] 13 Dutch (Latin1) [ ] 14 Dutch (IBM037) [ ] 15 Dutch (IBM500) [ ] 16 Dutch (ISO885915) [ ] 17 Dutch (MS1252) [ ] 18 English (USASCII) [ ] 19 English (IBM037) [ ] 20 English (IBM285) [ ] 21 English (IBM500) [ ] 22 English (Latin1) [X] 23 English (MS1252) ... To select an item enter its number, or 0 when you are finished: [0] Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1]
3.1.3 Setup result Essbase Administration Services will be installed in the following location: E:\sysapp\Hyperion\EAS with the following features: Essbase Administration Services Server Console SAP Plugin for a total size: 362 MB Press 1 for Next, 2 for Previous, 3 to Cancel or 4 to Redisplay [1] Installing $L(com.hyperion.eas.i18n.ProductResources, suite.displayName). Please wait...
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Page 8 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment
Monoprix Page 9 / 27
||||| 0% 25% 50% 75% 100% |||||||||||||||||||||||||||||||||||||||||| 1. Yes 2. Yes to All 3. No 4. No to All C:\WINDOWS\system32\msvcp71.dll exists on this system and is newer than the file being installed. Do you want to replace this file? [3]
||||| 0% 25% 50% 75% 100% |||||||||||||||||||||||||||||||||||||||||| 1. Yes 2. Yes to All 3. No 4. No to All C:\WINDOWS\system32\msvcr71.dll exists on this system and is newer than the file being installed. Do you want to replace this file? [3]
||||| 0% 25% 50% 75% 100% ||||||||||||||||||||||||||||||||||||||||||||||||||
Installing Essbase Administration Services. Please wait... Creating uninstaller... Extracting files from archive(s) Jun 2, 2008 5:30:12 PM com.hyperion.cis.ExpandArchives execute WARNING: The work folder exists. Make sure that it is empty. Extracting files from archive(s) Extracting files from archive(s) Extracting files from archive(s) Extracting files from archive(s)
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Page 9 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment
Monoprix Page 10 / 27
Jun 2, 2008 5:30:26 PM com.hyperion.cis.ExpandArchives execute WARNING: The work folder exists. Make sure that it is empty. Extracting files from archive(s) Jun 2, 2008 5:30:26 PM com.hyperion.cis.ExpandArchives execute WARNING: The work folder exists. Make sure that it is empty. Jun 2, 2008 5:30:26 PM com.hyperion.cis.ExpandArchives execute SEVERE: An exception while extracting the archives. The message is: java.io.FileNotFoundException: E:\sysapp\Hyperion\EAS\console\lib\JGo.jar (Access is denied) The system cannot find the file specified. The system cannot find the file specified. Would you like to launch the configuration tool now ? [ ] 1 Launch configuration tool To select an item enter its number, or 0 when you are finished: [0]
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Page 10 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment
Monoprix Page 11 / 27
3.2 Patch EAS 9.3.1.0 with HBR 9.3.1.1.3 3.2.1 patch eas.ear –
the file "eas.ear" has been ever patched like the doc "hp_93113_readme.pdf"
cd /d E:\sysapp\Hyperion\EAS\AppServer\InstallableApps\Common ren eas.ear eas.ear.9310 cd /d F:\_SourceHyperion\02EAS\hp_hbr_93113 copy eas.ear E:\sysapp\Hyperion\EAS\AppServer\InstallableApps\Common\eas.ear.93113 cd /d E:\sysapp\Hyperion\EAS\AppServer\InstallableApps\Common copy eas.ear.93113 eas.ear
3.2.2 replace easserverplugin.jar cd /d E:\sysapp\Hyperion\EAS\server\lib ren easserverplugin.jar easserverplugin.jar.9310 cd /d F:\_SourceHyperion\02EAS\hp_hbr_93113 copy easserverplugin.jar E:\sysapp\Hyperion\EAS\server\lib
3.2.3 replace easclientplugin.jar and CmdLnLauncher.jar cd /d E:\sysapp\Hyperion\EAS\console\lib ren easclientplugin.jar easclientplugin.jar.9310 ren CmdLnLauncher.jar CmdLnLauncher.jar.9310 cd /d F:\_SourceHyperion\02EAS\hp_hbr_93113 copy easclientplugin.jar E:\sysapp\Hyperion\EAS\console\lib copy CmdLnLauncher.jar E:\sysapp\Hyperion\EAS\console\lib
3.2.4 copy IdentityMigration.jar and MigrateIdentities.bat cd /d F:\_SourceHyperion\02EAS\hp_hbr_93113 copy IdentityMigration.jar E:\sysapp\Hyperion\EAS\console\lib copy MigrateIdentities.bat E:\sysapp\Hyperion\EAS\console\bin
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Page 11 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment
Monoprix Page 12 / 27
3.3 Patch EAS 9.3.1.1.3 with CSS 9.3.1.0.3 3.3.1 replace css9.3.1.jar cd /d E:\sysapp\Hyperion\common\CSS\9.3.1\lib ren css9_3_1.jar css9_3_1.jar.9310 cd /d F:\_SourceHyperion\01HSS\hss_931003_en copy css9_3_1.jar E:\sysapp\Hyperion\common\CSS\9.3.1\lib
3.3.2 patch eas.ear.93113 with CSS 93103 the file "eas.ear" come from eas.93113 nad has been ever patched like the doc "hss_93103_readme.pdf" cd /d F:\_SourceHyperion\02EAS\eas_93113_with_CSS_93103 copy eas.ear E:\sysapp\Hyperion\EAS\AppServer\InstallableApps\Common\eas.93113_CSS93103 cd /d E:\sysapp\Hyperion\EAS\AppServer\InstallableApps\Common copy eas.93113_CSS93103 eas.ear
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Page 12 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment
Monoprix Page 13 / 27
4 Configuration 4.1 EAS configuration 4.1.1 Launch configuration tool cd /d %HYPERION_HOME%\common\config configtool.bat console
4.1.2 Product choice Select the products to configure: [ ] 1 (Configured) Hyperion Reporting and Analysis (E:\sysapp\Hyperion\BIPlus) [X] 2 (Pending) Essbase Administration Services (E:\sysapp\Hyperion\EAS ) [ ] 3 (Configured) Hyperion System 9 Financial Management (E:\sysapp\Hyperion\HFM ) [ ] 4 (Configured) [Foundation]Hyperion Shared Services (E:\sysapp\Hyperion\SharedServices\9.3.1 ) To select an item enter its number, or 0 when you are finished: [0]
4.1.3 configuration choice Select the configuration tasks for the products you selected on the previous screen: Essbase Administration Services [1] (E:\sysapp\Hyperion\EAS) [X] 1 (Pending) Configure Database [X] 2 (Pending) Register with Shared Services [X] 3 (Pending) Deploy to Application Server To select an item enter its number, or 0 when you are finished: [0] Press 1 for Next, 2 for Previous, 3 to Cancel or 5 to Redisplay [1]
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Page 13 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment
Monoprix Page 14 / 27
4.1.4 Registration into shared Services Enter the location of Hyperion Shared Services. Server [hm001w81.monoprix.lan] hyperionppdhss.monoprix.lan (PPD) hyperionprodhss.monoprix.lan (PROD) Port [58080] User [admin] Password ***** [ ] 1 SSL To select an item enter its number, or 0 when you are finished: [0]
4.1.5 Database configuration Select the database: [ ] 1 IBM DB2 [ ] 2 Microsoft SQL Server [X] 3 Oracle To select an item enter its number, or 0 when you are finished: [0] Press 1 for Next, 2 for Previous, 3 to Cancel or 5 to Redisplay [1] Database Configuration Details Database type :Oracle Server: : [hm001w68.monoprix.lan] hm001x82.monoprix.lan (PPD) hm001x72.monoprix.lan (PROD) Port: : [1521] Product :Essbase Administration Services (E:\sysapp\Hyperion\EAS) SID : [] HYPRHFM1 (PPD) HYPPHFM1 (PROD) User Name : [] AAS Password : ***** Data Tablespace : [] D1S_AAS_T001 Index Tablespace : [] I1S_AAS_T001 Press 1 for Next, 2 for Previous, 3 to Cancel or 5 to Redisplay [1] HBR Configuration has not been initialized. Make sure you have logged in sucessf ully and there are no exceptions in the HBR log file.
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Page 14 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment
Monoprix Page 15 / 27
ConfigurationManager not available
4.1.6 Resuse database during the configuration on server n°2 Note : On WEB2, reuse the database 1. Drop all tables and create a new repository 2. Reuse the existing repository 3. Cancel An existing database was detected. Select one of the available options. [3] 2
4.1.7 J2EE Configuration Select the application server: [ ] 1 Apache Tomcat 5 [ ] 2 BEA WebLogic 8 [X] 3 BEA WebLogic 9 [ ] 4 IBM WebSphere 6 To select an item enter its number, or 0 when you are finished: [0] Manual Deployment : [false] Press 1 for Next, 2 for Previous, 3 to Cancel or 5 to Redisplay [1] Application Server: BEA WebLogic 9 Domain: WebLogic9 Location:: [C:\bea\weblogic91] E:\sysapp\bea\weblogic92 Deploy as a service: [true] Component: aas Server Name: [aas] Port: [10080] Press 1 for Next, 2 for Previous, 3 to Cancel or 5 to Redisplay [1]
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Page 15 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment
Monoprix Page 16 / 27
4.1.8 Configuration result The Configuration Utility has collected all required information to proceed. The following tasks will be executed: PRODUCT: Essbase Administration Services (E:\sysapp\Hyperion\EAS) Configure Database Deploy to Application Server Register with Shared Services Press 1 for Next, 2 for Previous, 3 to Cancel or 5 to Redisplay [1] Starting WebLogic 9 Admin server... Database configuration may take several minutes... Configuring database for Essbase Administration Services (E:\sysapp\Hyperion\EAS)... HBR Home : E:\sysapp\Hyperion\EAS Registering product(s) with Hyperion Shared Services EasHubConfigurator constructed. HubRegistration: getProductsList() HubRegistration: getAppsList() HBR Home : E:\sysapp\Hyperion\EAS EAS HOME is E:\sysapp\Hyperion\EAS HUB HOME is E:\sysapp\Hyperion\EAS\server server_name is hm001w68.monoprix.lan port_number is 58080 EAS HOME is E:\sysapp\Hyperion\EAS CSS HOME is E:\sysapp\Hyperion\EAS\server Application server deployment may take several minutes... Deploying web component(s) for Essbase Administration Services (E:\sysapp\Hyperion\EAS)... Stopping WebLogic 9 Admin server... The following configuration tasks have been completed: PRODUCT: Essbase Administration Services (E:\sysapp\Hyperion\EAS)
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Page 16 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment
Monoprix Page 17 / 27
Shared Service Registration: Succeeded Application Server Deployment: Succeeded DB Deployment: Succeeded Press 1 for Next, 3 to Cancel or 5 to Redisplay [1]
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Page 17 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment
Monoprix Page 18 / 27
4.2 Finalize the configuration 4.2.1 Change BEA configuration for AAS –
Into [HKLM\SOFTWARE\Hyperion Solutions\aas\HyS9AAS]
–
Define stdin and stdout logs :
–
–
"SysErrFile"="F:\\prodexpl\\log\\bea\\aas_stderr.log"
–
"SysOutFile"="F:\\prodexpl\\log\\bea\\aas_stdout.log"
Change URL admin server : form 7001 to 7002 –
–
"JVMOption4"="Dweblogic.management.server=http://localhost:7002"
Increase max heap to 512 Mo –
"JVMOption11" = "XmX512m"
Windows Registry Editor Version 5.00 [HKEY_LOCAL_MACHINE\SOFTWARE\Hyperion Solutions\aas\HyS9AAS] "JVMOption4"="Dweblogic.management.server=http://localhost:7002" "JVMOption11"="Xmx512m" "SysErrFile"="F:\\prodexpl\\log\\bea\\aas_stderr.log" "SysOutFile"="F:\\prodexpl\\log\\bea\\aas_stdout.log
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Page 18 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment
Monoprix Page 19 / 27
4.2.2 Externalise EAS security into Shared Services –
To be able to desgin HBR on planning, we must externalize the EAS sécurity into shared Services.
–
Step 1 : Give « HBR administrator » rôle to « admin » account » with HSS
–
Step 2 : Refresh HBR Security into EAS Console
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Page 19 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment –
Monoprix Page 20 / 27
Step 3 : Externalize EAS security –
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Page 20 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Monoprix Page 21 / 27
Page 21 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Monoprix Page 22 / 27
Page 22 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Monoprix Page 23 / 27
Page 23 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment
–
Monoprix Page 24 / 27
Step 3 : TEST HBR login
Rerun eacconsole AND CHECK that « HBR is Successfull login »
Update « storage » folder between 2 web Server ...
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Page 24 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment
Monoprix Page 25 / 27
4.2.3 Externalise Essbase security into Shared Services –
This step the not necessary be can be done later !!
–
Step 1 : Select the Security, clickright « Externalize users « –
Keep the name and port of AAS server
–
Select the « Password » method, and reenter the password o supervisor
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Page 25 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment
–
–
Monoprix Page 26 / 27
Step 2 : provision “admin” account like Essbase Administrator –
login into “Shared Services”
–
Select the native user “admin”, then clickright to “provision” right :
−
Analytic Server: hyperionrecesb1 : Profile Manager and Administrator
Step 3 : Refresh provisioned users from “Shared Services” into Essbase security file –
Execute EAS Java console with « admin / « *****»
–
Select the Essbase Server :
–
Select « Security », then clickright « Refresh Security from Shared Services »
–
Step 4 : Verify the Essbase refresh operation
−
To verify the user list, execute “essmsh” command
login supervisor '*****' on localhost; display user all;
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Page 26 / 27
Project : Athena Essbase Administration Services installation PPD-PROD environment
Monoprix Page 27 / 27
5 Test installation –
start AAS : net start HyS9aas
–
Test URL :
http://localhost:10080/easdocs/eas_infomap.htm http://localhost:10080/easconsole/easconsole.jnlp http://localhost:10080/hbrlauncher/
Version 1.0
reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt
Page 27 / 27
