IBM Decision Server Insights. Installation Guide. Version 8 Release 6

Transcription

1 IBM Decision Server Insights Installation Guide Version 8 Release 6

2

3 IBM Decision Server Insights Installation Guide Version 8 Release 6

4 Note Before using this information and the product it supports, read the information in Notices on page 21. This edition applies to version 8, release 6, modification 0 of Decision Server Insights and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright IBM Corporation 2008, US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

5 Contents Installing Before you install Prerequisites Software requirements Supported operating systems Installation options Quick installation reference Installation Manager Installing Decision Server Insights Installing a typical installation of Decision Server Insights Installing a custom installation of Decision Server Insights Installing on multiple workstations Checking your installation Folders in the installation directory Menu shortcuts Shortcut commands Uninstalling Decision Server Insights What's next? Starting the local help Starting Insight Designer Accessing the help in Insight Designer Starting the default cisdev server Notices Trademarks Copyright IBM Corp. 2008, 2014 iii

6 iv IBM Decision Server Insights: Installation Guide

7 Installing Before you install Before you install Decision Server Insights, ensure that you are familiar with your installation options and requirements. Then, choose an installation option that best suits your Decision Server Insights installation needs. Select your product features in Installation Manager to install Insight Designer, the Insight server, and the local help. To start your installation, you must have an existing compatible version of Installation Manager. Consult the Installation Manager topics for more information. Ensure that you are familiar with the installation requirements and installation options before you install Decision Server Insights. Both of the installation options have the same environment and software requirements. Ensure that you have a supported environment, the software requirements, and an understanding of the installation options. Prerequisites Ensure that you have the correct version of IBM Installation Manager and the Decision Server Insights installation files before you install Decision Server Insights. You must have an existing Installation Manager set up on your workstation to install the product. You must have Installation Manager before you install Decision Server Insights. If you do not have Installation Manager 1.6.2, see Installation Manager downloads. You must have the installation files on your workstation to install the product. Download the installation files through IBM Passport Advantage.Ifthe installation files are compressed, extract them before you begin the installation. Before you install, you must set up Installation Manager. Point Installation Manager to the location of the installation files. To point Installation Manager to the installation files, you open the Preferences window and select Add Repository. Software requirements Ensure that you have the required software and environments on your workstation before you install Decision Server Insights. The installation options have different requirements, so you must ensure that your workstation has the required software and environments for the installation option that you choose. The typical installation option installs all of the required software and the default environments to your workstation. For example, after you install a typical installation, you can start Insight Designer in an Eclipse environment from the Start menu. The custom installation option installs the plug-ins for the software environments that you select under Update sites for plug-ins. For example, after you customize your installation, you must add your plug-ins to your existing Eclipse environment before you start Insight Designer. Copyright IBM Corp. 2008,

8 Consult Table 1 for a list of software requirements and environments. Table 1. Software requirements Required Software Java JDK Eclipse Description The Java Development Kit (JDK) is provided as a feature that you can install with the Decision Server Insights custom installation path. If you want to add JDK to an existing Eclipse, follow the custom installation option. Decision Server Insights supports Eclipse If you already have an Eclipse integrated development environment (IDE) installed on your computer, make sure that it corresponds to the required version. Upgrade your version if it is not the required version. Do not install Decision Server Insights in an Eclipse that already contains Operational Decision Manager. Shell sharing with Operational Decision Manager is not supported. IBM DB v Enterprise Server Edition v Workgroup Server Edition Tested databases. Supported operating systems Ensure that your operating system is supported before you install Decision Server Insights. Consult the following table to check the supported operating systems. In production, Decision Server Insights is supported only on Linux. Table 2. Supported operating systems Type of environment Supported operating system Development v 64-bit Windows 7 SP1 - Ultimate Edition v Red Hat Enterprise Edition (RHEL) x Desktop Production v Red Hat Enterprise Edition (RHEL) x Desktop Installation options Select the installation option that responds to your installation needs. You can select the typical installation option to install the features that you need to get up and started with Decision Server Insights. Alternatively, you can choose to install plug-ins to customize your installation of Decision Server Insights. You have two installation options: v Typical installation on page 3 v Custom installation on page 3 2 IBM Decision Server Insights: Installation Guide

