Project : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 1 / 27
Monoprix
Athena Project
Essbase Administration Servicesinstallation
PPD-PROD Environment
Hyperion System 9.3.1.0
Version 1.0 reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt Page 1 / 27
Project : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 2 / 27
Global documentation information
Modification historic
Date version author(s) Approval by remarks
16/06/2008 V 1.0 Olivier ROCHON initial version
Diffusion
Company Name email Support
Hyperion olivier rochon [email protected]
Hyperion Henri Baudou [email protected]
Related Documents
Reference Version Title
Version 1.0 reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt Page 2 / 27
Project : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 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 : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 4 / 27
Version 1.0 reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt Page 4 / 27
Project : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 5 / 27
1 ObjectivesThe purpose of this document is to list all steps for the Essbase AdministrationServices 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 : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 6 / 27
2 Requirement
2.1 General requirements– This product will be installed on :
[Web1] [Web2] account
PREPROD hm001w81 hm001w82 DOM_SMB\SRVHYPERION
PROD hm001w70 hm001w71 DOM_SMB\SRVHYPERIONPRD
– HYPERION_HOME will be : E:\sysapp\Hyperion– EAS HOME will be : E:\sysapp\Hyperion\EAS
Use TSE in console modemstsc /console– Remove user variables TMP and TEMP
Version 1.0 reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt Page 6 / 27
Project : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 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_V1118701setup.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 : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 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 : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 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 thefile 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 thefile 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 executeWARNING: 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 : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 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 : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 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\Commonren eas.ear eas.ear.9310
cd /d F:\_SourceHyperion\02EAS\hp_hbr_93113copy eas.ear E:\sysapp\Hyperion\EAS\AppServer\InstallableApps\Common\eas.ear.93113
cd /d E:\sysapp\Hyperion\EAS\AppServer\InstallableApps\Commoncopy eas.ear.93113 eas.ear
3.2.2 replace easserverplugin.jar
cd /d E:\sysapp\Hyperion\EAS\server\libren easserverplugin.jar easserverplugin.jar.9310
cd /d F:\_SourceHyperion\02EAS\hp_hbr_93113copy easserverplugin.jar E:\sysapp\Hyperion\EAS\server\lib
3.2.3 replace easclientplugin.jar and CmdLnLauncher.jar
cd /d E:\sysapp\Hyperion\EAS\console\libren easclientplugin.jar easclientplugin.jar.9310ren CmdLnLauncher.jar CmdLnLauncher.jar.9310
cd /d F:\_SourceHyperion\02EAS\hp_hbr_93113copy easclientplugin.jar E:\sysapp\Hyperion\EAS\console\libcopy CmdLnLauncher.jar E:\sysapp\Hyperion\EAS\console\lib
3.2.4 copy IdentityMigration.jar and MigrateIdentities.bat
cd /d F:\_SourceHyperion\02EAS\hp_hbr_93113copy IdentityMigration.jar E:\sysapp\Hyperion\EAS\console\libcopy MigrateIdentities.bat E:\sysapp\Hyperion\EAS\console\bin
Version 1.0 reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt Page 11 / 27
Project : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 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\libren css9_3_1.jar css9_3_1.jar.9310
cd /d F:\_SourceHyperion\01HSS\hss_931003_encopy 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_93103copy eas.ear E:\sysapp\Hyperion\EAS\AppServer\InstallableApps\Common\eas.93113_CSS93103
cd /d E:\sysapp\Hyperion\EAS\AppServer\InstallableApps\Commoncopy eas.93113_CSS93103 eas.ear
Version 1.0 reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt Page 12 / 27
Project : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 13 / 27
4 Configuration
4.1 EAS configuration
4.1.1 Launch configuration tool
cd /d %HYPERION_HOME%\common\configconfigtool.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 previousscreen:
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 : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 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 : [<default>] D1S_AAS_T001 Index Tablespace : [<default>] 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 sucessfully and there are no exceptions in the HBR log file.
Version 1.0 reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt Page 14 / 27
Project : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 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 : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 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 ServicesEasHubConfigurator constructed.HubRegistration: getProductsList()HubRegistration: getAppsList()HBR Home : E:\sysapp\Hyperion\EASEAS HOME is E:\sysapp\Hyperion\EASHUB HOME is E:\sysapp\Hyperion\EAS\serverserver_name is hm001w68.monoprix.lanport_number is 58080EAS HOME is E:\sysapp\Hyperion\EASCSS 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 : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 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 : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 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 : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 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 : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 20 / 27
– Step 3 : Externalize EAS security
–
Version 1.0 reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt Page 20 / 27
Project : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 21 / 27
Version 1.0 reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt Page 21 / 27
Project : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 22 / 27
Version 1.0 reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt Page 22 / 27
Project : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 23 / 27
Version 1.0 reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt Page 23 / 27
Project : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 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 : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 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 : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 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 : AthenaEssbase Administration Services
installationPPD-PROD environment
MonoprixPage 27 / 27
5 Test installation
– start AAS : net start HyS9aas
– Test URL :
http://localhost:10080/easdocs/eas_infomap.htmhttp://localhost:10080/easconsole/easconsole.jnlphttp://localhost:10080/hbrlauncher/
Version 1.0 reference : MonoprixPROD11Sys9310EASEssbaseAdministrationinstall.odt Page 27 / 27