Fox服务器安装与维护

• 1 Fox服务器介绍
• 2 Fox服务器安装
  • 2.1 Java运行环境安装
  • 2.2 新增用户
  • 2.3 设置用户环境变量
  • 2.4 安装应用
• 3 系统维护
  • 3.1 目录结构
  • 3.2 服务配置
  • 3.3 服务启动&关闭
  • 3.4 查看进程状态
• 4 版本管理
  • 4.1 插件版本管理
  • 4.2 服务资源更新
  • 4.3 移动APP资源更新
• 5 日志查看
• 6 Q&A
  • 6.1 Java运行环境安装与维护

1 Fox服务器介绍

Fox Sever可以用于前端服务器，同时也可用做版本服务器。

2 Fox服务器安装

2.1 Java运行环境安装

检查java运行环境的版本，要求是1.6.31以上。若java环境未安装或版本不正确，请参考后面章节进行java环境安装。

检查方法为：java –version

2.2 新增用户

1. 创建新用户fox

# useradd fox

2. 设置和修改用户fox口令

# passwd fox

根据系统的提示信息输入两次密码，系统会显示： passwd ：:all authentication tokens updated successfully

3. 修改用户信息usermod
4. 新建组群groupadd 也可以通过，直接组合命令新建

#useradd -m -d /home/fox -g fox fox

2.3 设置用户环境变量

1. 修改用户环境变量，服务器不同，用户环境变量文件不同
    Linux: “.bash_profile ”
    AIX:“.profile”
2. 返回到用户根目录
    $cd
3. 修改文件
    $vi .bash_profile
    添加下面内容
    JAVA_HOME=/usr/java/jdk1.6.0_35
    PATH=$JAVA_HOME/bin:$PATH
    export PATH
    PATH=$PATH:$HOME/bin
    export PATH
    export LANG=zh_CN.utf8

2.4 安装应用

1. 使用fox用户将fox.tar上传到服务器/home/fox目录下，以实际拿到的版本为准；
2. 解压缩fox.tar 在命令提示符下输入： tar -xvf fox.tar 解包 chmod –R 755 bip 修改文件权限

3 系统维护

3.1 目录结构

Fox服务端的目录结构为：

    -configuration 配置文件目录
    	-config.ini   eclipse插件配置信息，一般情况无需修改
    	-server.properties  服务端参数配置，服务器启动时加载
       	-logback.xml 日志配置文件，服务器启动时加载
       	-license.lic  license许可文件，服务器启动时判断许可
       	-jdbc.xml   数据库配置文件，服务器启动时加载
    -plugins   服务端插件目录
    -update    客户端更新目录
    	-app APP资源更新目录
    	-plugins 客户端插件，客户端插件更新时使用
    -workspace 交易工程存放目录
    -log 日志目录
    -startup.sh  服务端启动脚本，Linux、AIX系统使用
    -startup.bat  服务端启动脚本，Windows系统使用
    -shutdown.sh  服务端关闭脚本，Linux、AIX系统使用
    -shutdown.bat 服务端关闭脚本，Windows系统使用

3.2 服务配置

服务的配置在文件 configuration/server.properties中，文件中的常用配置项如下：

#是否热部署
cn.com.bankit.phoenix.resource/hotDeploy = true
#激活工程名
cn.com.bankit.phoenix.resource/activeProjectNames = fox_document,fox_base,ninetales,fox_mpa

#socket服务端口
cn.com.bankit.phoenix.communication.server/port=9100
#http服务端口(内部)
cn.com.bankit.phoenix.jetty/http_port=9400
#http服务端口(外部)
cn.com.bankit.phoenix.jetty/outer_http_port=9700
#端口偏移量
Platform/portOffset=0
#核心线程数
Platform/corePoolSize = 30
#最大线程数
Platform/maxPoolSize  = 50
#线程队列大小
Platform/queueSize  = 0
    
#安全配置
#cn.com.bankit.phoenix.security/scope=[http]
cn.com.bankit.phoenix.security/zmk=6118AF701DA14AC28B3FFAC441768500092761B93303C86A5640720AF528A2F6B02FAA60414FF5C5699E64EBD9EF0750AB283C677A3364DFF5D7FA64FD352634
cn.com.bankit.phoenix.security/zpk=6A6C01CA5D3EF646E5ADDF88C7BAFB187863E700EAF01E5D9DE6A9B5117BDE24869B5B2F3AA5304C46675EA63441813A89C822E7A60E58EF8364B8C2134DDDB951A3AF6020AE8C808D7CCCECAFF44BB9DC592F499710CAD706D4BA5DDD2E7DF2CDE32A08A0BD1615714ACA911D39CF5CABE7E5ABD3843AB7CA98B4F8F8F75E7C70743E1ACA6C8467F43A66C68DEB5827FC759A1A99863D1371CD6276BB45A324CC343BF600A97CCAC8020F0B5366DA28A272A6F4CF92016C7E8CBB3E045A90E5040EA59D9F26524B7F8F6D6C5E29F5BEE56653A504ED3A55F0DD97D4A603C35998EFDAF2D16288DE8045D56F7F1A32020EEB05A6B1E1F2A3553B2F68B622328E
    