9 For both installation options, ensure that you install Decision Server Insights outside of the Program Files and Program Files (x86) directories to avoid user privilege conflicts. Typical installation The typical installation features are selected by default on the Installation Manager features list. The default features are the core features of Decision Server Insights with which you can get up and started with Decision Server Insights. v Insight server v Insight Designer v Local help system Additionally, the typical installation installs the required software: v 64-bit Eclipse v Java Development Kit (JDK) When you install, ensure that you install Decision Server Insights outside of the Program Files and Program Files (x86) directories to avoid user privilege conflicts. Custom installation The custom installation features are available under Update sites for plug-ins in the Installation Manager features list. By default, the Decision Server Insights typical installation features are selected. Alternatively, you can customize your installation. To customize your installation, you select other features in the Update sites for plug-ins category or SmartCloud Analytics Embedded. Under Update sites for plug-ins, you can select the plug-ins that you want to install: v Insight Designer v WebSphere Application Server Developer Tools for Eclipse v JDK 7 SmartCloud Analytics Embedded is another available option that you can install on Linux. The custom installation does not install the required software. Ensure that you have the required software version for the plug-ins that you install. v 64-bit Eclipse v Java Development Kit (JDK) For example, if you select the Insight Designer plug-in, you must have an existing Eclipse environment on your workstation. When you install, ensure that you install Decision Server Insights outside of the Program Files and Program Files (x86) directories to avoid user privilege conflicts. After you install the product, you must add the plug-ins to your Eclipse and Liberty environments. The plug-ins are installed to your Decision Server Insights Installing 3

10 directory. You can also choose to install a JDK to add to your existing Eclipse environment. Quick installation reference For a general understanding of how you install Decision Server Insights with Installation Manager, review the following steps. Before you begin Review the Prerequisites on page 1 before you install. If you follow the custom installation path, review the Software requirements on page 1 to ensure that all prerequisite software is installed on your workspace. Know which installation path you want to follow. The typical installation path installs the core features of Decision Server Insights and the required software. The custom installation path installs plug-ins for your Eclipse and Liberty environments. For more information about the installation options, see Installation options on page 2. Installing Decision Server Insights With the Decision Server Insights installation, you install Insight Designer and the Insight server. After you install Decision Server Insights, you can install the product documentation and additional components that you need. The following table outlines the steps that you take to install Decision Server Insights. For more information about installing Decision Server Insights, consult the installation task topics. Description Procedure Add the Decision Server Insights repository. 1. Open Installation Manager. 2. Click File > Preferences. 3. Click Add Repository and browse the location of your Decision Server Insights repository. 4. Under Repositories, select or enter the location of your repository. 5. Click OK. Start your installation. Select Install in Installation Manager. Select your installation package. Select Decision Server Insights 8.6. Read and accept the terms of the license agreements. Manage your package groups. 1. Read the terms of the license agreement. 2. Select I accept the terms in the license agreement. 3. Click Next. 1. Select Create a new package group to install your first version of Decision Server Insights. You can alternatively select an existing package group to upgrade an existing package. 2. Click Browse to locate your installation directory location. 3. After you review the details, click Next. 4 IBM Decision Server Insights: Installation Guide

11 Description Select the features that you want to install. Procedure By default, all of the features that you need to install Decision Server Insights are selected. You can alternatively select plug-ins under Update sites for plug-ins to customize your installation. If you follow the custom installation path, ensure that you have all of the Software requirements on page 1. For more information about choosing an installation path, see Installation options on page 2. Ensure that you select Local help system. Because Decision Server Insights is only available with a local help, you must install the local help to be able to consult the product documentation. Review and install Decision Server Insights. Review the installation information. If you agree with the installation information that is displayed, click Next. If you want to modify previous choices, click Back. Related concepts: Supported operating systems on page 2 Ensure that your operating system is supported before you install Decision Server Insights. Prerequisites on page 1 Ensure that you have the correct version of IBM Installation Manager and the Decision Server Insights installation files before you install Decision Server Insights. You must have an existing Installation Manager set up on your workstation to install the product. Software requirements on page 1 Ensure that you have the required software and environments on your workstation before you install Decision Server Insights. The installation options have different requirements, so you must ensure that your workstation has the required software and environments for the installation option that you choose. Installation options on page 2 Select the installation option that responds to your installation needs. You can select the typical installation option to install the features that you need to get up and started with Decision Server Insights. Alternatively, you can choose to install plug-ins to customize your installation of Decision Server Insights. Installation Manager on page 6 Ensure that you understand how to use Installation Manager to facilitate your installation process. Installation Manager is the tool that you use to install Decision Server Insights. Related tasks: Selecting the features that you want to install on page 10 Use Installation Manager to install the custom installation of Decision Server Insights. When you choose to install the custom Decision Server Insights features, you select plug-ins under Update sites for plug-ins that you later add to your existing Eclipse and Liberty environments. Installing a typical installation of Decision Server Insights on page 9 Use Installation Manager to install the default installation features for Decision Server Insights. The typical Decision Server Insights installation includes the features that you need to get started, the development environment, and the Installing 5

