PeOny入门
PeOny分为服务端和客户端两部分，需要先安装服务端，再安装客户端。
1. 安装PeOny服务端
PeOny支持各Linux/Unix平台和Windows平台，安装步骤如下：
1) Unix/Linux平台安装
解压缩peony4.x.0.x.tar.gz文件，bin_file中包含各Unix、Linux平台peony可执行文件，peonysetup为初始配置程序。
文件清单：
| 文件名 | 说明 |
|---|---|
| peony | Agent可执行文件，提供纯SGA访问WebService接口 |
| peonysetup | 数据字典初始化程序，包括等待事件名称、统计量名称等 |
| peonyclt | 客户端测试程序 |
注意： peony只支持64位oracle，请查看oracle版本，确认是64位ORACLE。
$which sqlplus
$file <PATH>/sqlplus
$which sqlplus
$file <PATH>/sqlplus
1
设置正确的ORACLE_HOME, ORACLE_SID
$export ORACLE_HOME=<CURRENT_ORACLE_HOME> $export ORACLE_SID=<CURRENT_ORACLE_SID> $echo $ORACLE_HOME $echo $ORACLE_SID
说明：ORACLE_HOME必须和启动实例时的ORACLE_HOME完全匹配，可以参照/etc/oratab中的ORACLE_HOME字符串，尤其注意ORACLE_HOME末尾的"/"，可能需要去掉，否则peony无法找到对应的IPC内存段。
2
运行peonysetup
$./peonysetup
说明：该程序生成字典数据，创建conf, data, log目录
3
启动agent
$ln -s bin_file/peony_linux64 peony $./peony -d
终端输出
********************************************************************* PeOny for ORACLE DB, Release 4.0.0.1, build date: 2016.11.24. Copyright (c) 2007, 2016. DBTOOL software. ALL RIGHTS RESERVED. Website: http://www.dbtool.cn Email: dbtool@qq.com WeChat: dbtool QQ group: 235019291 ********************************************************************* Webservice is running on port#[8888], master_socket[6].
说明：-d选项意味着peony将以守护进程运行，想退出的话，直接kill掉。
ps -ef|grep peony kill -9 <pid>
4
PeOny服务端资源占用率查看
说明：请自行查看PeOny进程的CPU和内存占用率，一旦出现异常，请及时联系技术支持。
| OS平台 | 查看方法 |
|---|---|
| Linux/AIX | #ps aux | head -1 ; ps aux | grep peony |
| AIX | $ps aux | head -1 ; ps aux | grep peony |
| HP-UX | $top -d1 -n1 -s1;export UNIX95=1;ps -eopid,sz,vsz,comm,args|grep peony |
| Solaris | $ps -ef|grep peony, 找到pid $prstat -p <pid> 1 1 |
2) Windows平台安装
文件清单：
| 文件名 | 说明 |
|---|---|
| peony.exe | Agent可执行文件，可以通过peonysetup配置成Windows服务，提供纯SGA访问WebService接口 |
| peonysetup.exe | 数据字典初始化程序 |
| peonyclt.exe | 客户端测试程序 |
注意： peony只支持64位oracle，请查看oracle版本，确认是64位ORACLE。
sqlplus / as sysdba
SQL>select * from v$version;
如果是32位的ORACLE，可能会出现如下问题：
sqlplus / as sysdba
SQL>select * from v$version;
如果是32位的ORACLE，可能会出现如下问题：
1
运行peonysetup.exe
$./peonysetup
说明：
- 该程序生成conf, data, log，并可以创建Windows服务。
- 如果Windows下安装了多个版本的ORACLE_HOME，需要把对应的ORACLE_HOME/bin路径加入到Path开始，以便调用正确的oci.dll文件。我的电脑→右键属性→高级→环境变量→系统变量→Path。
2
启动agent
说明：
- 如果已经用peonysetup.exe配置成Windows服务，可以直接在Windows服务中启动Peony服务。
- 如果基于测试目的，未配置Windows服务，可以右键peony.exe，以管理员权限运行该程序，此时peony服务会以控制台方式启动。
3) 服务端配置文件说明
peonysetup会生成conf/peony.ini配置文件，参数说明如下：
| 参数名 | 说明 |
|---|---|
| oracle_home | Oracle主目录 |
| oracle_sid | 要监控的实例SID |
| tcp_port | Web service端口号，默认8888 |
| thread_pool_size | PeOny连接池大小 |
| db_writer | 是否写入历史性能数据到data目录，如果想做历史分析，请启用该参数 |
| db_keep_days | data目录下的历史数据保留天数，默认7天，建议给peony分配单独的文件系统 |
2. 安装PeOny客户端
文件清单：
| 文件名 | 说明 |
|---|---|
| peonyreal.exe | 实时分析界面 |
| peonyhist.exe | 历史分析界面 |
说明：PeOny前端展示目前采用C/S模式，分别提供实时展示和历史分析工具。
3. 客户端基本使用
一旦服务端配置完成，并启动Agent后，客户端就可以连接服务端WebService，并进行图形展示。
1) 实时分析
双击peonyreal.exe文件，打开实时监控界面，选择[连接]→[连接管理器]，打开连接配置窗口。在连接树上右键，可以新建、编辑、删除连接。新建连接指定实例别名，主机名，服务端端口号，服务端端口号默认8888，点击确定，然后双击节点打开连接。
注意： 如果连不上，可能是防火墙问题，可以通过浏览器里输入http://IP:8888来验证服务端连通性。
说明：连接打开后会在底部状态栏显示所连接实例相关信息，包括主机、数据库版本、实例名等，上述为工作量界面。