Foglight5安装指南.doc

Foglight5安装指南SQuest Software61Foglight5安装指南Quest Software2008.7Prepared by:Name HereQuest Software, IncWhite Paper目 录1概要和约定31.1.概要31.2.约定32Foglight简介43Foglight安装准备43.1介质43.2基本安装步骤53.3监控平台要求53.4监控环境确认64Foglight Server安装64.1Server安装64.2Cartridge加载145Foglight SPID的安装185.1Windows环境下的安装185.2Unix环境下的安装236Foglight OS Agent安装296.1Windows环境下的安装296.2Unix环境下的安装347Foglight JAVA Agent安装387.1Windows环境下的安装387.2Unix环境下的安装438Foglight JAVA Agent配置478.1Windows环境下的配置478.2Unix环境下的配置489Foglight Oracle Agent安装509.1Windows环境下的安装509.2Unix环境下的安装5310Foglight Oracle Agent配置5510.1Windows环境下的配置5510.2Unix环境下的配置591 概要和约定1.1. 概要Foglight：用于实现对J2EE应用服务器进行7X24小时监控，监控内容包括：n 对门户系统应用服务器的全面监控。n 对应用服务器状态的全面诊断和分析。n 对应用请求的全面诊断和分析。n 对门户系统监控与网管系统的集成。本文档对上述软件在安装和配置后的试运行期间对软件的功能项进行测试，并验证产品安装和配置的正确性，保证软件部署后的顺利运行。1.2. 约定本文档内容包含一些格式和说明约定。强调：强调部分会用斜体、粗体表示(文档标题除外)。修订：本文档提供修订历史记录，任何项目组人员均可发现或修改或补充文档目前没有或有问题的内容。词汇：文档中使用大量Quest公司Foglight产品中的一些技术名词，有些名词为等价的，并列举如下：n Foglight Server：等价于Foglight Management Server、Foglight管理服务器等，也简写为FMS。n Foglight Agent：等价于Foglight Cartridge、Foglight代理、Foglight代理程序。n Folight Client：等价于SPID，是Foglight Agent的基础软件。n Foglight Console：等价于Foglight Operation Console、Foglight操作控制台、Foglight控制台、Foglight Web控制台。n FGLHOME：等价于Foglight及Foglight Agent安装主目录内容：n 排版：出于排版需要，文档中某些图显示比较小，如果需要可适当放大查看信息n 安装和配置：文档中的安装和配置说明均为windows下Foglight Server的说明，文档中为了保持完整性，同时在某些重要部分描述了在Solaris下的说明。n 安全：文档中涉及到的Foglight用户、Oracle用户等用户名和口令均采用foglight，实际中推荐使用foglight用户名，但不推荐使用foglight作为口令。n 章节独立：文档中保持每一部分的相对独立性，即每个单元可看作完整的安装或配置内容，因没有省略可能带来文字、图片的重复性，实属正常。另外，本指南以WebLogic为例。有关WebSphere的内容请参阅英文指南。2 Foglight简介Foglight是Quest的高级应用监控解决方案，可以对所有影响企业IT性能的服务器、数据库、操作系统、Web Sever和网络进行监控和管理，改善系统的性能和可用性。Foglight 是一种易于实施和使用的应用监控解决方案，采用轻量数据采集和快速信息发布机制，大大降低了系统资源消耗，实现了快速的投资回报。Foglight可以与Netcool、Tivoli、HP OpenView和其它第三方管理框架产品集成，向其发送相关事件和报警信息。Foglight 包括Server、Agent和Console三部分：n Foglight Server用于对所采集的性能数据进行关联、分析和集中存储。n Foglight Agent负责按照预先定义的时间间隔，收集信息并发送给Foglight Server。Foglight Agent运行于被监控的服务器上。n Foglight Console为基于Web的管理控制台，对Foglight进行管理和响应报警事件。3 Foglight安装准备3.1 介质一般地，测试介质下图所示：将其解压后的目录结构如下图：3.2 基本安装步骤1) 安装Foglight Server；2) 安装（或称作装载）Cartridge；Cartridge是多个相关Agent安装程序组成的一个包。3) 下载、安装SPID（或称作Foglight Client）；SPID是Agent运行的基础。除非只想安装Java EE Agent，否则所有被监控的主机上都需要安装SPID。4) 部署Agent。除Java EE外，部署任何Agent前都需要首先在被监控主机上启动SPID。Java EE Agent无需部署。Window环境下的Oracle Agent要求直接在被监控机上部署（当前版本）。其他Agent在FMS上就可以进行远程部署相关代理。5) 创建Agent。Java EE Agent要求直接在被监控机上下载安装（.exe或.bin）；无需创建。Oracle Agent、OS Agent等都需要创建一个命名Agent。6) 配置Agent。3.3 监控平台要求采用Quest 监控产品Foglight，必须进行安装准备工作，请详细阅读和参考以下关于安装方面的要求。Foglight安装包括Foglight Server安装、被监控服务器Agent安装两个部分：Foglight Server要求：n 安装Windows2003平台，IE6.0n 硬件平台：2G Hz以上双核CPU；2G 以上内存；2G空间用于安装程序n 10-40G空间用于存储和备份历史数据Foglight Agent支持平台：n Microsoft Windows 2000 (SP2)、Microsoft Windows 2003 including Itaniumn Solaris 6, 7, 8, 9, 10n HPUX 11, 11i, 11.23 Itaniumn AIX 4.3.3, 5.1, 5.2, 5.3n Red Hat Enterprise Advanced Server 2.1, 3.0; Red Hat 7.x (Linux 2.4); SuSe 8.0 (Linux 2.4)被监控服务器要求：n 600M硬盘空间n WebLogic操作系统用户权限n WebLogic Server管理控制台权限3.4 监控环境确认为方便起见，本指南假设应用环境如下：Foglight Server主机：IP地址：8主机名：win平台：Windows2003Oracle DB主机：IP地址：6主机名：oracle平台：Windows2003Oracle：WebLogic主机：IP地址：6主机名：oracle平台：Windows2003WebLogic：8.1.4WebLogic2：IP地址：平台：HP UX11i3.5 License管理License过期之后，一些操作就无法进行了。如下图所示：点击红色矩形框中的链接安装License：输入License文件，并点击Install License之后：安装完毕。4 Foglight Server安装4.1 Server安装在本项目中， Foglight Server安装在Windows平台上，安装用户为Administrator。将Foglight安装程序拷贝到Windows机器上或直接从光盘启动安装。安装程序为Foglight-*_*_*-install_windows-ia32.exe。其中*表示Foglight的版本号。具体安装过程和步骤如下：1) 启动安装界面。2) 接受软件安装许可协议。3) 选择安装路径。4) 选择程序组。5) 选择Foglight Server启动类型。Enable选项表示FMS安装后作为Windows的Services运行，可以自动启动。Do not enable选项表示人工从开始菜单启动FMS。一般地，可选择Do not enable。6) 确认安装选项。7) 开始安装。8) 输入和确认Foglight管理员口令。9) 选择Foglight Server运行模式。FMS可以安装成高可用性（HA）模式，以便在一个FMS发生故障时接管。HA模式请参考英文指南，一般地选择Standalone。10) 选择和确认用户和口令。Foglight收集到的信息集中存储在数据库中，一般地，有三种存储方式：n 嵌入MySQL。Foglight自动创建一个MySQL数据库存储信息。n 外部MySQL。Foglight将信息存储到一个已存在的MySQL库中。n 外部Oracle。Foglight将信息存储到一个已存在的Oracle数据库中。此时需要输入这个Oracle数据库的连接信息、用户信息等。一般地，如果不是大规模部署（例如几十、上百台被监控的主机、应用等），请选择嵌入MySQL。11) 安装进行中。12) 选择和确认端口号。Foglight需要用到一些端口，一般地，采用缺省值即可。当然，可以修改这些端口以防冲突。例如，HTTP端口，缺省为8080，如果你的机器上已存在一个HTTP服务器使用了8080端口，可以修改为100或其他。13) 输入License文件。请接触Quest公司获取测试License。14) 安装结束。15) 启动Foglight Server。以Administrator用户登录到Foglight Server所在Windows系统上，在Start菜单中选择程序组“Quest Software-Foglight 5.2.1-Start Foglight”启动Foglight Server。当看到如下信息，确认Foglight Server启动成功：4.2 Cartridge加载Foglight Agent在被部署到被监控机器前，需要集中以程序包Cartridge的方式加载到Foglight Server 中。以下为加载过程和步骤。1) 以管理员身份登录到Foglight管理控制台。2) 进入加载界面。3) 浏览并选择特定类型的Cartridge。例如，对Java EE，请选择目录Foglight5215Foglight-5_2_1_5-Cartridges-ApplicationManagementCartridgesApplicationManagementJavaEE-5_2_1_5下的Java_EE-5_2_1_5-20080501-1057.car文件。注意，除了Java EE之外，监控其他任何的主机或数据库或ERP应用等都必须事先安装SPID。SPID的Cartridge在Foglight5215Foglight-5_2_1_5-Server-Windows-IA32ServerFoglightClient-SPID-5_2_1下。安装方式都类似。4) 点击Install Cartridge开始加载并安装。5) 安装结束。6) 类似地，加载并安装Oracle Cartridge、OS Cartridge、SPID Cartridge等。之后，显示如下图：5 Foglight SPID的安装5.1 Windows环境下的安装以Administrator登录到需要被监控的主机上，在本例中是6。1) 打开IE，登录到FMS。2) 打开Administratioin|Cartridge|Components for Download找到相应平台的SPID。如下图。3) 点击“Foglight_SPID”链接开始下载并安装。如下图，点击“运行”按钮即可。4) 开始安装。5) 接受软件协议。6) 输入安装目录。7) 选择快捷键文件夹。8) 输入FMS地址和端口。9) 安装汇总检查窗口。10) 开始安装。11) 安装结束。12) 安装完成后，需要从开始菜单“Quest Software|Foglight SPID 5.2.1|Start SPID”启动SPID。5.2 Unix环境下的安装和Windows平台一样，打开FMS并登录，下载SPID在AIX平台上的安装软件Spid-5_2_2-install_aix-powerpc.bin到FMS。将此文件以root用户FTP到AIX主机，之后修改文件权限为744。可以命令行或图形界面安装。安装之前，在AIX上创建一个quest用户，当前分配了DBA组。安装SPID时要求输入运行帐号，请输入quest。另外，必须注意，要用quest帐号而不要用root启动SPID！否则oracle，EBS代理无法部署。1) 登录FMS。2) 下载SPID的安装软件到本地。3) 在AIX上创建用户quest，加入DBA组；创建安装目录，并将此安装目录的owner修改为quest。FTP安装程序到主机上，并修改权限为744。4) 以root用户登录到AIX主机，开始安装。5) 点击Next。6) 选择接受协议。点击Next。7) 输入安装目录，点击Next。8) 对Unix平台，此处选择Dont Create Links。9) SPID要以非root的用户运行。此处输入用户名quest。点击Next。10) 输入Foglight Server的IP地址或名称，以及端口号。点击Next。11) 检查设置是否正确。点击Next。12) 开始安装。13) 安装完成后，最后点击“Done”按钮即可。14) 启动SPID。进入SPID的安装目录/Foglight_SPID，执行./startup即可。执行./shutdown可停止SPID。启动后，用命令ps ef|grep SPID检查是否成功。6 Foglight OS Agent安装6.1 Windows环境下的安装OS Agent可以远程部署。以Administrator登录到FMS主机。1) 打开IE，登录到FMS。2) 打开Administratioin|Agents|Agent Hosts找到相应被监控主机。也可以按Shift进行多选。3) 部署OS Agent。点击Deploy Agent Package，选择OS Cartridge。4) 点击Apply。5) 点击Close关闭部署窗口。6) 部署完成后，（XXXXXXX部署完成的状态在哪儿？）需要创建一个Agent。点击Create Agent按钮。注意，如果Agent还没有部署完，在Agent Type中不会出现相关代理。7) 选择一个Agent类型，例如Windows_System，输入名称，例如Oracle_OS：8) 点击Apply。9) 安装完成。10) 打开Administratioin|Agents|Agent Hosts找到创建的OS代理。11) 点击Activate激活Agent。12) OS Agent被成功激活。6.2 Unix环境下的安装OS Agent可以远程部署。以Administrator登录到FMS主机。1) 打开IE，登录到FMS。2) 在Agent Hosts中，选择相关主机。也可以在Agent Status中选择相关主机。点击Deploy按钮。3) 选择需要部署的Agent：OS，点击Apply。4) 开始部署。成功后会在右上角有一个绿色的提示。5) 同样地，可以部署其他代理，例如OEB（Oracle E-Business Suit）代理。6) 部署完成后，需要创建OS Agent。回到Agent Hosts或Agent Status界面。点击Create Agent按钮。7) 选择需要创建的Agent。你也可以多选。输入一个Instance Name。点击Apply。8) 创建完成后，显示下图。点击OK即可。9) 可以看到已经创建了一些Agent。10) 多选这些Agent，点击Active按钮。11) 开始激活。12) 点击Close，显示下图。对未激活的Agent，需要进一步配置。请参考配置部分的文档。7 Foglight JAVA Agent安装7.1 Windows环境下的安装以Administrator登录到需要被监控的主机6上。目前Java EE Agent只能本地部署。具体安装过程和步骤如下：1) 登录FMS。2) 进入Agent下载界面。3) 选择相应平台的Java EE，下载并安装。4) 直接运行程序进行安装。5) 接受软件安装许可协议。6) 选择安装路径。7) 选择程序组。8) 输入Foglight Server地址和端口号。9) 安装配置参数确认。10) 开始安装。11) 安装结束。7.2 Unix环境下的安装与在Windows平台上安装Foglight Agent类似，首先从Foglight控制台上将相应Unix平台的Agen安装程序下载到本地。运行ftp，以WebLogic 操作系统用户登录并用二进制方式上传Agent安装文件到Unix平台上。以WebLogic 操作系统用户远程登陆到Unix服务器上，执行以下命令开始安装：EIP-DB01/bea./javaee_agent-hpux-ia64-5_1_4.bin -i console整个安装过程和步骤如下：1) 开始解压缩包。Preparing to install.Extracting the JRE from the installer archive.Unpacking the JRE.Extracting the installation resources from the installer archive.Configuring the installer for this systems environment.Launching installer.Preparing CONSOLE Mode Installation.=Java EE Agent 5.1.4 (created with InstallAnywhere by Macrovision)-=Introduction-InstallAnywhere will guide you through the installation of Java EE Agent 5.1.4.It is strongly recommended that you quit all programs before continuing withthis installation.Respond to each prompt to proceed to the next step in the installation. If youwant to change something on a previous step, type back.You may cancel this installation at any time by typing quit.Build: 514-20071005-0255PRESS TO CONTINUE:=2) 阅读并接受软件安装许可协议。License Agreement-Installation and use of Java EE Agent 5.1.4 requires acceptance of thefollowing License Agreement:Quest Software, Inc.Software License AgreementDO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N): y=3) 选择安装目录。Choose Install Folder-Select your installation folder (DEFAULT: /Quest_Software/Quest_Agents/Java_EE-5_1_4): /bea/Quest_Software/Quest_Agents/Java_EE-5_1_4=4) 选择是否创建链接。Choose Link Location-Where would you like to create links? -1- Default: /Quest_Software/Quest_Agents/Java_EE-5_1_4/Shortcuts 2- In your home folder 3- Choose another location. 4- Dont create linksENTER THE NUMBER OF AN OPTION ABOVE, OR PRESS TO ACCEPT THE DEFAULT : 4=5) 输入Foglight Server的IP地址和端口号。Configure Java EE Agent 5.1.4-Please enter the Foglight 5 Server hostname (or IP address) and port numberwhere the Java EE Agent 5.1.4 will connect.Foglight Server Host (DEFAULT: localhost): 6Foglight Server Port (DEFAULT: 41705):=6) 安装确认。Pre-Installation Summary-Please Review the Following Before Continuing:Product Name: Java EE Agent 5.1.4Install Folder: /bea/Quest_Software/Quest_Agents/Java_EE-5_1_4Link Folder: /tmp/install.dir.3616/Do_Not_Install/Quest_Software/Quest_Agents/Java_EE-5_1_4/ShortcutsFoglight Server Host: 6Foglight Server Port: 41705Disk Space Information (for Installation Target): Required: 250,329,318 bytes Available: 51,165,003,776 bytesPRESS TO CONTINUE:=7) 开始安装。Installing.-=|=|=|= -|-|-|-=8) 安装结束。Installation Complete-Congratulations. Java EE Agent 5.1.4 has been successfully installed to:/bea/Quest_Software/Quest_Agents/Java_EE-5_1_4Build: 514-20071005-0255PRESS TO EXIT THE INSTALLER:8 Foglight JAVA Agent配置8.1 Windows环境下的配置Foglight Agent包括两个部分：system agent和WebLogic Agent。System agent无需配置，直接启动即可。在Windows平台上，system agent作为服务启动即可。WebLogic Agent需要进行配置，并在配置结束后将WebLogic Server重新启动，以使配置生效。对普通的WebLogic Server，具体配置过程和步骤如下：（对使用Node Manager启动的WebLogic Server需要用不同的脚本，请查阅英文文档CartridgeForJavaEE_Install.dbf）1) 查找和确认WebLogic Server/实例启动脚本。2) 用任一编辑器打开启动脚本。在启动WebLogic脚本块之前加入以下内容：set PERFORMASURE_HOME=C:Quest_SoftwareQuest_AgentsJava_EE-5_1_4set QUEST_JAVA_ENV_OPTS=WEBLOGICcall %PERFORMASURE_HOME:=%scriptsquest-java-env.cmd | ( echo PerformaSure Agent not enabled )3) 保存退出，重新启动WebLogic即可。WebLogic重新启动后，需要在启动日志中查找以下信息，以确定WebLogic Agent配置成功：.2008-07-02 15:03:01.218 INFO Loading Agent startup configuration from D:Quest _SoftwareQuest_AgentsJava_EE-5_2_1configagent.config2008-07-02 15:03:03.578 INFO PerformaSure (Build 5215-20080430-1657) on Windows 2003 x86 5.2 using Sun Microsystems Inc. Java HotSpot(TM) Client VM version 1.4.2_05-b04 (extra info: mixed mode); Agent Type: WebLogic2008-07-02 15:03:03.765 INFO Connected to Nexus at 8:417052008-07-02 15:03:06.656 INFO Agent started .4) 配置并启动WebLogic后，在FMS控制台，我们可以看到Java EE Agent正在运行。8.2 Unix环境下的配置Foglight Agent包括两个部分：system agent和WebLogic Agent。System agent无需配置，直接启动即可。在nix平台上，system agent作为后台进程启动，启动命令为：nohup ./systemagent &WebLogic Agent需要进行配置，并在配置结束后将WebLogic Server重新启动，以使配置生效。对普通的具体配置过程和步骤如下：1) 查找和确认WebLogic Server/实例启动脚本。2) 用任一编辑器打开启动脚本。在启动WebLogic脚本块之前加入以下内容：PERFORMASURE_HOME=/bea/Quest_Software/Quest_Agents/Java_EE-5_1_4if -f $PERFORMASURE_HOME/scripts/quest-java-env.sh then QUEST_JAVA_ENV_OPTS=WEBLOGIC . $PERFORMASURE_HOME/scripts/quest-java-env.shelseecho PerformaSure Agent not enabledfi3) 保存退出，重新启动WebLogic即可。WebLogic重新启动后，需要在启动日志中查找以下信息，以确定WebLogic Agent配置成功：* To start WebLogic Server, use a username and * password assigned to an admin-level user. For * server administration, use the WebLogic Server * console at http:hostname:portconsole *Executing C:Quest_SoftwareQuest_AgentsJava_EE-5_1_4scriptsquest-java-env.cmd with C:J2SDK11.2_02007-11-28 17:55:34.221 INFO Loading Agent startup configuration from C:Quest _SoftwareQuest_AgentsJava_EE-5_1_4configagent.config2007-11-28 17:55:34.800 INFO PerformaSure 5.1.4 (Build 514-20071004-1632) on Windows 2003 x86 5.2 using Sun Microsystems Inc. Java HotSpot(TM) Client VM version 1.4.2_09-b05 (extra info: mixed mode); Agent Type: Preinstrumentor2007-11-28 17:55:34.846 INFO Connected to Nexus at 6:417052007-11-28 17:55:35.753 INFO Agent started2007-11-28 17:55:35.753 INFO Creating bootstrap classes in C:Quest_SoftwareQ uest_AgentsJava_EE-5_1_4scripts.bootstrapC-J2SDK11.2_0.jar2007-11-28 17:55:36.096 INFO Session recording started2007-11-28 17:55:39.471 INFO Preinstrumentation complete2007-11-28 17:55:39.471 INFO Session recording stopped2007-11-28 17:55:39.471 INFO Preinstrumentor Agent shutdown completed2007-11-28 17:55:41.206 INFO Loading Agent startup configuration from C:Quest _SoftwareQuest_AgentsJava_EE-5_1_4configagent.config2007-11-28 17:55:41.909 INFO PerformaSure 5.1.4 (Build 514-20071004-1632) on Windows 2003 x86 5.2 using Sun Microsystems Inc. Java HotSpot(TM) Server VM version 1.4.2_09-b05 (extra info: mixed mode); Agent Type: WebLogic2007-11-28 17:55:42.003 INFO Connected to Nexus at 6:417052007-11-28 17:55:43.409 INFO Agent started2007-11-28 17:55:44.784 INFO Session recording started9 Foglight Oracle Agent安装9.1 Windows环境下的安装以Administrator登录到被监控主机。（目前对Windows平台上的Oracle，只能本地部署）。1) 打开IE，登录到FMS。2) 打开Administratioin|Agents|Agent Hosts找到相应被监控主机。也可以按Shift进行多选。3) 部署OS Agent。点击Deploy Agent Package，选择Oracle-5-2-1。4) 点击Apply。5) 点击OK关闭部署窗口。6) 创建Oracle Agent。点击Create Agent按钮。7) 选择Agent Type为Oracle，输入代理名称，例如Oracle_DB。8) 点击Apply开始安装。9) 安装完成。10) 安装所有的Agent之后，在被监控主机6上可以看到以下目录：9.2 Unix环境下的安装和Win环境下一样部署。注意，SPID以非root帐号启动。1) 登录FMS。2) 部署Oracle Agent。3) 点击Create Agent创建Agent。其中选择Oracle一项。如果要激活，需要创建用户，见配置一节。10 Foglight Oracle Agent配置10.1 Windows环境下的配置安装完Oracle Agent后