12 Insight server module. Adding the Decision Server Insights repository on page 7 Before you install, you must point Installation Manager to the Decision Server Insights repository. Installation Manager Ensure that you understand how to use Installation Manager to facilitate your installation process. Installation Manager is the tool that you use to install Decision Server Insights. When you use Installation Manager, wizards guide you through the installation steps that you must take to install the product. After the installation, Installation Manager can be used to maintain your product packages. You can install, modify, update, roll back, or uninstall your IBM products. For more information, see the Installation Manager documentation. To download Installation Manager, see Installation Manager downloads. User Privileges You can use IBM Installation Manager in administrative mode (root), nonadministrative user (nonroot), or group mode. The mode determines the directories and commands that you use for both Installation Manager and the Decision Server Insights product package. You must be aware of this choice because the way you install Installation Manager affects how you can install and configure Decision Server Insights. You can install Installation Manager: v Administrator mode v Nonadministrator mode on page 7 v Group mode on page 7 You must log in with an account that has administrator privileges to install or update Installation Manager and the other products. Run the installer as an administrator by right-clicking the program file or shortcut and selecting Run as Administrator. The install.exe and userinst.exe commands install Installation Manager into different directories. Changes that you make to the administrator installation of Installation Manager do not affect the nonadministrator installation. Similarly, changes that you make to the nonadministrator installation of Installation Manager do not affect the administrator installation. Each instance of Installation Manager must have its own installation directory and agent data location. For more information on Installation Manager, see Group road maps and the user interface and Install as an administrator, nonadministrator, or group in the Installation Manager documentation. Administrator mode Use administrator mode when you have administrative privileges in Windows and root privileges in Linux. You can administer and manage Installation Manager and packages. You can install packages in a common location that is accessible by all users on a system. 6 IBM Decision Server Insights: Installation Guide

13 If you want the administrator user (root) to install products on a computer, run the install executable file that is in the Installation Manager directory. Nonadministrator mode Use nonadministrator mode to install packages in a location that is accessible only by the user who installs Installation Manager. In this mode, you cannot install packages that require administrator access rights. The packages are installed with nonadministrator rights. You can install only one instance of Installation Manager for each user on a workstation. If you want a specific user to install products on a computer, run the userinst executable file that is in the Installation Manager directory. Group mode Use group mode to enable a group of users to share packages in a common location and manage the packages with the same instance of Installation Manager. Group mode is not supported on Windows. If you want a group of users to install products on a computer, run the groupinst executable file. If you install Installation Manager using the group mode, you can install Installation Manager by using one account and offerings by using another account that is in the same group. For more information, see Installation commands in the Installation Manager documentation. Adding the Decision Server Insights repository Before you install, you must point Installation Manager to the Decision Server Insights repository. Before you begin Before you add the Decision Server Insights repository to Installation Manager, you must download the Decision Server Insights installation files to your workstation. If the installation files are compressed, you must extract them. About this task You point Installation Manager to the location of your Decision Server Insights repository where your installation files are located. Procedure 1. Start Installation Manager. 2. When Installation Manager opens, click File > Preferences. The repositories window opens. 3. Click Add Repository and browse the location of your Decision Server Insights installation files. You might have other file repository locations selected. If you intend to install only Decision Server Insights, you can clear the other file repository locations that are selected. 4. Click OK. Installation Manager now points to the repository. Installing 7

