Foglight安装使用手册.doc

SFoglight安装使用手册Quest Software2010年7月Prepared by:Name HereQuest Software, IncWhite Paper78目录1产品架构42环境准备52.1Foglight Server52.2历史信息存储库准备52.3被管理机器准备53Foglight安装步骤73.1Foglight Sever安装73.2Foglight Agent安装223.3Foglight Agent创建273.3.1主机代理273.3.2数据库代理323.3.3应用服务器代理434Foglight启动与停止474.1Foglight Server启动与停止474.1.1启动474.1.2停止484.2Foglight Agent启动与停止494.2.1启动494.2.2停止505Foglight备份与恢复505.1Foglight Server备份505.1.1停止Foglight Server515.1.2备份Foglight安装环境515.1.3备份Oracle数据库515.1.4启动Foglight Server515.2Foglight Server恢复515.2.1恢复Foglight安装环境515.2.2恢复Oracle数据库525.2.3启动Foglight Server525.3Foglight Agent备份525.4Foglight Agent恢复536Foglight巡检536.1Foglight Server运行状态536.2Oracle数据库运行状态546.3Foglight Server JVM使用546.4Foglight历史信息存储库546.5Foglight Agent运行状态557Foglight故障处理568仪表板说明588.1Administration588.2Alarm588.3Database588.4Foglight588.4.1Agent仪表板588.4.2Diagnostic-Foglight Agent Manger598.4.3Diagnostic-Log Analyzer598.4.4Diagnostic-Performance598.4.5Schema-Schema Browser仪表板598.4.6Servers-Foglight Data Management仪表板608.4.7Servers-Management Server Metrics仪表板618.4.8Servers-Management Server View仪表板628.4.9Servers-MySQL Database Overview仪表板628.4.10Servers-Persistence Handler Overview仪表板638.5Hosts648.5.1Active Hosts Summary仪表板648.5.2Host Browser仪表板658.5.3Host Monitor仪表板668.5.4Host Resource仪表板678.5.5Host仪表板678.6JavaEE688.7Operaiting System688.8Reports688.9Services688.9.1Domain仪表板688.9.2Object Group仪表板698.9.3Service Builder仪表板698.9.4Service Detail仪表板728.9.5Service Level仪表板738.9.6Service Operations Console748.9.7Services仪表板758.9.8Service（All Alarms）仪表板758.9.9Tier Definition仪表板768.10Configuration778.10.1Data仪表板778.10.2Data Source仪表板778.10.3Definitions仪表板788.10.4Feeds788.10.5User Preferences仪表板781 产品架构Foglight为三层架构，包括：Foglight Management Server（简称为“Foglight Server”）、Foglight历史信息存储库、Foglight Agent（包含通讯进程和收集器）和Foglight控制台。 Foglight Server：部署在单独的PC服务器上，为信息处理和展现引擎。 Foglight 历史信息存储库：采用Oracle 数据库，用于存储收集的信息。 Foglight Agent：安装部署在各个被管理机器上，包括：通讯进程（Foglight Agent Manager）、主机监控代理、数据库监控代理、应用服务器监控代理。 Foglight控制台：浏览器Web模式控制台。2 环境准备2.1 Foglight ServerFoglight Server 需要以下环境：1. 操作系统 PC服务器：Windows 2003 Server 64位、LinuxServer 64位。 内存:8G CPU:双核2G 硬盘:3G2. 端口 PC服务器与被管理应用服务器主机之间端口：41705 PC服务器与被管理机器之间端口：80803. Oracle客户端4. 权限 PC服务器管理员权限5. 浏览器 FireFox Google Chrome2.2 历史信息存储库准备历史信息存储库用于存储Foglight所收集的信息。具体要求为： Oracle数据库10g/11i。 创建DBA权限数据库用户，用于Foglight历史信息存储。其数据表空间为2G（自动扩展）、索引表空间为2G（自动扩展）。2.3 被管理机器准备被管理机器需要准备如下安装环境：1. 权限 被管理主机操作系统管理员权限 针对Oracle数据库，需要主机操作系统管理员及Oracle用户权限 针对Oracle数据库，需要Oracle数据库sys权限（只在安装配置时使用） 针对Oracle数据库，需要创建DBA权限用户及500M数据库表空间 针对应用服务器，需要应用服务器操作系统管理员权限 针对应用服务器，应用服务器需要重新启动2. 端口 如果实现主机和数据库监控，需要开放端口8080 如果实现应用服务器监控，需要开放端口8080和417053. 空间 500M硬盘空间用于安装程序文件 500M临时目录空间用于解压缩4. 其它 安装配置时需要开放FTP 安装配置时需要开放Telnet3 Foglight安装步骤3.1 Foglight Sever安装1. 双击Foglight Server安装文件开始安装。2. 点击下一步。3. 选择遵守协议。4. 选择定制安装。5. 输入安装目录。6. 点击下一步。7. 选择将Foglight Server作为Windows服务运行。8. 选择开始安装。9. 安装进行中。10. 选择foglight缺省管理员用户和口令（foglight/foglight）。11. 选择单机安装。12. 配置Foglight存储库。13. Foglight利用三个表空间：FG_DATA；存储数据。FG_INDEX：存储索引。FG_LOB：存储大对象。14. 创建数据库对象过程中。15. 选择Foglight Server端口。16. 输入License文件。17. 安装进行中。18. 安装完毕，Foglight Server启动成功。19. 安装成功确认。20. Foglight登录界面。21. 上载代理包：通讯进程代理包：FglAM-hpux-ia64-5_5_5.car操作系统代理包：OSCartridge-HP-UXB_11-5_5_4.car数据库代理包：DB_Oracle-5_5_4_517.car应用服务器代理包：Java_EE-5_6_1.car22. 选择上载的代理包。23. 安装成功。3.2 Foglight Agent安装1. 登录进Foglight Server，下载通讯进程安装程序。2. 登录进被监控机器，创建Foglight目录：#/cd /opt#/optmkdir Quest_Software#/optchmod 777 Quest_Software3. 以二进制格式FTP通讯进程安装程序到被监控机器Quest_Sotfware目录下。4. 登录进被监控机器，修改通讯进程安装程序权限。#/cd /opt/ Quest_Software#/optchmod 777 fglam-5_5_5-hpux-ia64.bin5. 安装通讯进程。#/opt/Quest_Software./ fglam-5_5_5-hpux-ia64.bin安装程序解压缩包到临时目录：2010-07-19 18:36:09.000 INFO native Extracting Foglight Agent Manager to a temporary directory2010-07-19 18:36:33.000 INFO native Extraction complete, configuring Foglig Agent Manager2010-07-19 18:36:45.171 INFO Foglight Agent Manager: 5.5.5 (build 555-20100610-1921)选择遵守软件协议：Introduction=This will guide you through the configuration of Foglight Agent Manager.You can cancel this configuration at any time by hitting CTRL+C.At any time you can enter the command back to return to the previous screen.Press to continue.Do you accept the terms of the license agreement? Y/N: Y选择安装目录：Installation Directory=Enter the directory where you want the Foglight Agent Manager to be installed.Install directory (default: /Quest_Software/Foglight_Agent_Manager):/opt/Quest_Software/Foglight_Agent_ManagerThe directory /opt/Quest_Software/Foglight_Agent_Manager does not exist. Would you like to create it? Y/N (default: Y): y主机名称显示：Host Display Name=Foglight Agent Manager identifies itself using the detected host name for thecomputer it has been installed on. This can be overridden below to provide analternate name if the hostname is not stable or is already in use by anothercomputer.Detected Host Name: default:XXXX:Log a warning if the detected host name changes? Y/N (default: Y):输入Foglight Server地址：Foglight Server URLs=Configure the URLs that the Foglight Agent Manager will use to communicate with the Foglight Server. For failover purposes, you can configure multiple URLs.You have the following options: 1) Add a new Foglight Server URL 2) Test connectivity 3) Search for additional HA servers 4) List configured Foglight Server URLs 5) Delete a configured Foglight Server URL 0) Continue with the next stepWhat would you like to do? 1Enter the URL data to add. The Foglight Server URL parameters are specified as comma separated name=value pairs. For example:url=http:/localhost:8080,address=,proxy=http:/proxy.serverURL: :8080The URL has been added.校验Foglight Server地址：You have the following options: 1) Add a new Foglight Server URL 2) Test connectivity 3) Search for additional HA servers 4) List configured Foglight Server URLs 5) Delete a configured Foglight Server URL 0) Continue with the next stepWhat would you like to do? 2Testing connectivity.0%. 100% finished继续安装：You have the following options: 1) Add a new Foglight Server URL 2) Test connectivity 3) Search for additional HA servers 4) List configured Foglight Server URLs 5) Delete a configured Foglight Server URL 0) Continue with the next stepWhat would you like to do? 0其它配置选项，选择缺省即可。Secure Launcher=Some agents require elevated permissions in order to gather the required system metrics. These agents are launched using an external loader to give them the required access.Please see the Foglight Agent Manager documentation for more information on agent security settings.Secure launcher (default: null):There is no launcher configured. Agents that require elevated privileges will not be able to run. Is that acceptable? Y/N (default: Y):配置是否生成自动启动选项：UNIX init.d Script=The Foglight Agent Manager can be configured to start when this host is rebootedby adding an init.d-style script. If the installation is not being done by theroot user, then an init.d installation script will be generated in the/state/default directory for later use. If you choose to have theFoglight Agent Manager run as a different user, that user must already exist onthe system. This user will become the owner of the default state directory andall files within it. If you want to customize the init.d-style script, a copy ofit is saved in /state/default directory * If you choose not to install the init.d script, an * * installation script will still be generated for later use. * * You should still configure the script even if you do not * * plan to install it right now. *Press to continue.确认代理程序运行用户：Enter the user the service will run as (default: root):Select the numeric run levels at which the service will be started.Selecting a run level will toggle it.You have the following options: 2) (selected) 3) (selected) 4) 0) Quit and continue with the next stepWhat would you like to do? (default: 0)Would you like to install the generated init.d script? Y/N (default: Y): n其它配置选项，选择缺省即可。Migrate SPID=Enter the root directory of a previous SPID installation. The Foglight Agent Manager will automatically detect any agents from the old SPID installation and copy them into the new FglAM installation.If this field is left blank, no action will be taken.SPID Root Directory (default: ):安装结束并清除临时文件：Summary=Foglight Agent Manager has been configured and will be copied into its final location.Press to continue.Calculating install size.0%. 100% finishedCopying files.0%. 10%. 20%. 30%. 40%. 50%. 60%. 70%. 80%. 90%. 100% finishedCreated init.d installer script: /opt/Quest_Software/Foglight_Agent_Manager/state/default/fglam-init-script-installer.shFoglight Agent Manager has been successfully installed.2010-07-19 18:43:39.000 DEBUG native Running cleanup routines after exit()called2010-07-19 18:43:39.000 DEBUG native Unlocking PID file2010-07-19 18:43:39.000 DEBUG native Deleting PID file /tmp/10561/state/default/.FoglightAgentManager-XXXX.pid2010-07-19 18:43:39.000 DEBUG native Cleaning up any messaging sockets.#/opt/Quest_Software3.3 Foglight Agent创建3.3.1 主机代理1. 登录进Foglight控制台，进入到左边Dashoard：Administration-Agents-Agent Status。点击Deploy Agent Packages按键，根据需要部署相关代理包： 针对数据库：部署主机代理包和数据库代理包。 针对应用服务器：部署主机代理包和应用服务器代理包。2. 部署代理包成功。3. 点击Create Agent按键，创建主机代理。选择的代理为： DiskIO FileSystem HPUX_Console HPUX_MPStat HPUX_System NIC Process User把Generate Name选择框选上，Foglight会自动创建代理名称。4. 代理创建成功。5. 选择全部主机代理，点击Activate按键激活代理。6. 主机代理创建完成。3.3.2 数据库代理1. 登录进Foglight控制台，进入到左边Dashoard：Databases-Databases。2. 点击Discover Oracle Databases.3. 选择数据库所在主机，并在右下角点击Next。4. 正在发现Oracle数据库。5. 选择自动加载数据库信息或手工添加。6. 输入被监控数据库参数和用户。其中，这个用于监控数据库的用户需要提前创建。7. 对用户进行校验。8. 权限不够，输入具有sysdba权限用户对上一步中的用户进行授权。9. 授权完毕。10. 创建数据库代理。11. 代理创建成功。12. 数据库代理部署完毕。3.3.3 应用服务器代理1. 登录进Foglight控制台，进入到左边Dashoard：Administration-Agents-Agent Status。点击Create Agent按键创建JavaEEDeploymentManager代理。2. 在激活JavaEEDeploymentManager代理之前需要修改其属性。点击Edit Properties按键。3. 选择Modify properties for all JavaEEDeploymentManager agents。4. 修改Java EE agent configuration-Nexus Connections选项，将NexusHost内容修改为Foglight Server的IP地址。5. 保存退出，激活JavaEEDeploymentManager代理。6. 登录到WebLogic所在主机，修改WebLogic启动脚本startWebLogic.sh。在脚本中执行启动WebLogic Server之前，添加如下内容（黑体部分）：# START WEBLOGICecho starting weblogic with Java version:$JAVA_HOME/bin/java $JAVA_VM -version# QUEST_PREINST_OPTS=* OPTIONAL Preinstrumentor Options *# export QUEST_PREINST_OPTSQUEST_DEPLOYMENT_DIRECTORY=/opt/Quest_Software/Foglight_Agent_Manager/agents/JavaEEif -f $QUEST_DEPLOYMENT_DIRECTORY/integrate.sh thenQUEST_JAVA_ENV_OPTS=WEBLOGIC:SERVER. $QUEST_DEPLOYMENT_DIRECTORY/integrate.shelseecho Java EE agent not enabledfiif $WLS_REDIRECT_LOG = ; then echo Starting WLS with line: echo $JAVA_HOME/bin/java $JAVA_VM $MEM_ARGS $JAVA_OPTIONS -Dweblogic.Name=$SERVER_NAME -Djava.security.policy=$WL_HOME/server/lib/weblogic.policy $PROXY_SETTINGS $SERVER_CLASS $JAVA_HOME/bin/java $JAVA_VM $MEM_ARGS $JAVA_OPTIONS -Dweblogic.Name=$SERVER_NAME -Djava.security.policy=$WL_HOME/server/lib/weblogic.policy $PROXY_SETTINGS $SERVER_CLASSelse echo Redirecting output from WLS window to $WLS_REDIRECT_LOG $JAVA_HOME/bin/java $JAVA_VM $MEM_ARGS $JAVA_OPTIONS -Dweblogic.Name=$SERVER_NAME -Djava.security.policy=$WL_HOME/server/lib/weblogic.policy $PROXY_SETTINGS $SERVER_CLASS $WLS_REDIRECT_LOG 2&1fi7. 重新启动WebLogic Server，应用服务器代理部署完毕。4 Foglight启动与停止4.1 Foglight Server启动与停止4.1.1 启动Foglight Server安装在Windows服务器上，安装目录为：D:Quest_SoftwareFoglight。Foglight Server在Windows服务器上以Windows服务（Service）形式运行，服务名称为Forge Server，在Windows Task Manager可以查看到Foglight Server运行程序为fms.exe。Foglight Server在安装时已配置为服务自动启动。如需启动Foglight Server，可在起始菜单中选择Start Service For Foglight，如下图所示：4.1.2 停止停止Foglight Server时可选择如下停止选项：或直接停止Foglight服务即可。在Windows Task Manager确认Foglight Server运行程序fms.exe已停止运行。4.2 Foglight Agent启动与停止4.2.1 启动Foglight Agent包含通讯进程和收集器两部分： Foglight Agent Manger：负责与Foglight Server通讯及管理具体收集器的运行。 收集器：负责收集信息，根据收集指标的不同，收集器名称不同。启动Foglight Agent的步骤为：1. 以Foglight Agent安装用户登录操作系统。2. 进入目录：cd /opt/Quest_Software/Foglight_Agent_Manager/bin3. 运行命令：nohup ./fglam start &，启动Foglight Agent Manager。4. 登录Foglight控制台：:8080。5. 进入到左侧Dashboad：Administration-Agents-Agent Status。6. 选择需要启动的收集器，点击Dashboad下部的激活按键（Activate），待提示启动显示无误（绿色“对号”）后，收集器即正常运行。如下图所示：4.2.2 停止停止Foglight Agent的步骤为：1. 登录Foglight控制台：:8080。2. 进入到左侧Dashboad：Administration-Agents-Agent Status。3. 选择需要启动的收集器，点击Dashboad下部的停止按键（Deactivate），待提示启动显示无误（绿色“对号”）后，收集器应经停止运行。如下图所示：4. 以Foglight Agent安装用户登录操作系统。5. 进入目录：cd /opt/Quest_Software/Foglight_Agent_Manager/bin6. 运行命令： ./fglam stop5 Foglight备份与恢复Foglight Server及存储数据库安装部署在Windows机器上，从完全备份恢复角度讲，应对该机器进行系统级备份。5.1 Foglight Server备份Foglight Server备份步骤包括： 停止Foglight Server 备份Foglight安装环境 备份Oracle数据库 启动Foglight Server5.1.1 停止Foglight Server停止Foglight Server步骤请参阅本手册第2.1章节内容。5.1.2 备份Foglight安装环境Foglight Server在Windows服务器上的安装目录为：D:Quest_SoftwareFoglight。备份Foglight安装环境即备份Foglight-Server整个安装目录。可以使用任一压缩工具创建整个安装目录归档（例如：fogligt_installation.rar）即可。具体步骤如下：1. 进入到目录D:Quest_Software中。2. 利用winRAR或Windows自带的压缩工具备份整个Foglight Server的目录。5.1.3 备份Oracle数据库Foglight在Oracle数据库建有单独的Schema（foglight）存放Foglight配置信息和收集的数据。1. 备份Oracle数据库的具体命令为：cd $ORACLE_HOME/binexp foglight/foglightorcl file=foglight_database.dbdump2. 看到以下提示信息表示备份Oracle数据库成功完成：A dbdump file is created.The backup of the Oracle database is now complete.5.1.4 启动Foglight Server启动Foglight Server步骤请参阅本手册第2.2章节内容。5.2 Foglight Server恢复Foglight Server备份步骤包括： 从备份文件中恢复Oracle数据库 恢复Foglight安装环境 启动Foglight Server5.2.1 恢复Foglight安装环境在Windows服务器上恢复Foglight安装既是将备份的Foglight Server安装目录解压到性相关目录即可。具体步骤如下：1. 确认目录D:Quest_Software是否存在，如果不存在需要手工创建。2. 将备份文件（foglight_installation.rar）解压到目录下，并确认解压后Foglight Server的目录为：D:Quest_SoftwareFoglight。5.2.2 恢复Oracle数据库利用本手册3.1.3章节中备份的归档文件foglight_database.dbdump恢复Oracle数据库。具体步骤如下：1. 登录进Oracle数据库，确认用户foglight是否存在，如果存在，将其删除。以sys身份登录进Oracle：sqlplus /nologconn / as sysdba确认foglight是否存在：SQLselect username from all_users where username like foglight;如果存在，执行以下命令删除foglight用户：SQLdrop user foglight cascade;2. 创建新的foglight用户。SQL create user foglight identified by foglight default tablespace FG_DATA account unlock;SQLGRANT CREATE SESSION TO foglight;SQLGRANT DBA TO foglight;3. 从归档备份文件中恢复数据库。cd $ORACLE_HOME/binimp foglight/foglightorcl file=foglight_database.dbdump full=yes5.2.3 启动Foglight Server启动Foglight Server步骤请参阅本手册第2.2章节内容。登录Foglight控制台：:8080确认Foglight正常工作。5.3 Foglight Agent备份Foglight Agent在被管理机器上的安装目录为：/opt/Quest_Software/Foglight_Agent_Manager。备份Foglight Agent的步骤为：1. 停止Foglight Agent。具体停止步骤请参见本手册地2.2.2章节内容。2. 备份Foglight Agent安装目录。tar cvf Foglight_Agent_Manager foglight_agent.tar3. 启动Foglight Agent。具体停止步骤请参见本手册地2.2.1章节内容。5.4 Foglight Agent恢复利用备份归档在被管理机器上恢复Foglight Agent。恢复Foglight Agent的步骤为：1. 确认目录/opt/Quest_Software是否存在，如果不存在，手工创建并授予相应权限：cd /optmkdir Quest_Softwarechmod 777 Quest_Software2. 备份Foglight Agent安装目录。将备份文件拷贝到目录/opt/Quest_Software 下，解压即可：tar xvf Foglight_Agent_Manager foglight_agent.tar3. 启动Foglight Agent。具体停止步骤请参见本手册地2.2.1章节内容。说明：由于Foglight Agent包含相应主机的配置信息，因此同一机器上的Foglight Agent备份归档不能用于另外的机器。6 Foglight巡检为保证Foglight的正常运行，需要定期对Foglight进行巡检。具体内容包括： Foglight Server运行状态 Oracle数据库运行状态 Foglight Server JVM使用 Foglight历史信息存储库 Foglight Agent运行状态6.1 Foglight Server运行状态确认Foglight Server是否正常运行的步骤如下：1. 进入到Windows Task Manager中确认Foglight Server进程fms.exe正常运行。2. 确认是否可以登录Foglight 控制台界面：:8080。6.2 Oracle数据库运行状态确认Oracle数据库是否正常运行的步骤如下：1. 进入到Windows Task Manager中确认Oracle数据库进程oracle.exe正常运行。2. 确认是否可以登录Oracle数据库管理命令行sqlplus。6.3 Foglight Server JVM使用检查Foglight Server JVM使用状况主要是确认内存堆（Heap）使用状况。具体步骤为：1. 登录Foglight控制台：:8080。2. 进入到左侧Dashboad：Foglight-Servers-Management View。3. 查看视图JVM，检查和对比指标totalMemory和freeMemory，如果freeMemory长期处于非常低的水平，需要增加内存堆大小。6.4 Foglight历史信息存储库检查Foglight历史信息存储库大小，防止Oracle数据库存在空间不足，导致Foglight无法正常运行。具体步骤为：1. 登录Foglight控制台：:8080。2. 进入到左侧Dashboad：Foglight-Servers-Management View。3. 查看视图FMS Database Size，检查Foglight