
<p> .</p><p>Analytics on AIX server Installation Guide</p><p>[Siebel Business Analytics Platform 7.8.5.1]</p><p>Date: 16 January 2007 </p><p>------</p><p>Siebel Analytics version: Analytics 7.8.5.1 platform Siebel Analytics Server OS: AIX 5.3</p><p>Database version: Oracle 10g release 2 Database Server OS: AIX 5.3</p><p>Web Server OS: IBM Web sphere Application Server 5.1 / IBM HTTP Server 2.0.47 Siebel Analytics Administration Tools OS: Windows Server 2000 SP4</p><p>Web Client version: Internet explorer 6.0.2900</p><p>------Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>INTRODUCTION...... 4</p><p>DOCUMENT PURPOSE...... 4 DOCUMENT CONTEXT...... 4 SIEBEL ANALYTICS DESCRIPTION...... 8 SIEBEL ANALYTICS ARCHITECTURE...... 8 PREREQUISITES...... 11</p><p>HARDWARE REQUIREMENTS...... 11 CLIENT ENVIRONMENT REQUIREMENTS...... 11 SERVER ENVIRONMENT REQUIREMENT...... 11 WEB SERVER REQUIREMENT...... 11 DATABASE REQUIREMENT...... 12 SIEBEL ANALYTICS REQUIREMENT...... 12 PREPARING INSTALLATION...... 13</p><p>AIX TASKS...... 13 WEB SERVER TASKS...... 15 WAS 5.1 Installation Steps...... 16 IHS 2.0.47.1 Installation Steps...... 23 LICENSE TASKS...... 27 JAVA TASKS...... 27 DATABASE TASKS...... 28 SIEBEL ANALYTICS TASKS...... 29 INSTALLATION STEPS...... 30</p><p>FIRST STEP...... 30 “DO NOT FORGET” STEPS...... 31 RUN STEPS...... 33 CHECKING INSTALLATION LOGS STEP...... 40 POST INSTALLATION STEPS...... 41</p><p>FIRST THINGS TO DO...... 41 CREATING AND TRANSFERRING ANALYTICS REPOSITORY...... 43 Siebel Analytics Administration Tool Installation...... 43 Creating Siebel Analytics Repository...... 47 Transferring Siebel Analytics Repository...... 48 STARTING ANALYTICS SERVER...... 49 UPDATING CONFIGURATION SETTINGS...... 52 TARGET DATABASE SETTINGS...... 52 TESTING ANALYTICS CLIENT INSTALLATION...... 53 STARTING ANALYTICS WEB SERVER...... 56 About Siebel Analytics Web Server...... 56 Configuring Analytics Web Plan...... 56 Creating a news Web Archive (war file)...... 57 Deploying the Web Archive file...... 57 Update the web server plug-in...... 64 Restart Web sphere server...... 65 Restart Siebel Analytics server and Web server...... 65 STARTING BROWSER CLIENT TO TEST INSTALLATION...... 66 Launch a supported browser client...... 66 POSSIBLE ERRORS...... 67 Oracle driver not found in answers...... 67 Chart graphics display in Dashboard doesn’t work...... 68 Refresh link in Dashboard doesn’t work...... 70 APPENDIX...... 71 How to customize user interface...... 71 How to insert auto-refresh functionality in Siebel Dashboard...... 74 Analytics Useful Folders and Files Structure...... 75</p><p>2/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Introduction </p><p>Document Purpose</p><p>The goal of this document is to explain all different steps mandatory to success Siebel Analytics 7.8.5.1 installation on IBM AIX 5.3 server (IBM p520 machine). This paper will also provide you a guide through installation steps to help you to understand all different components necessary and its functionalities.</p><p>At the end of this documentation, you should be able to better understand Siebel Analytics Installation tasks and architecture and be able to use Siebel Analytics Intelligence Dashboards.</p><p>Reader must be aware that he can not find any information about Siebel Analytics Administration or performance customizations.</p><p>Document Context</p><p>In this document, we are using the following hardware configuration:</p><p> 1 IBM power5 logical partition (LPAR) on one IBM p520 machine for all Analytics Servers 2 IBM power5 logical partitions on another IBM p520 machine for Oracle Database part (oracle 10g R2 RAC) IBM Fast Storage </p><p>We are also using the following software components:</p><p> Siebel Analytics 7.8.5.1 servers (web server and server) Oracle Database 10gR2 Real Application Cluster Web sphere Application Server 5.1 Fix Pack1 AIX 5.3 L Java Runtime Environment 1.4.2</p><p>You are going to find 3 architecture schemas summarizing the previous descriptions.</p><p>3/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>First, the following schema will show you hardware and network quick description:</p><p>Siebel Analytics 7.8.5.1 servers</p><p>Logical Partition: Node12</p><p>IBM P520</p><p>Network</p><p>Oracle 10gR2 RAC</p><p>Logical Partition 1: Logical Partition 2: SHARK BALI</p><p>IBM P520</p><p>ASM</p><p>4/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Then, this schema will show you component architecture quick description:</p><p>NB: Oracle BI EE means Oracle Business Intelligence Enterprise Edition, the new name of Siebel Analytics In this square the following initials mean:</p><p> W.S = web server, in other word Web sphere Application Server P.S = Presentation Server (former Siebel Analytics Web Server) BIS = BI Server (former Siebel Analytics Server)</p><p>5/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>To finish, this schema will show you oracle database functional overview description:</p><p>6/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Siebel Analytics description</p><p>Siebel Business Analytics is a Business Intelligence tool helping decision makers to analyze enterprise data and take right decisions. It is composed by 2 main components: </p><p> Siebel Analytics Server Siebel Analytics Web Server</p><p>Siebel Analytics Server is the core server behind Siebel Analytics. It provides the power behind Siebel Dashboards (web-displayed Reports) for access and analysis of structured data. It allows a single information request (for reports for example) to query multiple data source.</p><p>Siebel Analytics Web Server is the core server behind HTML pages viewed by users. It provides the formatting and presentation of Siebel Dashboards (web-displayed Reports). Siebel Analytics presents a lot of reports (table, chart, pivot and so on …) to web users.</p><p>You can install Siebel Analytics in stand-alone mode (now called “platform”) or install Siebel Analytics integrated into Siebel CRM application (now called “application”).</p><p>Siebel Analytics architecture</p><p>The following architecture schema will give you more details about Siebel Components organization and how it is working:</p><p>7/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>8/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>9/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Prerequisites </p><p>Hardware Requirements</p><p>For Siebel Analytics Server components:</p><p>CPU: 800 MHz RAM: 2 GB Disk: 2GB + disk space for cache storage</p><p>For Siebel Analytics Web Server components:</p><p>CPU: 800 MHz RAM: 2 GB Disk: 2GB + disk space for cache storage</p><p>Client Environment Requirements</p><p>Siebel Analytics supports the following Web browsers:</p><p>Internet Explorer 6.0+ with Windows 2000 Pro SP3 Internet Explorer 6.0+ with Windows XP SP1 or above Mozilla 1.7x with Sun Solaris 9, 10 Fire fox 1.0.x and Netscape 7.2.x on all 3 OS above</p><p>Server Environment Requirement</p><p>In this documentation, Server Operating System is AIX v5L (5.3)</p><p>Web Server Requirement</p><p>Web sphere Application Server 5.1 FP1 (and IHS 2.0.47) with Java JRE 1.4.2</p><p>10/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Database Requirement</p><p>In this documentation, Database Server is Oracle 10g R2 and Database Server Operating System is AIX v5L (5.3)</p><p>Siebel Analytics Requirement</p><p>Product we are going to install, is Oracle Business Intelligence Enterprise Edition and Siebel Analytics Platform version 7.8.5.1 UNIX programs</p><p>11/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Preparing installation </p><p>AIX Tasks</p><p>The following tasks should be completed before installing Siebel Analytics software under AIX:</p><p>1. If you are planning to run the AIX installation remotely, or on a PC-based machine, install third-party X window software (for graphic mode install)</p><p> a. Create a VNC desktop, by running VNC server</p><p> b. Connect to this virtual VNC desktop with VNC viewer</p><p> c. Think about DISPLAY variable</p><p>Export DISPLAY = node12:0 (an example)</p><p>12/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>2. Determine your installation directory and create it if it is necessary (here installation directory will be /Siebel/analytics7851Install)</p><p>Do not forget to change permissions for Siebel user id</p><p>And create 2 sub directories: SiebelAnalytics and SiebelAnalyticsData</p><p>3. Choose a user ID that can run all Siebel Analytics processes (here user is siebel)</p><p>13/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Web Server Tasks</p><p>Before installing Siebel Analytics components (especially Siebel Analytics Web server) you should install web server on AIX (it will be WAS 5.1/IHS 2.0.47).</p><p>To launch WAS5.1 installer, you must execute the following steps:</p><p>1. Setup PATH variable to point to java repository present in WAS install repository</p><p>2. Execute : ./install </p><p>If you got an error: a suitable JVM could not be found</p><p>You can check:</p><p> a. If you are pointing to the right java repository in WAS installing repository</p><p> b. If you have execution permission on this java repository</p><p> c. If you have the right java version in PATH variable (jvm 1.3)</p><p> d. If you have the right PATH variable </p><p> e. If you are able to execute “./launchpad.sh” in WAS installing repository</p><p> f. If you created the right JAVA_HOME variable (excluding “bin” repository in the java path)</p><p>14/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>WAS 5.1 Installation Steps</p><p>15/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>16/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Disable also java doc component and MQ component</p><p>17/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>18/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>19/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>20/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Then install WAS 5.1 fixpack 1 (was 5.1.1) Do not forget to execute “setupCmdLine.sh” in Websphere bin directory</p><p>To finish install WAS 5.1.1 SR 1</p><p>21/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>IHS 2.0.47.1 Installation Steps</p><p>Now we are going to install IBM Http Server v2.0.47 (that’s why we unchecked IHS component in WAS installation). It is not mandatory</p><p>22/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>23/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>24/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>25/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>License Tasks</p><p>Before installation, you should be sure to get right license key and right XML file corresponding to installation file.</p><p>If you don’t have right license keys or you don’t know where you can get these files, go to this following link:</p><p> http://licensecodes.oracle.com/oracle_bi.html</p><p>Java Tasks</p><p>You must install Java Runtime Environment (JRE) (or JDK) 1.4.2 (or above). To determine if JRE (JDK) is already installed on the machine, use the following command:</p><p> Java -version</p><p>If you got no information with this command, you must install a JRE/JDK 1.4.2 (go to sun internet site or other java machine provider)</p><p>26/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Database Tasks</p><p>Before installation, you should be sure to get right Database connection client (it will be oracle database).</p><p>Here it is Oracle client 10g and oracle guys have set up Oracle client under our AIX machine correctly to connect Oracle database.</p><p>For your information, you can read below tsnnames.ora file (oracle connection configuration file):</p><p>27/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Siebel Analytics Tasks</p><p>Before installing Siebel Analytics components, you should know that you will need to install Server Administration Tool (it is a Siebel Analytics Component) on Windows Platform.</p><p>Indeed you will be able to create and configure Siebel Analytics repository file and then you will transfer it on your AIX platform (with FTP tool for instance).</p><p>You will find further in this documentation how to install Siebel Analytics Administration tool. You could install now or later. You have choice but you must keep in mind that you need a windows platform!!!</p><p>28/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Installation Steps </p><p>First Step</p><p>In our example, we are using a tar file containing Siebel Analytics code. So we are obliged to “untar” this file before any steps.</p><p>We execute the following command after transferring tar file (by ftp for example) on target machine:</p><p>After decompressing, we got an AIX repository which is the install repository. All following steps will be based on this requisite.</p><p>29/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>“Do not forget” Steps</p><p>Then you need to not forget following stuffs:</p><p>1. change file and directories permission for all directories and files in Siebel Analytics installation directory (chmod –R a+rwx *)</p><p>2. change OS user (to Siebel user)</p><p>3. export again DISPLAY variable to be able to use graphics mode</p><p> node 9: xhost + (to authorize all client to use node9 X11 server)</p><p> node12: Export DISPLAY=node9:5 (your VNC session display)</p><p>30/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>4. Change PATH variable to point to right java version (from java 1.3 for was to java 1.4.2 for analytics)</p><p>Export PATH=/usr/java14/bin:$PATH</p><p>31/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Run Steps</p><p>To run installer in graphics mode, use the following command in right install (DVD- like) repository:</p><p> Server/Siebel_Analytics_All/setup.sh</p><p>32/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Browse up to find Analytics license key (prerequisite task, see previously)</p><p>33/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>This error could be due to a wrong copy of the license file during transferring this file from windows machine to UNIX machine (for example with ftp software, check you transferred with binary mode)</p><p>After you fix the problem, specify your Siebel Analytics installation path (if you want to change from Siebel default one = /usr/local)</p><p>Choose a custom installation in order to customize our installation</p><p>34/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>35/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>36/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Enter the full path to the directory in which JAVA is installed (equivalent JAVA_HOME). Do not enter “bin” directory in the path</p><p>37/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>38/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Checking installation logs Step</p><p>INSTALLDIR is the absolute path of the Analytics Server installation directory. It is the path you entered in response to the installer prompt (here /Siebel/analytics7851install).</p><p>Check the following file:</p><p> INSTALLDIR/SiebelAnalytics/Log/Install.log</p><p>39/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Post Installation Steps </p><p>First things to do</p><p>Note: Siebel Analytics DOES NOT SUPPORT more than one server instance on the same machine at one time</p><p>First you must determine your shell: execute env command</p><p>We are working with Korn shell.</p><p>You will find below the list of different scripts allowing you to start/stop all Siebel Analytics Servers or Siebel Analytics clients (of course these following commands may change according to the type of shell):</p><p>Note: all of these scripts are located in INSTALLDIR/SiebelAnalytics/setup</p><p>40/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>41/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Creating and Transferring Analytics Repository</p><p>First thing to do is to create your Analytics Repository. To do that you must install Siebel Analytics Administration Tool (ONLY on windows Platform).</p><p>Siebel Analytics Administration Tool Installation</p><p>This Siebel tools is available only on Windows platform</p><p>Enter the right license file</p><p>42/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>43/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>44/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>45/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Creating Siebel Analytics Repository</p><p>Launch Siebel Analytics Administration Tool</p><p>Create a new repository (or use your already created repository)</p><p>You can find below an example of a consistent (correct repository):</p><p>For more information about how to create a repository, you can read:</p><p>Siebel Analytics 7.7.1 Administration Tools First Steps.doc</p><p>46/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Transferring Siebel Analytics Repository</p><p>You must transfer the xxx.rpd file from your windows machine to your UNIX server.</p><p>You can use FTP software as WinSCP our FileZilla.</p><p>Think about binary mode for transfer and about file permissions under UNIX server.</p><p>Edit the following configuration file: NQSConfig.ini</p><p>Do not forget to check if the repository name in NQSConfig.ini is the same as your xxx.rpd file.</p><p>47/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Starting Analytics Server</p><p>Execute the following command:</p><p>Result:</p><p>If you read the log as it is written in standard output, you may see the following error:</p><p> tail -f /usr/local/SiebelAnalytics/Log/NQServer.log</p><p>… 2005-03-08 17:10:13 [47013] NLS locale english-usa is not supported by the operating system. 2005-03-08 17:10:13 [nQSError: 47013] NLS locale english-usa is not supported by the operating system. …</p><p>If you do not have the proper locale installed, the Siebel Analytics server does not start, and the NQSServer.log file contains the following error:</p><p>[47013] NLS locale xxx is not supported by the operating system.</p><p>48/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC where xxx is the locale specified in the NQSConfig.INI file for the SORT_ORDER_LOCALE parameter.</p><p>The response to this error is to install the locale indicated in the table for the requested language.</p><p>So we added additional language support (according to Siebel Service Request: #: 38-1092579421 ).</p><p>It can be done by following:</p><p> UNIX admin instructions:</p><p>SMITTY > System Environment > Manager Language environment > Add additional language env. > Cultural convention > Escape 4 > US-english</p><p>49/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>To test again Siebel Analytics Server, Do not forget TO STOP server:</p><p> $ ./run-sa.sh forcestop</p><p>This will kill all your Main win applications. Are you sure? (Y/n) Y</p><p>Then you can start again Siebel Analytics (sa) server and read the log:</p><p>50/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Updating Configuration Settings</p><p>Execute the following command:</p><p>Target Database Settings</p><p>You must verify the validity of the database setup script, because it is called from Siebel Analytics startup script.</p><p>Edit the file “user.sh” in “setup” directory to include the right environment settings for the database client of your choice (here Oracle):</p><p> uncomment lines for oracle configuration</p><p>51/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Testing Analytics Client Installation</p><p>Run Siebel Analytics Client by opening another session. From the setup directory $INSTALLDIR/setup, run one of the following scripts:</p><p>And then to test the client/server connectivity, run:</p><p>Enter your Database (Oracle here) source name (alias here: ALBBASIC, the same one present in TNSNAME.ora file) identifying your database and Repository user id and password:</p><p>Then you enter user/password id:</p><p>52/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>You may get the following error:</p><p>Solution: You need to provide a correct entry in ODBC.ini file.</p><p>Under UNIX, the file odbc.ini contains the standard Siebel Analytics ODBC connection details that are used by the Siebel Analytics Web Server and nqcmd processes.</p><p>Siebel Analytics Server uses ODBC layer to call OCI (Oracle communication) layer.</p><p>So you must add an ODBC section in odbc.ini file with the same ODBC name as you set up in your ODBC configuration on windows platform when you created your Analytics Repository used on UNIX machine.</p><p>Go to INSTALLDIR/SiebelAnalytics/setup directory and edit odbc.ini file</p><p>Then you add your ODBC section:</p><p>53/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>So you will get the following successful screen with client:</p><p>54/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Starting Analytics Web Server</p><p>About Siebel Analytics Web Server</p><p>SAW server functions as the connection between any user of Siebel Analytics and the processes of the Siebel Analytics Server processes.</p><p>Siebel Analytics Web consists of the SAW server and the Web (pr HTTP) integration server running as separate processes.</p><p> The Analytics Web Server process (sawserver.exe) hosts most of the business logic of Siebel Analytics Web and performs all the functions</p><p> The Web (HTTP) integration server is a J2EE application server that hosts a Java servlet which creates socket connections to Siebel Analytics Web server and uses TCP/IP to redirect HTTP requests to Siebel Analytics Web Server</p><p>Configuring Analytics Web Plan</p><p>After installing Siebel Analytics Web, you must execute the following steps:</p><p>1. Configure a third-party Web Integration server</p><p>2. Create a link to the Siebel Analytics Web server from the third-party Web Server</p><p>55/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Creating a news Web Archive (war file)</p><p>Go to the Siebel Analytics installation directory</p><p>Then execute the following jar command:</p><p>DON’T FORGET the period at the end of the command</p><p>Deploying the Web Archive file</p><p>We are going to deploy the web application contained in the analytics.war file</p><p>Open a web browser and got to http://yourmachine:9090/admin</p><p>56/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Go to application > install new application</p><p>Browse the war file</p><p>57/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Click next</p><p>Click next</p><p>58/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Click continue</p><p>Click next</p><p>Again</p><p>59/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Again</p><p>Click FINISH</p><p>60/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>And then save the configuration</p><p>61/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>62/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Update the web server plug-in</p><p>After the successful deployment the web server plug-in has to be updated, to reflect the new access URL to the application.</p><p>In the WAS console go to Environment Update Web server Plug-in</p><p>Click OK to update</p><p>63/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Restart Web sphere server</p><p>Stop/Start Web Sphere application server</p><p>Restart Siebel Analytics server and Web server</p><p>If they are running, Stop/Start all Siebel Analytics Servers</p><p>64/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Starting Browser Client to test installation</p><p>Launch a supported browser client</p><p>For instance, execute mozilla browser and go to the following URL:</p><p> http://<yourserver>:<port>/<appDirectory></p><p>Where:</p><p> <yourserver> is AIX server where you install all Siebel Analytics Servers <port> is the port where your web server is listening <appDirectory> is the web server directory where you can reach Siebel Analytics</p><p>In our case, enter the following URL:</p><p> http://localhost:9080/web/app</p><p>65/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Possible errors</p><p>Oracle driver not found in answers</p><p>Error:</p><p>After you installed Siebel Analytics, you can get the following errors, launching Siebel Analytics Answers in your client browser:</p><p>Solution: The source of the problem is an incorrect oracle path variable in OS environment. The system could not access right libraries. One path is missing.</p><p>You have probably setup oracle libraries path in “user.sh” file but not in OS environment.</p><p>So put in “.profile” (located in home directory of Siebel user) file the following line:</p><p>66/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Chart graphics display in Dashboard doesn’t work</p><p>Error:</p><p>After you installed Siebel Analytics, you got dashboards page without chart pictures (instead of chart pictures, you got a warning picture)</p><p>Just for your information:</p><p>Siebel Analytics version 7.5.x uses Corda PopChart Image Server version 3.8.3 to display charts in analytics reports.</p><p>The Corda callback method works as follows:</p><p>A browser requests a report with a chart of a certain type.</p><p>Siebel Analytics Web server generates HTML source to display tabular data and embedded commands in the HTML source to display specific charts and sends the HTML response to the browser.</p><p>The browser receives the HTML response and displays the HTML page. The browser also uses the embedded chart commands to issue another call directly to the Corda PopChart server.</p><p>On receiving the browser call, the Corda PopChart server calls back the analytics web server using the information in the embedded URL to get the data needed to create the chart.</p><p>The image server creates the chart image and sends it back to the web browser for the graph image to be displayed.</p><p>The following diagram further demonstrates these steps:</p><p>67/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Solution:</p><p>The source of the problem is an incorrect javahost startup. Your javahost have not started, that’s why your Corda Server have not could generate Analytics Chart.</p><p>If you read javahost log (in SA_INSTALL_DIR/Log), you will probably read the following error:</p><p> Run.sh: Java can be found</p><p>The solution to fix this problem is to put in AIX environment a correct JAVA_HOME to allow javahost service to find java command and then to start.</p><p>Stop Siebel Analytics Web Server and export JAVA_HOME variable. Then restart SAW server.</p><p>68/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>69/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Refresh link in Dashboard doesn’t work</p><p>Error:</p><p>After you installed Siebel Analytics, when you click on refresh link in your Siebel Analytics Intelligence Dashboards, no refresh action happens (no data refresh).</p><p>Solution:</p><p>The source of the problem is a problem of cache. By default, Siebel Analytics Server uses its query cache when you ask it for refresh. You can set up each tables of the repository about caching, but we will use a more general solution: we are going to disable Siebel Analytics Server (queries server) cache. </p><p>To do that, we change cache configuration value in the server configuration file named NQConfig.INI (in directory SA_INSTALL_DIR/Conf)</p><p>70/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Appendix</p><p>How to customize user interface</p><p>You can change Siebel Analytics User Interface Rendering (or Skins). To better understand what we call Skins, let us show you 2 screenshot of the same page: logon page.</p><p>In the first picture we are using Siebel default skin and in the second one we are using the skin that we want to install.</p><p>71/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>User interface rendering is the result of the interaction between style and skin. Style is rendered by a repository named “s_name” and Skin by a repository named “sk_name”</p><p>You must copy these repositories into Siebel Analytics Server web directory and 3rd-party Web server deployment directory.</p><p>So to change rendering, you should follow these steps:</p><p>1. Copy the 2 repositories into SAINSTALLDIR/web/app/Res</p><p>2. Copy the 2 repositories into <3rd-party>/<DEPLOYMENT>/Res</p><p>3. To finish you must specify your new style and skin in configuration file of Siebel Analytics Web Server (instanceconfig.xml)</p><p>72/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Edit this file and insert 2 new entries in the xml file:</p><p>(You don’t need to specify the prefix “s_”/”sk” in the value between xml tags)</p><p>In our example, our style directory is named “s_OracleTest” and our skin directory is named “sk_OracleTest”.</p><p>So we entered only the value “OracleTest”</p><p>73/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>How to insert auto-refresh functionality in Siebel Dashboard</p><p>This is a JavaScript solution to enable dashboards to be automatically refreshed at a given interval, for example to display on wallboards etc.</p><p>Siebel Analytics allows text to be added to the report output, and this text can be plain text, HTML or even JavaScript. The text can be added as a separate 'Static Text' view, or even as part of the 'Heading' view. Both of these are accessed from the 'Customize View' mode from the Results tab in Siebel Answers.</p><p>In each of these examples, the Siebel Analytics function HereLink() is called to perform the refresh, which is the function called when the user manually requests a refresh using the hyperlink on the page. If you would like to use this for other web pages, you can call window.location.reload() instead of the HereLink call, which is equivalent to reloading the current page (or pressing F5).</p><p>To know more about how to implement different solutions which allow you to use this JavaScript functionality, refer you to the following documentation</p><p> Analytics Auto Refresh.doc</p><p>74/75 [author] Christophe Menichetti Europe Oracle|Siebel IBM Support Center Montpellier – PSSC </p><p>Analytics Useful Folders and Files Structure</p><p>Server Directory File Description</p><p>Siebel Setup/ Run-sa.sh Start/stop script for Siebel Analytics Run-saw.sh analytics server and web server Server Sa.sh Containing Siebel environment Saw.sh variables to be exported in the current shell User.sh Odbc.ini</p><p> Config/ NQSConifg.INI Configuration file of the Siebel Analytics Server (SAS) (cache,logging,repository …)</p><p> Web/app/Res S_<style> Directory defining the user SK_<skin> interface style and skin</p><p> Repository/ <name>.rpd Metadata file containing physical layer, business model layer and presentation layer information</p><p> Log/ Javahost.log Log for the java host (corda chart generator) NQServer.log Log for start/stop steps of Siebel Analytics Server NQQuery.log Log of queries executed by SAS depending on log level</p><p>Siebel Web/log/ Sawlog0.log Log for SAW execution Analytics Web Server Web/config Instanceconfig.xm Configuration file for SAW (style, l skin, catalog …) Web/catalog Default.webcat Metadata file containing all *.autosave dashboard, answers information and parameters</p><p>75/75 [author] Christophe Menichetti</p>
Details
-
File Typepdf
-
Upload Time-
-
Content LanguagesEnglish
-
Upload UserAnonymous/Not logged-in
-
File Pages75 Page
-
File Size-