14 Related reference: Quick installation reference on page 4 For a general understanding of how you install Decision Server Insights with Installation Manager, review the following steps. Package groups and the shared directory With Installation Manager, you install Decision Server Insights in a package group that is used to group multiple packages into one manageable location. Installation Manager specifies a default package group and a shared resources directory. Package group A package group is a directory where compatible packages share common components such as a user interface or workbench. You can create a package group or install the packages into an existing compatible package group. Some packages cannot share a package group, in which case the option to use an existing package group is disabled. You might want to install the product in an existing package group if you installed supported versions of compatible products such as IBM Integration Designer or Rational Application Developer, or Rational Software Architect, and you want to extend it with Decision Server Insights features. When you install several packages at the same time, all the packages are installed into the same package group. After you create the package group, you cannot change the installation directory. The installation directory contains files and resources that are specific to Decision Server Insights. Shared resources directory The shared resources directory is where Eclipse plug-ins and other files are located so that they can be used by one or more product package groups. You can specify the shared resources directory only the first time that you install a package. The name of the shared resources directory depends on the first product that you have installed. You cannot change the directory location until you uninstall all packages. Important: Installation Manager manages the contents of the shared resources directory. You must not edit or modify any files in this directory. Installing Decision Server Insights Install Decision Server Insights through Installation Manager. Both of the installation options require Installation Manager, so ensure that you have Installation Manager on your workstation before you install Decision Server Insights. Select the installation option that best responds to your installation needs: typical or custom. 8 IBM Decision Server Insights: Installation Guide

15 After you install Decision Server Insights to your workstation, you can run a script to automate the installation of Decision Server Insights to multiple workstations in a network. Installing a typical installation of Decision Server Insights Use Installation Manager to install the default installation features for Decision Server Insights. The typical Decision Server Insights installation includes the features that you need to get started, the development environment, and the Insight server module. Before you begin Download and extract the Decision Server Insights installation files from IBM Passport Advantage. Point Installation Manager to the repository in which your Decision Server Insights installation files are located. Review the Prerequisites on page 1 before you install Decision Server Insights. About this task You install Decision Server Insights with IBM Installation Manager. The Decision Server Insights typical installation option installs everything that is required to develop, test, and deploy a Decision Server Insights solution. During the installation, you are prompted to select the features that you want to install. All of the features that you need to get Decision Server Insights up and running are selected by default: v Insight server v Insight Designer v Local help system Procedure 1. Start Installation Manager. 2. Click File > Preferences The repositories window opens. 3. Click Add Repository and browse the location of your Decision Server Insights installation files. 4. Under Repositories, select your repository location, and then click OK. You might have other file repository locations that are selected from previous installations. You can clear them to install only Decision Server Insights. 5. Click Install. 6. Select Decision Server Insights and Version 8.6, and click Next. 7. Review and accept the terms of agreement, and then click Next. 8. Select the installation directory. Important: The default installation directory in Windows 7 is C:\Program Files\IBM\ODMCI86. Change the default installation directory to a directory outside of Program Files and Programs files (x86) to avoid user privilege conflicts. 9. Click Next. Installing 9

16 10. On the Install Packages page, click Next. By default, the Decision Server Insights typical features are selected. Do not clear the local help system feature if you plan to install the local help later. 11. Click Install to start the installation. Installing a custom installation of Decision Server Insights Customize your Decision Server Insights installation through Installation Manager. Selecting the features that you want to install Use Installation Manager to install the custom installation of Decision Server Insights. When you choose to install the custom Decision Server Insights features, you select plug-ins under Update sites for plug-ins that you later add to your existing Eclipse and Liberty environments. Before you begin Download and extract the Decision Server Insights installation files from IBM Passport Advantage. Point Installation Manager to the repository in which your Decision Server Insights installation files are located. Review the Prerequisites on page 1 and Software requirements on page 1 before you install Decision Server Insights. Shell sharing with Operational Decision Manager is not supported. Do not install Decision Server Insights in an Eclipse that already contains Operational Decision Manager. About this task You install a custom installation when you select packages in addition to, or as an alternative to, the default (typical) installation. For example, if you want to install Decision Server Insights into an existing Eclipse, you can select the following packages from the Update sites for plug-ins category. v Insight Designer v WebSphere Application Server Developer Tools for Eclipse v JDK 7 After you install the plug-ins, you must then add the plug-ins to your Eclipse. To install SmartCloud Analytics Embedded, you must select the check box in the features list and configure it after the installer is finished. Procedure 1. Start Installation Manager. 2. Click File > Preferences. The Repositories window opens. 3. Click Add Repository and browse to the Decision Server Insights repository. 4. Under Repositories, select your repository location and click OK. You might have other file repository locations that are selected from previous installations. You can clear them to install only Decision Server Insights. 5. Click Install to select the packages that you want to install. 6. Select Decision Server Insights and Version 8.6, and click Next. 10 IBM Decision Server Insights: Installation Guide

