看看高手是如何安装OSA监控精灵的

osapub

== 引言 ==

在执行全手动编译安装之前，您需要掌握一定的LINUX知识，能够手动部署和安装WEB环境，如果有问题，您可以通过其他安装方式进行安装。


热心网友为大家提供了各种安装脚本和文档，由于各自系统环境存在差异，在部署过程中可能有细节上的差异，以下链接仅供参考：

[http://bbs.osapub.com/thread-4022-1-1.html LNMP参考文档]

[http://bbs.osapub.com/thread-4124-1-1.html 针对OSA的安装配置]

== OSA依赖环境 ==

'''操作系统：'''linux redhat/centos 系列

'''PHP版本：'''5.2.0或以上版本

'''MYSQL版本：'''5.0.45 或者以上版本

'''PYTHON版本：'''2.7.2

'''其他需求：'''

1，PHP需要支持模块：pdo_mysql,mbstring,json,curl.

2，PYTHON需要支持模块：DBUtils,pysnmp,pydns,MySQL-python,simplejson.

== 安装步骤 ==

安装之前请确定己经安装配置好WEB环境，数据库环境。

=== 1，检查PHP环境 ===

PHP代码如下：

  <?php
  $php_version=0; //php版本  
  $php_pdo_mysql=0; //php是否支持pdo_mysql  
  $php_mbstring=0; //php是否支持mbstring          
  $php_json=0; //php是否支持pdo_mysql  
  $php_curl=0; //php是否支持mbstring          //检查PHP版本  
  if (strnatcmp(phpversion(),'5.2.0') >= 0){               
      $php_version=1;   }else{               
      $php_version=0;          
  }   //检查php支持   
  foreach(get_loaded_extensions() as $val){   
  if($val == 'pdo_mysql'){       
      $php_pdo_mysql=1;   
   }   
  if($val == 'mbstring'){       
    $php_mbstring=1;   
  }   
  if($val == 'json'){        
    $php_json=1;   
  }   
  if($val == 'curl'){       
    $php_curl=1;   
  }   
  }   
  $c_array = array($php_version,$php_pdo_mysql,$php_mbstring,$php_json,$php_curl);   
  $check_sucess=1;   
  foreach($c_array as $var){       
    if($var==0){                               
      $check_sucess=0;               
       break;   
   }   
  }   
  if($check_sucess==0){ //失败则输出具体模块信息       
    echo "$var not support ,php check faild!";   
   }else{  //成功则可以继续       
    echo "PHP check OK!";   
   }   
  ?>

将以上代码复制，保存为：osa_check.php,上传致WEB目录，访问输出："PHP check OK!",则表示环境没问题！

=== 2,导入数据 ===

首先，创建数据库，创建一个访问mysql的用户,创建数据库和用户的方法很多，下面介绍创建数据库和用户的相关语句：
  
  CREATE DATABASE `osamonitor` DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;
  GRANT ALL PRIVILEGES ON `osamonitor`.* TO osamonitor@'%' IDENTIFIED BY 'osamonitor1688';

以上语句可以创建一个名字为：osamonitor的数据库，指定编码为：utf8，添加一个有增删查改的用户："osamonitor",密码为："osamonitor1688".

接下来开始导入数据：

  mysql -u osamonitor -p'osamonitor1688' -P 3306 osamonitor < /usr/local/osa/ctrlphp/install/osa.sql


上面指令可以将OSA的SQL文件导入数据库，新版本如果有改变文件名称，以最新文件名为准。

以上步骤，请确保无误，如果数据导入失败可以重复执行导入操作，或者将错误提交给OSA官方人员请求帮助。

=== 3,安装python相关程序 ===

以下安装步骤，请自行验证结果，出现问题请上[http://bbs.osapub.com 论坛]寻求帮助。

* 安装wget,bc等包。

  yum -y install wget bc

* 创建临时安装目录，养成良好习惯。

  BASE_PATH=/usr/local/osa
  mkdir -p $BASE_PATH"/tools"  
  cd $BASE_PATH"/tools"

* 开始安装python

  #下载程序，解压并编译安装
  wget http://down.osapub.com/osatools/Python-2.7.2.tgz
  tar xvf Python-2.7.2.tgz
  cd Python-2.7.2
   ./configure --prefix=$BASE_PATH/python
  make && make install
   
  #检查结果,输出结果为0表示安装成功，下面的安装过程同样适用，不再重复。
  echo $?

  #查看版本号
  $BASE_PATH/python/bin/python -V

* 安装python 相关模块

  #安装SETUPTOOLS的函数，为python安装模块提供便利
  wget http://down.osapub.com/osatools/setuptools-0.6c10.tar.gz
  tar xvf setuptools-0.6c10.tar.gz
  cd setuptools-0.6c10  $BASE_PATH/python/bin/python setup.py build   
  $BASE_PATH/python/bin/python setup.py install

  #安装mysql-python,一个python操作数据库的模块
  wget http://down.osapub.com/osatools/MySQL-python-1.2.3.tar.gz
  tar xvf MySQL-python-1.2.3.tar.gz
  cd MySQL-python-1.2.3
  #指定mysql_config路径，这里根据实际情况进行指定
  mysql_config='/usr/local/mysql/bin/mysql_config'
  /bin/sed -i "/mysql_config.path/ s#\"mysql_config\"#\"$mysql_config\"#g" setup_posix.py
  $BASE_PATH/python/bin/python setup.py build
  $BASE_PATH/python/bin/python setup.py install

  #安装simplejson，解析json字符串会用到
  wget http://down.osapub.com/osatools/simplejson-2.6.0.tar.gz
  tar xvf simplejson-2.6.0.tar.gz
  cd simplejson-2.6.0  $BASE_PATH/python/bin/python setup.py build   
  $BASE_PATH/python/bin/python setup.py install
  
  #安装pysnmp相关包，用于采集数据
  wget http://down.osapub.com/soft/pysnmp/{pyasn1-0.1.3.tar.gz,pysnmp-4.2.2.tar.gz}
  tar xf pyasn1-0.1.3.tar.gz          
  cd pyasn1-0.1.3  
  $BASE_PATH/python/bin/python setup.py install
  tar xf pysnmp-4.2.2.tar.gz
  cd pysnmp-4.2.2  $BASE_PATH/python/bin/python setup.py install  

  #安装pydns包，用于DNS查询
  wget http://down.osapub.com/osatools/pydns-2.3.6.tar.gz
  tar xf pydns-2.3.6.tar.gz          
  cd pydns-2.3.6  
  $BASE_PATH/python/bin/python setup.py install

到这里，python相关程序就己经安装完成了，接下来我们下载osa最新tar版本，可以从：www.osapub.com 获取程序包。

  以OSA_BETA V1.0.5为例：
  wget http://www.osapub.com/download/OSA_BETA_V1.0.5.tar.gz
  cd $BASE_PATH  
  #解压文件到$BASE_PATH 目录  
  tar xvf tools/OSA_BETA_V1.0.5.tar.gz

到此为止，所有程序都安装完成，接下来我们开始配置OSA。

=== 4,配置OSA ===

* 文件目录权限配置

  /bin/chmod -R 755 $BASE_PATH
  /bin/chmod -R 777 $BASE_PATH/ctrlphp/data
  /bin/chmod -R 777 $BASE_PATH/ctrlphp/session
  /bin/chmod -R 777 $BASE_PATH/ctrlphp/log
  /bin/chmod -R 777 $BASE_PATH/ctrlphp/etc
  /bin/chmod -R 777 $BASE_PATH/ctrlpy/log
  /bin/chmod -R 777 $BASE_PATH/ctrlpy/etc


* PHP配置文件修改

  #复制一份php配置文件
  cd $BASE_PATH/ctrlphp/etc
  cp osa_config.inc.sample.php osa_config.inc.php  
  #生成产品密钥
  cd $BASE_PATH/ctrlphp/install
  /bin/sh  updatekey.sh
  ###注意:updatekey.sh里的php程序和路径，是指定路径（/usr/local/osa/php/bin/php），您需要自行修改和确认，以确保执行无误。  
  
  vi  osa_config.inc.php
  #检查OSA_SYSTEM_KEY 的值，默认值为：123456789，如果变成了一串随机字符串，说明产品密钥生成成功。
  #修改：OSA_INSTALL_PATH 的值为您的安装路径，例如：/usr/local/osa.
  #修改：OSA_MYSQL_CONN_DNS 的值为您的mysql连接字符串，例如：'mysql:dbname=osamonitor;host=127.0.0.1;port=3306'。
  #修改：OSA_MYSQL_CONN_USER 的值为您的mysql用户名，例如：'osamonitor'。
  #修改：OSA_MYSQL_CONN_PASSWD 的值为您的mysql密码，例如：'osamonitor1688'。

保存并退出，PHP配置文件修改完毕，其他配置项建议保持默认选项。

* PYTHON配置文件修改
  cd $BASE_PATH/ctrlpy/etc
  vi config.py
  #检查或者修改：DIRS 路径为您安装时定义的路径。
  #检查或者修改：MYSQL 为您的数据库连接信息,其中'SIZE'参数建议保留默认值。

保存并退出，PYTHON配置文件修改完毕。

如果有安装客户端，unctrlpy同样检查或者修改config.py里的相关配置，注意：COMMANDS 的内容，服务端与客户端一定要保持一致。

=== 5,启动和运行OSA程序 ===

如果是第一次安装，请设定环境变量和软链接，指令如下：

  #添加环境变量  
  if ! grep $BASE_PATH /etc/profile  
  then            
    echo "PYTHONPATH=$BASE_PATH   
    export PYTHONPATH" >>/etc/profile   
    source /etc/profile  
  fi  
  cd $BASE_PATH"/bin"  
  for f in `ls`  
  do     
      echo $BASE_PATH"/bin/"$f     
      ln -f -s $BASE_PATH"/bin/"$f /usr/local/bin/$f  
  done

执行：osaadmin start 可以启动osa所有程序进程。
osaserver start 可以启动服务端程序进程。
osaclient start 可以启动客户端程序进程。

以上安装过程，如果有问题请上社区提问，如果遇到文档有不完善的地方，欢迎指正。