BuildForge安装部署及操作手册.docx

BuildForge安装和操作手册
一，BuildForge在AIX上的安装
1.安装BuildForge，截取非默认安装步骤。
修改共享目录和安装管理目录安装路径，默认为/opt下，修改为/patch/opt下（根据需要自定义）。

2.修改软件安装路径，由默认/opt下更改到/patch/opt/下（根据需要自定义）

3.指定lisenceServer的地址及端口：

4.配置数据库：

这里是配置所需要的数据库文件，/opt/IBM/db2/V9.7为DB2_HOME。第一个设置需要的库文件，最后一个是设置驱动。

5.设置服务器的域的地址和监听端口、安全端口、初始密码。

点击install安装完成

6.启动buildforge的方法
为H111079:root:/patch/opt/buildforge/rc]./buildforgestart

7.安装client

二，BuildForge Agent安装步骤
1. 首先上传安装文件至指定服务器：aix5-bfagent-7.1.3.0-0-0054.tar.gz
2. 先用gunzip解压成一个tar，然后再用tar解压tar文件，
gunzip aix5-bfagent-7.1.3.0-0-0054.tar.gz
#ls
#aix5-bfagent-7.1.3.0-0-0054.tar
tar -xvf aix5-bfagent-7.1.3.0-0-0054.tar
解压后，到目录中有一个install.sh文件
3. 运行该文件./install.sh，执行安装
在安装的过程中，会有交互性提示，有提示同意licence等条款内容，按照提示的输入Y或者yes之类的，还有安装目录，默认是/usr/bin，都可以更改。

三，BuildForge基本操作整理
1. 登录到操作面板
登录到BF服务器http://10.20.111.79/，到主界面中切换到“控制台”标签页

2. 建立服务器用户认证管理信息
点击左边的“服务器”下的“服务器认证”

2.1 录入服务器认证的信息
点击“添加服务器认证”，在页面下方新建服务器认证区域输入服务器认证的信息，输入完信息后最后要点击“保存服务器认证”按钮

3. 建立服务器信息管理
点击左边的“服务器”，出现服务器列表，点击“添加服务器”按钮，在页面下方新建服务器区域录入服务器信息，输入服务器名称、登录到服务器后的默认路径、主机IP地址及选择认证，即上步中的服务器认证。

4. 把服务器认证和服务器统一管理起来，即选择器
点击左边的服务器目录下的选择器

在名称里输入选择器的名称，点击“保存”到选择器设置页面

在“选择器”详细信息页面中，名称字段中选择BF_NAME，运算符中选择EQ，值为服务器中对应的名称，点击保存，完成服务器认证、服务器和选择器之间的关联。
5. 新建项目
点击左边菜单的项目

点击右边的“添加项目”

在下方界面中录入项目的名称，需要使用的选择器，点击“保存”按钮完成项目的创建。

6. 建立项目的步骤
在项目列表中，点击项目下的超级连接

到项目步骤的创建页面

点击“添加步骤”按钮，在下方输入步骤的名称，命令等，然后点击“保存步骤”
7. 启动项目
点击“启动项目”按钮，即可启动该项目下所有的步骤

如果只需要启动项目中的部分步骤，可以点击步骤前的checkbox，打上X，即不会运行

如果需要调整运行的步骤，则可以点击步骤前的
出现如下菜单

选择要执行的操作
8. 启动项目操作
点击“启动项目”，则可以到启动项目的界面

可以预览即将执行的步骤和命令

点击执行，即可执行项目中的步骤
到启动的初始化界面，如下

准备就绪界面

运行完成界面

点击步骤名称前的超链接，可以查看运行的详细信息

四，BF在AIX上安装问题汇总

1. DB2数据库设置
需要提供DB2的相关参数如下：

在安装之前，先用客户端的数据库连接软件测试数据库连接，以确认数据库方面都准备就绪。
在安装buildforge过程中，需要知道db2jdbc驱动文件，可在数据库的安装目录下执行如下命令查看文件：

2. 安装工具使用

需要在AIX环境上安装XManager图形界面支持参考连接

3. 连接数据库时碰到两个问题：
1. Db2 licence问题，执行命令db2licm –a ./mksysb/db2/db2v97_ese.lic
2. Db2服务名没有设置，王老师设置了一下服务名