17 7. Review and accept the terms of agreement, and then click Next. 8. Select the installation directory. Note: The default installation directory in Windows 7 is C:\Program Files\IBM\ODMCI86. Change the default installation directory to a directory outside of Program Files and Programs files (x86) to avoid user privilege conflicts. 9. Click Next. 10. On the Install Packages page, select the features that you want to install, and then click Next. By default, the Decision Server Insights typical installation features are selected. To customize your installation, you can select other features in the Update sites for plug-ins category or SmartCloud Analytics Embedded. If you want to install more features after your initial installation, you can select the Modify option in Installation Manager. 11. Click Install to start the installation. What to do next If you select the Insight Designer or the WebSphere Application Server Deceloper Tools for Eclipse plug-ins during your custom installation, you must manually add the Eclipse plug-ins to your existing Eclipse environment. For more information, see Adding Insight Designer to Eclipse and Installing WebSphere Application Server Developer Tools on page 12. Adding Insight Designer to Eclipse If you customize your installation and select the Insight Designer option under Update sites for plug-ins, you must manually add the plug-in to your Eclipse browser. Before you begin You must follow the custom installation option to obtain the Eclipse plug-ins of your choice. Do not install Decision Server Insights in an Eclipse that already contains Operational Decision Manager. Shell sharing with Operational Decision Manager is not supported. About this task If you select Insight Designer under Update sites for plug-ins during your product installation, you must manually add the plug-in to your Eclipse environment. Procedure 1. Start Eclipse. 2. Click Help > Install New Software. 3. Click Add. 4. Click Local and locate the repository where the update sites are installed. The plug-ins for Insight Designer are in the <InstallDir>/updates/cis directory. 5. Click OK. Installing 11

18 6. Select the plug-ins that you want to install from the list, and click Finish. You must restart your Eclipse integrated development environment (IDE) for the changes to take effect. Adding the JDK to Eclipse If you select the JDK under Update sites for plug-ins when you install Decision Server Insights, you must add the JDK to an existing Eclipse. About this task To add a JDK to Eclipse, you must enter a -vm argument in the eclipse.ini file. Enter the absolute or the relative path to the Java executable file. Procedure 1. Go to your Eclipse installation directory. 2. Open eclipse.ini in a text editor. 3. In a new line, enter -vm. The -vm option and its value must be on separate lines. 4. In a second line, enter the file system path to your Java executable file. The value that you enter must be the absolute or relative path to the Java executable file. v For Windows, enter <InstallDir>/jdk/jre/bin/j9vm/jvm.dll. v For Linux, enter <InstallDir>/jre/bin/java. 5. Save the eclipse.ini file. Results The following is an example of a -vm argument on Windows. Your path to the jvm.dll file could be different. -vm C:\IBM\ODMCI86\jdk\jre\bin\j9vm\jvm.dll Installing WebSphere Application Server Developer Tools Install WebSphere Application Server Developer Tools for Eclipse for a better Decision Server Insights experience. WebSphere Application Server Developer Tools for Eclipse is a lightweight set of tools for developing, assembling, and deploying Java Enterprise Edition (Java EE) web profile applications. Before you begin You must have the Eclipse plug-in for WebSphere Application Server Developer Tools for Eclipse that is installed on your workstation. During the Decision Server Insights installation, you can obtain the plug-in by selecting WebSphere Application Server Developer Tools for Eclipse. Procedure 1. Open your Eclipse environment. 2. Click Help > Install New Software. 3. Click Add. 4. Click Local and browse the location of your WebSphere Application Server Developer Tools for Eclipse plug-ins. For example: <InstallDir>/updatesite/ wdt/. 5. Click OK. 6. Click OK. 12 IBM Decision Server Insights: Installation Guide