#jetty web服务是否启用SSL
#cn.com.bankit.phoenix.jetty/sslEnabled=true

3.3 服务启动&关闭

服务启停的脚本在应用的根目录下

服务启动

linux&aix： sh startup.sh

windows： ./startup.bat

服务关闭

linux&aix： sh shutdown.sh

windows： ./shutdown.bat

3.4 查看进程状态

使用命令“ps –ef |grep java |grep fox”可以查询系统中所有通过java命令启动的进程。当Fox Server工作正常的时候，调用命令能够查询到下图中的结果。集群服务中，各个Fox Server进程分别使用“-Dbips=fox_no1”，“-Dbips=fox_no2”进行标识。如果查询结果没有进程，或者缺少了某一个进程，说明运行情况异常，有可能是启动故障或者运行出错，需要查找具体原因。

4 版本管理

4.1 插件版本管理

Fox Server使用的osgi机制，因此服务的功能是通过插件的形式实现的。我们通过插件新增，删除，替换等同步操作，实现服务端的自动升级或版本回退。 更新步骤：

1. 将需要更新的插件放到服务端应用（BIPS）根目录中/plugins/目录下；
2. 重启服务端，插件更新完成。

4.2 服务资源更新

服务资源更新：服务资源，如图片，数据源，lib库，服务等易资源，可通过新增，覆盖，删除服务端应用(Fox)根目录中/workspace/工程名/目录下相应的资源文件实现更新。 更新服务资源： 在生产环境中，所有需要更新的交易资源会被打成一个jar包，将jar包解压到服务端应用根目录下即可。

4.3 移动APP资源更新

移动APP资源目录在服务端应用(Fox)根目录中/upate/app下面，结构如下

-update/app APP资源跟目录
    -workspace  web资源目录
    -configuration APP端参数配置
    -apk android APK更新目录

APP端配置说明 app的配置文件路径为configuraion/client.properties

#交易资源地址
web/mainApp=fox
#回退键事件
#web/backAction=javascript:fox.custom.logout()
#是否启用更新
version/updateEnabled=true
#版本服务器地址
version/address=http://192.144.128.218:9291
#版本服务器连接策略
version/connectPolicy=random
#版本服务器更新策略
version/updatePolicy=options
#更新任务(requestPath,savePath,needRestart)
version/updateTasks = [update/app/configuration/client.properties,configuration/client.properties,true];fox
#APK更新任务(requestPath,savePath)
version/apkUpdateTasks=[update/app/apk,version/apk]

更新步骤：

1. 将需要更新的APP端资源根目录中/update/app/目录下；

5 日志查看

###5.1服务端日志 服务端日志放置在服务端应用根目录中的./log目录下。服务端日志包括应用日志，通信相关日志（communication.log）、上下文相关日志(context.log)、错误日志(error.log)、资源服务相关日志(httpserver.log)、数据库相关日志(jdbc.log)、监控相关日志(monitor.log)、一般日志(out.log)、统一配置服务日志(preference.log)、资源相关日志(resource.log)、服务日志（server.log）、交易日志(trade.log)。

6 Q&A

6.1 Java运行环境安装与维护

6.1.1 Linux系统下Java运行环境安装

1.下载安装文件： http://www.oracle.com/technetwork/java/javase/downloads/jre6-downloads-1637595.html 2.切换至归档目录，执行： ./ jre-6u33-linux-i586.bin 如果显示执行权限不够，请在执行前先确定执行权限； chmod x jre-6u33-linux-i586.bin 或直接用： sh jre-6u33-linux-i586.bin 来执行。 3.在看完License的宣告后，当然是yes,此时就会开始解压，完成后在相同的路径下，会出现一个归档文件，jre-6u33-linux-i586.rpm 4.接着再执行: rpm –ivh jre-6u33-linux-i586.rpm 此时就会进行安装。若出错误信息，说有dependence的问题，则加入--nodeps的option即可。 rpm – ivh jre-6u33-linux-i586.rpm –nodeps 5.完成后，JDK被安装在 /usr/java/jre1.6.33 6.设置路径：export PATH=/usr/java/jre1.6.33/bin:$PATH 7.设置环境变量

    #vi /etc/profile
    PATH=/usr/java/jre1.6.33/bin:$PATH
    JAVA_HOME=/usr/java/jre1.6.33
    CLASSPATH=/usr/java/jre1.6.33/lib/tools.jar
    export PATH JAVA_HOME CLASSPATH

6.1.2 Linux系统下Java版本切换

如果想更换系统环境变量中的java版本号，使用alternatives命令改变当前java javac指向的连接地址即可完成。
alternatives命令所在位置/usr/sbin

使用示例如下： [root@localhost sbin]# ./alternatives –config java 共有 2 个程序提供“java”。 选择    命令 ----------------------------------------------- *+

1           /usr/lib/jvm/jre-1.4.2-gcj/bin/java
2           /usr/java/jdk1.6.0_11/bin/java
按 Enter 来保存当前选择[+]，或键入选择号码：2