4. 安装buildforge需要在图形化界面下安装
在AIX上显示图形化图面，需要先开启CDE服务：
确认启动CDE: #ps –ef|grepdtlogin
启动CDE: #/usr/dt/bin/dtconfig -e
需要执行startx命令:#cd /usr/lpp/X11
startx

5. lanuchpad安装
如果直接启动安装目录下的lanuchpad安装，则需要在AIX环境上安装Firefox。根据IBM售前人员的经验，如果在各系统安装目录下直接执行install命令，则可以绕过firefox带来的一系列问题，我们采用是的直接在系统安装目录下安装的方法。

Firefox引发的问题参考文档

IBM官方上下载Firefox

6. 安装buildforge后重启机器，buildforge会运行不起来的解决方法
ibm_db2.so需要依赖db2中的libdb2.a，需要设置环境变量
export LIBPATH=$LIBPATH:/patch/opt/buildforge/server/apache/lib/php/extensions/no-debug-non-zts-20060613:/opt/IBM/db2/V9.7/lib32
第一个/patch/opt/buildforge/server/apache/lib/php/extensions/no-debug-non-zts-20060613是保证ibm_db2.so能找到，
第二个/opt/IBM/db2/V9.7/lib32保证libdb2.a能够找到。

7. 在AIX安装agent步骤：

[H111079:root:/tmp/bfagent/bfagent-7.1.3.0-0-0054]./install.sh

Welcome to the IBM Rational Build Forge Agent installation script. This script
will install the IBM Rational Build Forge Agent Service.
Press return to continue ...
You must accept the license agreement to install this software.
Enter nothing to display the license, or 'YES' to accept it.
Any other response will terminate the installation.

Do you accept this license? YES

Enter the port number the IBM Rational Build Forge Agent
should listen on. The port number must match the port
number defined in the IBM Rational Build Forge Management
Console. Press return for the default port number of
5555.

Port number [5555]

The "personal-agent" service appears to be using port "5555".
Use this port number anyway? (y/[n])

Enter the port number the IBM Rational Build Forge Agent
should listen on. The port number must match the port
number defined in the IBM Rational Build Forge Management
Console. Press return for the default port number of
5555.

Port number [5555]

The "personal-agent" service appears to be using port "5555".
Use this port number anyway? (y/[n]) y

Enter the directory where the IBM Rational Build Forge Agent
should be installed. Press return for the default of
/usr/local/bin

Installation directory [/usr/local/bin] /patch/opt/buildforge/agent
IBM Rational Build Forge Agent installed in /patch/opt/buildforge/agent
IBM Rational Build Forge Agent Password Encryption Module installed in /patch/opt/buildforge/agent
Created "/etc/bfagent.conf-example" configuration file example.
Created "/etc/bfagent.conf" configuration file using the example.
IBM Rational Build Forge agent added to /etc/services on port 5555
IBM Rational Build Forge Agent definition added to /etc/inetd.conf
***
*** Please verify that the bfagent PAM entries in /etc/pam.conf
*** conform to your local security policies.
***
Sent SIGHUP to inetd process 4784316
IBM Rational Build Forge Agent Installation Complete.
[H111079:root:/tmp/bfagent/bfagent-7.1.3.0-0-0054]

9. 解决bf登录界面乱码问题
(1)：创建数据库必须是utf-8
db2 create DATABASE BUILD USING CODESET UTF-8 TERRITORY US PAGESIZE 16 K AUTOCONFIGURE USING MEM_PERCENT 20 APPLY DB ONLY
(2): db2的codepage必须是utf-8
关键字: codepage 1、db2 变量查看
db2set -all
如果没有设置或者设置的DB2CODEPAGE不是1208，则需要执行下面的命令来设置db2codepage：
db2set DB2CODEPAGE=1208
然后重新启动数据库
(3)：bf里面运行命令
在bf的bin命令行下。
如果是在Buildforge已经安装后设置db2codepage那么需要执行bfschema -r
[H111079:root:/patch/opt/buildforge/Platform]./bfschema -r

10. 启动buildforge注意点
[H111079:root:/patch/opt/buildforge/rc]./buildforge start
使用./buildforge start启动buildforge原因是
./buildforge start 比./start start 多启动一个build 引擎。