19 7. Select WebSphere Application Server Developer Tools for Eclipse and WebSphere Application Server V8.5 Liberty Profile Server Adapter. 8. Select Next. 9. Review and accept the terms of the license agreements, and then click Finish. Results After you complete the installation, you must restart your Eclipse environment for the changes to take effect. Installing on multiple workstations If you want to set up a production environment, you run a script to automate the installation of your local Decision Server Insights installation to a network of workstations. Before you begin Before you can install Decision Server Insights to a network of workstations, you must install Decision Server Insights on your workstation. About this task When you install Decision Server Insights to multiple workstations, you use a command line in the Installation Manager directory to call the template response file. The template response that you want to call is in the following directory: <InstallDir>/doc/silent/CIS_Silent.xml. Procedure 1. Go to <InstallDir>/doc/silent/CIS_Silent.xml. Your template response file is CIS_Silent.xml. 2. With a text editor, open the CIS_Silent.xml template response file. 3. Replace!CIS_REPOSITORY! with the path of your Decision Server Insights location. 4. Replace the variable!cis_profile_id! with the name of the Installation Manager package group name. Installation Manager uses the profile name to recognize product families. 5. Replace the variables!cis_features! with the features that you want to install on the network. When you enter your features, separate each feature with a comma. The following examples are the default installation features: com.ibm.cis.runtime.feature, com.ibm.cis.designer.feature, and Documentation. 6. Replace the variable!cis_home! with the installation path to which you want to install the product. 7. Save the CIS_Silent.xml template response file. 8. Go to the directory where you install Installation Manager. 9. Go to the directory eclipse/tools and open a command window. 10. Enter the following command: a. For Windows, enter imcl.exe input <path_to_response_file>/ CIS_Silent.xml. b. For Linux, enter./imcl input <path_to_response_file>/cis_silent.xml. 11. Run the command with the same response file on each workstation. Installing 13

20 Checking your installation Check your installation before you begin developing a solution. Folders in the installation directory After you install Decision Server Insights, check the content of the installation directory. In your file system, go to the <InstallDir> directory that contains the folders that you want to check. Depending on your installation, your directory contains all or some of the following folders and the corresponding components: Table 3. Component-folder mapping Folder CIS-runtime-target-platform configuration doc jdk jre p2 readme runtime updatesite Components The CIS-runtime-target-platform folder contains the runtime files for Insight Designer plug-ins. The configuration folder contains configuration files and plug-ins for Eclipse. The doc folder contains the local help system. The jdk folder contains the Java development kit (JDK) files. The jre is the runtime portion of your environment. The p2 folder contains the Eclipse provisioning system files for OSGi-based applications. The readme folder contains the Eclipse project release notes. The runtime folder contains the runtime files CIS and WebSphere Application Liberty. The updatesite folder contains the plug-ins for Decision Server Insights and WebSphere Application Server Developer Tools. You only have this folder if you customized your installation. After you install, you must add the plug-ins to your existing Eclipse environment to have the features you select. Menu shortcuts You can use menu shortcuts to access your Decision Server Insights components. Review the list of components to better understand your installation. Your choice of installation determines what shortcuts the installer adds to the menu. 14 IBM Decision Server Insights: Installation Guide

21 Shortcuts The following is available under the package group level: v Insight Designer v Start local help v Stop local help Start Insight Designer. Menu navigation Windows Start > All Programs > IBM > <Package_Group> Linux Applications_menu > IBM > <Package_Group> Windows Start > All Programs > IBM > <Package_Group> > Insight Designer Linux Applications_menu > IBM > <Package_Group> > Insight Designer Start the local help system. Windows Start > All Programs > IBM > <Package_Group> > Start local help Linux Applications_menu > IBM > <Package_Group> > Start local help Stop the local help system. Windows Start > All Programs > IBM > Package_Group > Stop local help Linux Applications_menu > IBM > <Package_Group> > Stop local help Related tasks: Starting Insight Designer on page 18 After you complete the installation step (typical or custom), you can then start Insight Designer. Shortcut commands Use the shortcuts to start common commands. The installer adds relevant shortcuts in batch (.bat) files on Windows and Bash shell script (.sh) files on Linux. Windows Shortcuts Insight Designer Start local help Stop local help Windows commands <InstallDir>/eclipse.exe <InstallDir>/doc/help_start.bat <InstallDir>/doc/help_end.bat Linux Shortcuts Insight Designer Linux commands <InstallDir>/eclipse.sh Installing 15

22 Shortcuts Start local help Stop local help Linux commands <InstallDir>/doc/help_start.sh <InstallDir>/doc/help_end.sh Uninstalling Decision Server Insights What's next? You use the Uninstall option in Installation Manager to remove Decision Server Insights. Before you begin Before you uninstall Decision Server Insights offerings, you must stop the local help. If you installed WebSphere Application Server Developer Tools into Insight Designer, you must manually uninstall WebSphere Application Server Developer Tools before you can uninstall Decision Server Insights. About this task You uninstall the Decision Server Insights package group from Installation Manager. Procedure 1. Start Installation Manager. 2. Click Uninstall. 3. Click Decision Server Insights. 4. Click Next, and then click Uninstall. 5. When the installation is complete, click Finish. Related concepts: Stopping the local help on page 18 Before you uninstall the Decision Server Insights offerings in Installation Manager, you must stop the local help. Set up the local help and test that you can access it from Insight Designer. Start the default cisdev server to make sure that the installed scripts work correctly. Starting the local help You can only consult the Decision Server Insights documentation locally. Therefore, you must start the local help server and download the information collection to access the Decision Server Insights documentation locally. After you install your information collection, your product documentation is available to you every time you start the local help server. You can access the local help either through the Eclipse interface or through a web browser. After your installation collection is installed on your workstation, you can deploy the information collection from your workstation to other workstations in a network. 16 IBM Decision Server Insights: Installation Guide

23 Updating the local help The Local help system feature is installed by default. After the installation is complete, you must download the information collections. Before you begin During the installation of the local help, ensure that you have access to the internet. After you install the local help, your local help no longer requires access to the internet. If you work on a 64-bit platform such as Red Hat Enterprise Linux (RHEL), you must install a 32-bit compatibility library to use the local help. About this task You select and install an information collection locally. Procedure 1. In the Start menu, click All Programs > IBM > Decision Server Insights > Start local help. The Help window opens. 2. On the toolbar menu, click the Update icon to view a list of your information collections. If you are installing information collections for the first time, no information collections display. 3. Click Next. The Help window searches for available information collections. 4. Select the information collection that corresponds to your Decision Server Insights product version. 5. Click Install. 6. When your installation is complete, click OK, and then click Finish. Your product documentation displays beneath the contents tab. If your product documentation does not initially display, you can stop and start the local help to view the documentation. Running help on an internal network After you install the local help on one workstation, you can make the local help available to other workstations in a network. Before you begin You must first install the local help on your workstation. You can then deploy your local help over a network to other workstations in that network. About this task Because Decision Server Insights is only available with a local help, the only documentation that you can consult is the local help. After you install the local help on your workstation, you can make the help available over a network to avoid installing the help on every workstation. Installing 17

24 Procedure To start the local help on an internal network: 1. Run <InstallDir>\doc\IC_start.bat on Windows or <InstallDir>/doc/ IC_start.sh on Linux. By default, the shared local help runs on port Optional: To modify the default port, edit the IC_start.bat or IC_start.sh file, and modify the port argument. For example, -port <port_number>. When you start the local help, you access the local help in browsers from other systems at the address 3. Optional: Configure the help preferences in Insight Designer to access the local help: a. Click Window > Preferences > Help > Content. b. Select Include remote help and give it priority, then click New. c. Enter the values for the local help that you want to connect to. For example: v Name: Decision Server Insights local help v Host: <ic_hostname> v Path: /help v Use port: 9999 d. Click OK, and then click Apply and OK. The context-sensitive help now uses your new parameters. Related concepts: Stopping the local help Before you uninstall the Decision Server Insights offerings in Installation Manager, you must stop the local help. Stopping the local help Before you uninstall the Decision Server Insights offerings in Installation Manager, you must stop the local help. You can stop the local help from Start > All Programs > IBM > Decision Server Insights > Local Help End. You can alternatively run Windows and Linux commands to stop the local help: v On Windows, run <InstallDir>/doc/help_end.bat v On Linux, run <InstallDir>/doc/help_end.sh Related tasks: Accessing the help in Insight Designer on page 19 After you update the help system with the Decision Server Insights documentation, you can test the connection to the running help system and access the help from Insight Designer. Running help on an internal network on page 17 After you install the local help on one workstation, you can make the local help available to other workstations in a network. Starting Insight Designer After you complete the installation step (typical or custom), you can then start Insight Designer. 18 IBM Decision Server Insights: Installation Guide

25 Before you begin If you customize your installation and install the Insight Designer plug-ins into an existing Eclipse, you must ensure that you start this Eclipse in the American English (en_us) locale. Procedure 1. To start Insight Designer from the Windows Start menu: v Click Start > Insight Designer to start the designer as a non-administrator. v Right-click Insight Designer, and then click Run as administrator to start the designer as an administrator. On Linux, use the menu shortcut or the shell script <InstallDir>/doc/ help_start.sh. 2. Select your workspace. 3. Click Window > Open Perspective > Other > Decision Insight. Related concepts: Menu shortcuts on page 14 You can use menu shortcuts to access your Decision Server Insights components. Review the list of components to better understand your installation. Accessing the help in Insight Designer After you update the help system with the Decision Server Insights documentation, you can test the connection to the running help system and access the help from Insight Designer. Before you begin Run the local help start script or the shared local help start script (help for an internal network): v v <InstallDir>\doc\help_start.bat (Windows) or <InstallDir>/doc/ help_start.sh (Linux) <InstallDir>\doc\IC_start.bat (Windows) or <InstallDir>/doc/IC_start.sh (Linux) Procedure To access the help in Insight Designer: 1. Check that the settings to use the help are set correctly: a. Click Window > Preferences > Help > Content. b. Make sure Include remote help and give it priority is selected. c. Make sure that Insight Designer help is enabled and the URL corresponds to your help system. d. Click Test Connection to make sure that Eclipse can find the help URL. 2. On the Help menu, click Help Contents. The Decision Server Insights documentation appears in the help and is accessible by clicking F1 in Insight Designer. Related concepts: Stopping the local help on page 18 Before you uninstall the Decision Server Insights offerings in Installation Manager, you must stop the local help. Installing 19

26 Starting the default cisdev server When the product installer is finished, start the default cisdev server to test that your installation completed successfully. About this task The server management script is in the <InstallDir>/runtime/wlp/bin directory. From this directory, you run various server commands. For more information, see Creating, starting, and stopping servers. Procedure 1. Open a command window from the <InstallDir>/runtime/wlp/bin directory. 2. Enter the following command: server start cisdev. As a result, the command window displays Server cisdev started. Results When a server is started, listeners can accept connect requests from clients. The installer does not detect which system ports are already used, and always creates a default cisdev server with the following port numbers: v http.port=9080 v https.port=9443 v ia.listenerport=2809 The ports are defined in the bootstrap.properties file, which is in <InstallDir>/runtime/wlp/usr/servers/cisDev. To find which application is using a port on your computer, run netstat. What to do next If you installed SmartCloud Analytics Embedded, you must complete the installation before you can use it with the default cisdev server. For more information, see Configuring SmartCloud Analytics. 20 IBM Decision Server Insights: Installation Guide

27 Notices This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-ibm product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM United Kingdom Laboratories, Mail Point 151, Hursley Park, Winchester, Hampshire, England SO21 2JN For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan, Ltd , Nihonbashi-Hakozakicho, Chuo-ku Tokyo , Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-ibm Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Copyright IBM Corp. 2008,

28 websites. The materials at those websites are not part of the materials for this IBM product and use of those websites is at your own risk. IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM United Kingdom Laboratories, Mail Point 151, Hursley Park, Winchester, Hampshire, England SO21 2JN Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this document and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-ibm products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-ibm products. Questions on the capabilities of non-ibm products should be addressed to the suppliers of those products. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. COPYRIGHT LICENSE: This information contains sample application programs in source language, which illustrate programming techniques on various operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of developing, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples have not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or 22 IBM Decision Server Insights: Installation Guide