CK001201 iUAS安装与配置上机指导书8h

本文格式为Word版，下载可任意编辑——CK001201iUAS安装与配置上机指导书8h

课程CK001201iUAS安装与配置上机指导书

ISSUE1.0

iUAS安装与配置上机指导书

目录

目录

第1章Linux和Oracle的安装1-1

1.1软件准备1-11.2Linux安装1-11.3Oracle9i安装1-31.4创立业务数据库1-4

1.4.1创立主数据库1-41.4.2创立外呼数据库1-9

第2章iUAS的安装2-1

2.1安装中间件平台（APLauncher）2-12.2安装ICDComm2-32.3安装应用服务器（iUAS）2-6

第3章配置及启动3-1

3.1配置环境变量3-1

3.1.1配置iuas_init3-23.1.2配置iuas_alias3-23.1.3生效环境变量3-33.2配置app.ini3-3

3.2.1配置文件说明3-33.2.2配置实例3-103.2.3生成二进制文件3-133.3配置service.cfg3-14

3.3.1配置文件说明3-143.3.2配置实例3-183.4配置iuas.cfg3-21

3.4.1配置文件说明3-213.4.2配置实例3-233.5配置icdcomm.cfg3-25

3.5.1配置文件说明3-253.5.2配置实例3-273.6启动服务及故障排除3-28

第4章使用AppDebug测试iUAS4-1

4.1使用AppDebug4-14.2应用服务器接口语句说明4-4

4.2.1COMMONQUERY4-4

i

iUAS安装与配置上机指导书

目录

4.2.2COMMONUPDATE4-64.2.3COMMONMULTISQL4-64.2.4STOREDPROC(COMMONSP)4-74.2.5SP_SHOULI接口4-9

第5章iUAS调用分析5-1

5.1实例一：查询系统参数表5-15.2实例二：协议接口调用5-55.3实例三：多地市协议接口调用5-7

ii

iUAS安装与配置上机指导书

第1章Linux和Oracle的安装

第1章Linux和Oracle的安装

上机前请先阅读上机指导书，确认了解设备环境和上机过程后再开始试验，上机时请遵守机房管理规定，不明白时请咨询指导教师。本课程总上机时间为8小时。

1.1软件准备

培训环境下，要求学员在各自分派的服务器上安装Linux操作系统和Oracle9i数据库，需要准备的软件有：(1)TurboLinux7.0安装光盘

1.2Linux安装

Linux安装过程较为简单，对于IBMX/DELLPowerEdge系列服务器，Linux7.0安装光盘中自带硬盘驱动，因此，不需要制作驱动软盘。Linux7.0共三张光盘，我们安装只用第一张光盘即可。

将第一张光盘插入光驱内，开机进行安装引导。在安装过程中需要注意的地方有：

分区，不推荐使用自动分区，基本的分区大小推荐为：/boot：64M

/swap：物理内存的2倍/home：6G

/：4G（或剩余空间）/data：剩余空间（可以不用）

在设置X终端时，显示器选择为缺省类型，分辩率选择为800*600或1024*768，选择完成后进行测试，若能出现X终端则表示正常，若为其它，如“超出显示范围〞则为不正常。若在安装时分辩率选择不对，导致X终端不能启动，可以用root身份运行setup工具进行重新设置。安全级别选择为中级。安装组件选择所有的软件包。

1-1

iUAS安装与配置上机指导书

第1章Linux和Oracle的安装

TurboLinux的安装根据机器性能不同，大约需要30分钟左右。Linux安装完成后，需要做以下几步设置：IP地址、机器名称设置

先用ifconfig–a查看是否所有网卡均已驱动，一般unix中缺省只有lo一个网络接口，若运行ifconfig–a出现有如：eth0、eth1等接口，则说明卡已驱动，可以作下一步设置。

然后用netcfg工具进行IP地址的配置，netcfg工具界面如下：

移动光标进入“网络界面〞（NetworkInterfaces）中，寻常只有一个lo的接口，移动光标到增加按钮上，回车将eth0或eth1接口增加进来，然后移动光标到编辑(edit)按钮上，回车后即可设置IP地址、网关等，确定后需要对网卡进行激活。

服务器的机器名、DNS服务器在netcfg工具中的“基本设置〞（BasicSettings）中修改。

设置完成后，可以ping通其它机器IP。开放FTP、TELNET服务

FTP、TELNET服务在安全级别选择为中级时是不会缺省开放的，需要我们进行一定的设置。以下是设置开放FTP、TELNET服务的步骤：

(1)用vi编辑文件/etc/hosts.deny，将文件中的ALL：ALL前加＃，解释掉。

1-2

iUAS安装与配置上机指导书

第1章Linux和Oracle的安装

(2)用vi编辑文件/etc/hosts.allow，将文件中的ALL：改为ALL：

ALL

(3)用vi编辑文件/etc/xinetd.d/telnet，将文件中的disable=yes改为disable

=no

(4)用vi编辑文件/etc/hosts，将机器名与IP的对应参与（注意，是新增一

行，IP地址和机器名按实际配置，不要重复）文件，如：72DPiUAS01

运行setup工具，移动光标选择“系统服务管理〞，敲空格选择ProFTPd和TELNET，最终确定。

在不重启机器的状况下，需要以root用户执行：#xinetd#proftpd

以上命令为载入Telnet和Ftp服务。

若要让root用户telnet，则需要在/etc/pam.d/login中将authrequired/lib/security/pam_securetty.so解释掉

Linux安装完后，可以以root用户登录，输入startx来启动KDE图形桌面。

1.3Oracle9i安装

Oracle9i若用安装盘进行安装，大约需要2个小时，为节省安装时间，我们将Oracle9i运行程序打包成一个tar文件，该tar文件包含了：Oracle的运行程序、Oracle的系统数据库。以下是安装包的安装方法：以root用户登录服务器，建立dba用户组及oracle9用户：

[root@DPiUAS01/root]#groupadddba

[root@DPiUAS01/root]#useraddoracle9–gdba

然后设定oracle9用户的密码：

[root@DPiUAS01/root]#passwdoracle9

以icd/icd用户登录ftp服务器(43)，下载/iUAS/oracle.tar.gz文件到服务器，因文件较大，建议存放在/data目录下。

将oracle.tar.gz解压：gunziporacle.tar，解压后的文件大约为2.7GB。以root用户身份释放tar文件（一定要在/下执行）：

1-3

iUAS安装与配置上机指导书

[root@DPiUAS01/root]#cd/[root@DPiUAS01/]苏-

第1章Linux和Oracle的安装

解压完成后，Oracle9i数据即可以使用，Oracle9i的数据库的SID及数据库名称均为ora92，listener的侦听端口为1521，sys用户口令为sys，system用户口令为system。

Oracle9i数据库常用命令：启动数据库

以oracle9用户登录操作系统：

[oracle9@DPiUAS01oracle9]$sqlplus“/assysdba〞SQL>startup

关闭数据库

以oracle9用户登录操作系统：

[oracle9@DPiUAS01oracle9]$sqlplus“/assysdba〞SQL>shutdownimmediate

启动listener：

以oracle9用户登录操作系统：

[oracle9@DPiUAS01oracle9]$lsnrctlstart

关闭listener：

以oracle9用户登录操作系统：

[oracle9@DPiUAS01oracle9]$lsnrctlstop

1.4创立业务数据库

假定ICD3.0平台的数据库已经创立，且可以从网络访问。

创立业务数据库分两个步骤：创立主业务数据库和创立外呼数据库。

1.4.1创立主数据库

创立业务数据库过程在Windows客户端进行，建议使用PL/SQLDeveloper，也可以使用SQL*Plus：

1-4

iUAS安装与配置上机指导书

第1章Linux和Oracle的安装

步骤1、创立存放数据文件目录

培训环境中，数据库创立在与iUAS同一部TurboLinux主机上，建议将要创立的数据文件存放在/data下面，例如：/data/SCDB，这个目录需要提前创立。

[root@DPiUAS01/root]#cd/data[root@DPiUAS01/data]#mkdirSCDB

[root@DPiUAS01/data]#chownoracle9:dbaSCDB

步骤2、修改脚本

获取数据库脚本，根据建立的文件目录的路径修改脚本“1.创立表空间及回滚段.orasql〞：

使用UltraEdit或NotePad开启脚本文件“1.创立表空间及回滚段.orasql〞，要创立的数据文件分别以rlv_dat01～rlv_dat14命名，依照实际状况更改这些文件的目录。

数据库脚本默认创立数据文件需要磁盘空间大约是26GB，在培训环境中，假使磁盘空间不足，就要调整表空间大小，方法是调整各表空间中数据文件的大小，建议各表空间大小的最低值为：SERVICE_MAIN_DAT800MSERVICE_MAIN_IDX500MSERVICE_LOG_DAT2000MSERVICE_LOG_IDX200MSERVICE_HIST_DAT1500MSERVICE_HIST_IDX300MSERVICE_TEMP200M调整之后总共使用5.5G硬盘空间。

不用创立回滚表空间SERVICE_RBS和回滚段SERVICE_RBS01～SERVICE_RBS20，由于Oracle9i使用自动管理回滚表空间，可以通过检查数据库参数证明：

[oracle9@DPiUAS01oracle9]$sqlplus\SQL>showparameterundo_management

NAMETYPEVALUE

undo_managementstringAUTO

参数undo_management的值为AUTO说明数据库采用了自动管理回滚表空间的方式，不需管理员创立回滚表空间和回滚段。

1-5

iUAS安装与配置上机指导书

第1章Linux和Oracle的安装

?说明：

?

?

?

在培训环境创立数据库时，脚本中涉及回滚表空间和回滚段的部分都需要解释掉。

删除表空间的语句缺省是被解释掉的，需要重建数据库时，可以去掉解释行。

做删除操作前，一定要确认目标不是在线服务的数据库服务器，切记。

步骤3、创立表空间

在Windows客户端使用Net8Assistant（Oracle8i）或NetManager（Oracle9i）新建数据库服务名，或者直接编辑客户端的tnsnames.ora文件新建数据库服务名。

启动PL/SQLDeveloper，以sys用户（sysassysdba）登录到相应的Oracle服务器，选择[File/New/CommandWindow]菜单，进入命令执行窗口，加载以下脚本文件：

?

“1.创立表空间及回滚段.orasql〞

?说明：加载方法有两种：

??

将脚本文件内容拷贝到Editor页签下，单击按钮。

在“SQL>〞命令符后键入命令“@脚本文件路径\\脚本文件名称〞，例如：@d:\\1.创立表空间及回滚段.orasql。

加载完成后，可以查询数据文件生成的状况。

[root@DPiUAS01/root]#cd/data[root@DPiUAS01/data]#llSCDB

-rw-r1oracle9dba314580992Sep711:06rlv_dat01-rw-r1oracle9dba314580992Sep711:06rlv_dat02-rw-r1oracle9dba314580992Sep711:06rlv_dat03-rw-r1oracle9dba314580992Sep711:06rlv_dat04-rw-r1oracle9dba314580992Sep711:06rlv_dat05-rw-r1oracle9dba943726592Sep711:06rlv_dat06-rw-r1oracle9dba943726592Sep711:06rlv_dat07-rw-r1oracle9dba943726592Sep711:06rlv_dat08-rw-r1oracle9dba314580992Sep711:06rlv_dat09-rw-r1oracle9dba314580992Sep711:06rlv_dat10-rw-r1oracle9dba1572872192Sep711:06rlv_dat11-rw-r1oracle9dba524296192Sep711:06rlv_dat12-rw-r1oracle9dba524296192Sep716:31rlv_dat13

1-6

iUAS安装与配置上机指导书

第1章Linux和Oracle的安装

步骤4、创立用户及授权

以sys用户登录到PL/SQLDeveloper，选择[File/New/CommandWindow]菜单，进入命令执行窗口，加载以下脚本文件：

?

“2.创立用户及授权.orasql〞

步骤5、创立数据库对象

以icdmain用户（asnormal）登录到PL/SQLDeveloper（口令为icd），选择[File/New/CommandWindow]菜单，进入命令执行窗口，按顺序加载以下脚本文件：

???

“3.创立表、视图及序列.orasql〞“4.创立存储过程及函数.orasql〞“6.创立定时任务.orasql〞

?说明：

一定要切换到icdmain用户加载脚本，切记。步骤6、初始化数据

以icdmain用户登录到PL/SQLDeveloper，选择[File/New/CommandWindow]菜单，进入命令执行窗口，加载以下脚本文件：

?

“5.创立初始化数据.orasql〞

?说明：

初始化数据比较费时，在保持网络连接的前提下，可以同时完成其他上机工作。

步骤7、创立数据库链接

首先确定ICD3.0平台数据库（UIDB）的链接信息，例如：

?

数据库服务器名/IP地址：67数据库监听服务端口号：1521数据库类型及版本：Oracle8.1.7数据库服务名：ora817UIDB的用户名/口令：icd/icd

?

?

?

?

依照以下格式在tnsmanes.ora文件中添加UIDB的网络服务名，该文件的位置在/home/oracle9/app/oracle/product/9.0.2/network/admin目录下：

1-7

iUAS安装与配置上机指导书

[root@DPiUAS01/home]#chmod755icdcomm[root@DPiUAS01/home]#chmod755oracle9

第2章iUAS的安装

再测试进入目录，OK：

[iuas@DPiUAS01~]#cdaplchr[iuas@DPiUAS01~/aplchr]#

2-9

iUAS安装与配置上机指导书

第3章配置及启动

第3章配置及启动

本章详细介绍了应用服务器的环境变量和四个配置文件的配置，以及如何启动应用服务器。

表3-1给出本章描述内容列表：

表3-1配置及启动应用服务器任务列表

任务操作章节号设置环境变量依据不同的sh，对iUAS系统提供的“iuas_alias.csh〞、“iuas_init.csh〞、3.1“iuas_alias.ksh〞、“iuas_init.ksh〞文件进行编辑，设置系统的环境变量。介绍了app.ini文本配置文件中各配置项的含义并给出app.ini配置例如。介绍了如何把app.ini文本文件转换成二进制文件。介绍了service.cfg文本配置文件中各配置项的含义并给出service.cfg配置例如。介绍了iuas.cfg文本配置文件中各配置项的含义并给出iuas.cfg配置例如。介绍了icdcomm.cfg文本配置文件中各配置项的含义并给出icdcomm.cfg配置例如。介绍如何启动iUAS系统，以及启动的先后顺序。配置app.ini3.2配置service.cfg3.6配置iuas.cfg配置icdcomm.cfg启动iUAS系统

3.1配置环境变量

环境变量例宛如iUAS系统软件包一起发放，保存在“/home/iuas/bin〞目录下。该目录下与环境变量有关的文件有四个（实际版本只提供了前两个）：

????

iuas_alias.cshiuas_init.cshiuas_alias.kshiuas_init.ksh

其中的“iuas_alias.csh〞、“iuas_init.csh〞用于csh环境，“iuas_alias.ksh〞、“iuas_init.ksh〞用于ksh环境。

3-1

iUAS安装与配置上机指导书

第3章配置及启动

3.1.1配置iuas_init

假使使用csh，则修改“iuas_init.csh〞。

假使安装时是依照本书的建议的目录进行安装和设置的，那么除了“WSNADDR〞外，文件中的其它环境变量的设置都不再需要更改了。当然假使安装时不是依照本书的建议的目录进行安装和设置，则需要根据实际规划的目录状况修改相关环境变量。“iuas_init〞文件中每个环境变量的含义已经在文件中给出说明，这里就不再赘述了。下面只对“WSNADDR〞变量的配置进行说明：

假设，WSNADDR的IP地址是72，端口号是10800。“iuas_init.csh〞修改如下：

[iuas@DPiUAS01~/bin]#viiuas_init.csh

setenvWSNADDR//72:10800#WSL（WorkStationListener，侦听和分发客户端的连接的接口进程）监听地址和端口，需依据实际安装环境修改

3.1.2配置iuas_alias

为便利操作，iUAS系统提供了“iuas_alias〞文件，用于设置命令的别名。通过设置和使用别名，用户可减少字符输入量，因而提高工作效率，同时也可避免大量输入过程中带来的错误。

用户可以依据自己的实际状况决定是否使用此文件。“iuas_init〞文件缺省使用“iuas_alias〞文件，假使不想使用此文件，应修改“iuas_init〞文件，解释相关内容。

对于“iuas_init.csh〞，解释掉“source${IUAS_DIR}/bin/iuas_alias.csh〞：

[iuas@DPiUAS01~/bin]#viiuas_init.csh#执行快捷命令设置文件#source${IUAS_DIR}/bin/iuas_alias.csh

用户也可以修改“iuas_alias.csh〞文件，使文件中定义的别名更符合用户的使用习惯和便利记忆。

别名的设置方式为“alias别名原名〞。例如：aliasll'ls-l'，就是把“ls-l〞设置为“ll〞，这样以后敲击“ll〞，就表示“ls-l〞。

3-2

iUAS安装与配置上机指导书

第3章配置及启动

3.1.3生效环境变量

完成上面的设置后，对于csh用户，在iUAS用户目录下的“.login〞或“.cshrc〞（实际为.tcshrc）文件的末尾增加“source${HOME}/bin/iuas_init.csh〞语句，并重新执行“.login〞或“.cshrc〞，使环境变量生效。

%vi./.cshrc[iuas@DPiUAS01~]#vi./.tcshrc#使iuas_init.csh文件被执行source${HOME}/bin/iuas_init.csh或source/home/iuas/bin/iuas_init.csh%source./.cshrc[iuas@DPiUAS01~]#source./.tcshrc

3.2配置app.ini

3.2.1配置文件说明

为了便于描述，本书把APLauncher中间件开发平台的文本配置文件称为app.ini，用户可以依据自己的习惯定义这个文件具体的文件名。app.ini配置文件由RESOURCE、MACHINES、GROUPS、SERVERS、SERVICES、ROUTING六部分组成。各配置小节相互间的关系如图3-1所示：*RESOURCE????ó|ó???*MACHINES??ú÷??D??￠*GROUPSé?×?D??￠*SERVERSìD3ò??????D??￠*SERVICES|?1ü??????D??￠图3-1各配置小节相互间的关系3-3iUAS安装与配置上机指导书

第3章配置及启动

一个应用系统可由一台或多台机器组成。一台机器中可有一个或多个GROUP（组）。一个组又有一个或多个SERVER（服务）组成。一个SERVER寻常由一个或多个SERVICE（基本服务）组成。

注意：

??

app.ini文件的配置项区分大小写。

配置文件中配置的数字，假使是以0开头，则认为此配置的数字是八进制，校验规则就是八进制数校验规则；假使是以0x开头，则认为此配置的数字是十六进制，校验规则以十六进制为准；其余状况认为配置的数字是十进制，校验规则以十进制为准。

1.配置RESOURCES

RESOURCES节设置应用服务器的基本信息，包括规律机器名、最大服务数等。

RESOURCE节配置例如：

*RESOURCESIPCKEYMASTERMAXACCESSERSMAXSERVERSMAXSERVICESMODELLDBAL

37398iUAS300100100SHMY

RESOURCES节配置项如表3-2所示。

表3-2RESOURCES节配置项说明

设置项*RESOURCES描述表示RESOURCES节，此配置项无需修改。创立核心的共享内存等进程间通讯资源必需的键值。取值为界于32770和16777215之间的整数。该值必需设置。注意：要求该值与系统中其它程序此配置项取值不同。可用ipcs–m命令查看当前系统中已经被设置的IPCKEY的值。为本机的规律机器名，该值必需设置。MASTER该规律值是在MACHINES节配置项LMID设置的值。例如：iuas1LMID=iUAS，则iuas1为实际的机器名，iUAS为规律机器名。IPCKEY3-4

iUAS安装与配置上机指导书

设置项描述第3章配置及启动

包括APLauncher客户端、服务端所有进程在内的最大进程个数，一定要大于MACHINES节的MAXWSCLIENTS。应当大于座席MAXACCESSERS个数加上service的个数。例如：有200个座席，则此值配置为200＋100=300。MAXSERVERSMAXSERVICES本机可同时启动服务的最大数。建议值100。本机中可同时调用MAXSERVICES的最大数。建议值100。系统的组成模式。可以为SHM（SharedMemory），即单机模式。MP（MultiProcess），即多机模式。此处固定设置为“SHM〞。LDBAL服务器负载是否均衡。MODEL

2.配置MACHINES

MACHINES节描述应用服务器所在机器的状况。MACHINES节配置例如：

*MACHINESiuas1

LMID=iUAS

APPDIR=\

APLCONFIG=\APLDIR=\ENVFILE=\ULOGPFX=\MAXWSCLIENTS=200TYPE=\

MACHINES节配置项如表3-3所示。

表3-3MACHINES节配置项说明

设置项*MACHINES描述表示MACHINES节，此配置项无需修改。为了便于APLauncher系统读取和动态配置，APLauncher的配置文件有文本和二进制两种形式。文本形式的供用户使用，二进制的供系统和用户程序使用。本配置项就是指明二进制配置文件所在的绝对路径。该路径即为应用服务器配置文件的路径，文件名固定为“aplconfig〞。APLauncher系统在本机器上的安装路径，必需为绝对路径。应用服务器服务程序所在的路径，必需为绝对路径。APLCONFIGAPLDIRAPPDIR3-5

iUAS安装与配置上机指导书

设置项描述第3章配置及启动

是应用服务器使用的环境文件，该文件寻常在应用服务器的安装路径/bin下，文件名固定为envfile。指定路径时要指定绝对路径。ENVFILE注意：ENVFILE必需保证与iuas_setup.csh（或iuas_setup.ksh）中的envfile设置一致，否则无法启动服务。MAXWSCLIENTS同时允许接入的客户端数，应不小于座席个数。TYPE本机器的操作系统类型。有HP及AIX两种（实际配置为linux-i686）。设置物理机器名及规律机器名，设置方法如下：主机名LMID=规律名主机及LMID设置例如：iuas1LMID=iUAS，则iuas1为实际的主机名，iUAS为规律机器名。说明：可以利用hostname取得主机名。

3.设置GROUPS

在本系统中把提供一致服务的程序归为一组。同一个组的程序分布在同一台机器上。组同数据源一一对应，一个数据源对应一个组。GROUPS节配置例如：

*GROUPSDEFAULT:GROUP1GROUP2GROUP3GROUP4

LMID=iUASGRPNO=1GRPNO=2GRPNO=3GRPNO=4

TMSNAME=\

TMSCOUNT=2

GROUPS节配置项如表3-4所示。

表3-4GROUPS节配置项说明

设置项*GROUPS描述表示GROUPS节，此配置项无需修改。设置GROUPS节配置项的缺省配置。假使某个组没有对某个配置进行描述，则使用此处设定的值。例如：例如中，4个组的LMID、TMSNAME和TMSCOUNT都使用在DEFAULT处设定的值。组的规律名称。GROUPNAME例如：例如中的GROUP1、GROUP2和GROUP3。LMID组所在的机器的规律名称。该规律值是在MACHINES小节LMID设置的值。DEFAULT3-6

iUAS安装与配置上机指导书

设置项GROUPNO描述第3章配置及启动

组号，用来唯一标识一个组，在同一台机器上组号不能重复。例如：例如中的GRPNO=1、GRPNO=2、GRPNO=3。TMSNAME事务管理进程的名字，APLauncher提供的默认事务管理进程的名称为“TMS〞。启动的事务管理进程的个数。TMSCOUNT假使资源允许，启动的事务管理进程的个数越大越好，但是个数限定在2～10之间。

4.设置SERVERS

在SERVERS节中设置iUAS系统提供的各种服务。一个SERVER就是iUAS系统提供的一个服务进程。SERVERS节配置例如：

*SERVERSDEFAULT:

#RESTART=YWSL

SRVGRP=GROUP1

SRVID=1000

MAXGEN=50

CLOPT=\

#PortalServer#

CLOPT=\

DBServer

SRVGRP=GROUP1

SRVID=1000

MIN=5

MAX=5

SRVGRP=GROUP1

SRVID=50

MIN=5

MAX=5

CLOPT=\

DBServer

SRVGRP=GROUP2

SRVID=1100

MIN=5

MAX=5

CLOPT=\

DTServer

SRVGRP=GROUP3

SRVID=20

MIN=5

MAX=5

CLOPT=\

DTServer

SRVGRP=GROUP4

SRVID=50

MIN=5

MAX=5

CLOPT=\

3-7

iUAS安装与配置上机指导书

第3章配置及启动

“WSL〞服务的参数与其他服务略有不同，其配置项只有“SRVGRP〞和“SRVID〞，并且CLOPT的设置也有所不同。SERVERS节配置项如表3-5所示。

表3-5SERVERS节配置项说明

设置项*SERVERSDEFAULTSERVERNAME取值是PortalServer、DBServer、DTServer、WSL之一。服务所隶属的组的名字。SRVGRP取值是GROUPS节设置的GROUPNAME值。WSL和PortalServer可以隶属于任何已经在GROUPS节设置的组名。服务ID，服务程序在服务组中的唯一标志。在同一个组中SVRNAME可以重复。SVRID不可以重复，取值范围：[1，30000]，但DTserver的SVRID取值范围是[1，255]。启动的实例的最小个数。即本服务程序需要启动的最小个数。依据以下公式计算：PortalServer的个数=min(客户端的总数/50,2*cpu个数*(cpu主频/500Mhz))MINDBServer的个数=min(客户端的个数/10,3*cpu个数*(cpu主频/500Mhz))DTServer的个数=min(客户端的个数/10,5*cpu个数*(cpu主频/500Mhz))上面公式中，客户端的个数表示同时访问同一个数据源的最大可能个数。启动的实例的最大个数。即本服务程序可以启动的最大个数，系统会根据负载状况自动增加启动本服务程序的个数，总的个数最大不超过本参数的设定值。该值建议和MIN相等。应用服务器异常终止后是否可以被APlauncher应用程序拉起。配置为“Y〞表示应用服务器可以被自动拉起，设置为“N〞表示应用服务器不能被自动拉起。寻常设置为“Y〞。应用服务器异常终止后，在一天范围内，允许被自动拉起的次数。设置50即可。描述表示SERVERS节，此配置项无需修改。对各个Server都要用到的配置项进行设置。服务程序的名字，也即可执行文件的名字。SRVIDMAXRESTARTMAXGEN3-8

iUAS安装与配置上机指导书

设置项WSL的启动参数例如为：描述第3章配置及启动

CLOPT=\其中，18为WSL所在机器的IP地址，25000为WSL侦听端口号。WSL端口号的取值范围是[10000，30000]。-m指定启动WSH（WorkStationHandler）的最小个数，在APlauncher系统启动时将有m个WSH被拉起。该值应不少于SERVICE的个数。建议值为座席平均同时访问数。-M指定启动WSH的最大个数，超过最小个数的WSH将由WSL根据客户端的接入状况自动增加拉起。推荐值为座席最大同时访问数。最多启动个数乘上一个WSH最多服务的客户端数所得的积不得少于客户端总数。-x指定一个WSH最多可以代理的远程客户端的个数，取值在5～10之间的整数，建议取5。其它SERVER的启动参数例如：CLOPT=\-s指数据源的名称。注意：这个数据源名称要与后面讲到的service.cfg和iuas.cfg中的数据源名称保持一致。CLOPT

5.设置SERVICES

是iUAS系统中一个服务进程提供的基本服务单元。用于完成一项功能。SERVICES节配置例如：

*SERVICESDBService

DTService

ROUTING=DtLabelROUTING=DbLabel

SERVICES节配置项如表3-6所示。

表3-6SERVERS节配置项说明

设置项*SERVICES描述表示SERVICES节，此配置项无需修改。服务程序的名字，也即可执行文件的名字。SERVICENAME由于只有DBServer和DTServer访问数据库，所以此配置项取值是DBServer和DTServer之一。ROUTINGLABEL路由字段名称。

3-9

iUAS安装与配置上机指导书

第3章配置及启动

6.设置ROUTING

在进行数据库调用时，可以对每个数据源指定调用的组，假使需要通过SQLAPI直接访问多个数据库时，必需设置路由信息。ROUTING节配置例如：

*ROUTINGDbLabel

DtLabel

FIELD=DSLabel

RANGES=\BUFTYPE=\FIELD=DSLabel

RANGES=\BUFTYPE=\

设置路由信息如表3-7所示。

表3-7ROUTING节设置项说明

设置项*ROUTINGROUTINGLABEL描述表示ROUTING节，此配置项无需修改。路由标识，与在SERVICES指定的ROUTINGLABEL相对应。路由字段，该名称固定为“DSLabel〞，不能修改。FIELD注意：该值区分大小写，该值设置错误将导致BBL（BulletinBoardLiaison，）服务无法启动。路由范围，设置方法为：“数据源名称:组名〞，每个路由之间用“,〞（半角逗号）分割。RANGES此处的数据源名称与SERVER节中配置的数据源名称相对应。该名称与后面介绍的service.cfg和iuas.cfg中的数据源名称应保持一致。路由类型，即应用服务器使用的路由描述文件，固定为TBL32。BUFTYPE

3.2.2配置实例

app.ini配置文件例如随iUAS系统软件包一起发放，保存在“/home/iuas/etc〞目录下，用户可依据实际环境和需求在提供的例如上直接修改，减少工作量。举例：应用服务器需要通过DBService访问数据库ICDLOCAL和WEBICD，通过DTService访问ICDFEP和ICDREMOTE，ICDFEP的IP地址是00，ICDREMOTE的IP地址是20。对于上述4个

3-10

iUAS安装与配置上机指导书

第3章配置及启动

数据源划分4个组，依据3.2.1节介绍的各节的配置，则app.ini配置文件如下：

[iuas@DPiUAS01~/etc]#viapp.ini

##--#iUASV1.1D301--#APLauncherVersion--#Copyright2023-2023HuaweiTechnologiesCo.,Ltd.--#--#

*RESOURCESIPCKEY37398MASTERiUASMAXACCESSERS300MAXSERVERS100MAXSERVICES100MODELSHMLDBALY

*MACHINES

iuas1LMID=iUASAPPDIR=\

APLCONFIG=\APLDIR=\

ENVFILE=\ULOGPFX=\MAXWSCLIENTS=200TYPE=\

*GROUPSDEFAULT:LMID=iUASTMSNAME=\TMSCOUNT=2GROUP1GRPNO=1GROUP2GRPNO=2GROUP3GRPNO=3GROUP4GRPNO=4

*SERVERSDEFAULT:RESTART=YMAXGEN=50WSLSRVGRP=GROUP1SRVID=1000

CLOPT=\

PortalServerSRVGRP=GROUP1SRVID=50MIN=5MAX=5CLOPT=\

DBServerSRVGRP=GROUP1SRVID=1000MIN=5MAX=5CLOPT=\

DBServerSRVGRP=GROUP2SRVID=1100MIN=5MAX=5CLOPT=\

DTServerSRVGRP=GROUP3SRVID=20MIN=5MAX=5CLOPT=\

DTServerSRVGRP=GROUP4SRVID=50MIN=5MAX=5CLOPT=\

*SERVICESDBServiceROUTING=DbLabelDTServiceROUTING=DtLabel

*ROUTING

3-11

iUAS安装与配置上机指导书

第3章配置及启动

DbLabelFIELD=DSLabelRANGES=\BUFTYPE=\DtLabelFIELD=DSLabelRANGES=\BUFTYPE=\

实际配置为（有底色部分为需要修改的地方）：

*RESOURCES

IPCKEY248556MASTERsimpleMAXACCESSERS1000MAXSERVERS100MAXSERVICES100MODELSHM#LDBALY

*MACHINES

DPiUAS01LMID=simpleAPPDIR=\

APLCONFIG=\APLDIR=\ENVFILE=\MAXWSCLIENTS=600TYPE=\

ULOGPFX=\

*GROUPS

DEFAULT:LMID=\GROUP1GRPNO=1GROUP2GRPNO=2GROUP3GRPNO=3GROUP4GRPNO=4

*SERVERSDEFAULT:

RESTART=YMAXGEN=50

WSLSRVGRP=GROUP4SRVID=1000CLOPT=\

3-12

iUAS安装与配置上机指导书

5\

第3章配置及启动

PortalServerSRVGRP=GROUP1SRVID=50MIN=3MAX=3CLOPT=\

DBServerSRVGRP=GROUP1SRVID=1000MIN=3MAX=3CLOPT=\

DBServerSRVGRP=GROUP2SRVID=1100MIN=3MAX=3CLOPT=\

DTServerSRVGRP=GROUP3SRVID=20MIN=3MAX=3CLOPT=\

DTServerSRVGRP=GROUP4SRVID=90MIN=3MAX=3CLOPT=\

*SERVICESDBService

ROUTING=DbLabelDTService

ROUTING=DtLabel

*ROUTING

DbLabel

FIELD=DSLabel

RANGES=\BUFTYPE=\

DtLabel

FIELD=DSLabel

RANGES=\BUFTYPE=\

3.2.3生成二进制文件

完成app.ini配置文件的编写后，需要把这个文本配置文件转换成二进制的配置文件，由于APLauncher系统在运行时读取的是二进制配置文件。使用ptgencfg命令进行转换。

[iuas@DPiUAS01~/etc]#ptgencfg–yapp.ini

系统生成二进制配置文件aplconfig，并保存在“/home/iuas/etc〞下。

3-13

iUAS安装与配置上机指导书

第3章配置及启动

3.3配置service.cfg

3.3.1配置文件说明

service.cfg是iUAS系统的配置文件，它由[Common]节、[Default]节，以及针对各数据源的属性节组成。

注意：

??

service.cfg文件的配置项区分大小写。

配置文件中配置的数字，假使是以0开头，则认为此配置的数字是八进制，校验规则就是八进制数校验规则；假使是以0x开头，则认为此配置的数字是十六进制，校验规则以十六进制为准；其余状况认为配置的数字是十进制，校验规则以十进制为准。

1.配置Common

Common节设置了所有Service的共同配置项。Common节配置例如：

[Common]IPCKeyErrorLog

--所有Service的共同配置项=20230108;=ON;=ON;=20;

--共享内存地址--错误日志开关--超长调用日志开关

--错误日志文件大小,单位为M--超长调用日志文件大小,单位为M

LongCallLogErrorLogFileSize

LongCallLogFileSize=20;

Common节配置项如表3-8所示：

表3-8Common节各配置项含义

配置项名称配置项含义创立核心的共享内存等进程间通讯资源必需的键值。取值为界于0和2147483647之间的整数。IPCKey注意：不要与系统其它程序的IPCKey重复。可使用ipcs–m命令查看已经被系统使用的IPCKey值。ErrorLogLongCallLog错误日志开关。ON：开启日志开关；OFF：关闭日志开关。超长调用日志开关。ON：开启日志开关；OFF：关闭日志开关。3-14

iUAS安装与配置上机指导书

配置项名称配置项含义第3章配置及启动

错误日志文件大小，单位MB，默认值20MB。ErrorLogFileSize当错误日志文件大小达到参数设置值时，系统将原日志文件加.bak扩展名另存。注意：日志备份文件（.bak文件）只保存一份。超长调用日志文件大小，单位MB，默认值20MB。LongCallLogFileSize当超长调用日志文件大小达到参数设置值时，系统将原日志文件加.bak扩展名另存。注意：日志备份文件（.bak文件）只保存一份。

2.配置Default

Default节设置了一些缺省配置项，当某个Service的配置节中没有相应的配置信息时,则使用Default节中的配置项。Default节的配置项是几类Service配置项的总和。Default节配置例如：

[Default]配置项

DetailLogFileSizePreFetchRows

=10;=200;

--详细日志文件大小,单元为M--预取数据的行数

--假使在对应的Service中没有配置信息,则使用Default

3.配置Service

Service节描述了具体Service的配置项。iUAS系统供提供三种Service：PortalService、DBService和DTService。

PortalService是iUAS系统提供的门户Service。它负责接收来自客户端的请求，然后对请求进行预处理和分类，最终依据需求类型把需求转发给DBService和DTService处理。PortalService节配置例如：

[PTService]ServiceName

--数据源名称=PortalService;

--Service名称

PortalService节的配置项如表3-9所示。

表3-9PortalService节各配置项含义

配置项名称[数据源名称]配置项含义PortalService数据源名称，需与app.ini配置文件的Services节中的此数据源的名称保持一致。3-15

iUAS安装与配置上机指导书

配置项名称ServiceName配置项含义第3章配置及启动

Service名称，就是iUAS系统提供的Service的执行程序名称。在PortalService节，固定为PortalService，注意区分大小写。详细日志文件大小，单位为MB，默认值10MB。假使在此节设置，则覆盖Default节此配置项的值。DetailLogFileSize当详细日志文件大小达到参数设置值时，系统将原日志文件加.bak扩展名另存。注意：日志备份文件（.bak文件）只保存一份。一次从数据中获取记录数。假使从数据库中每次获取记录数多，譬如用于VIP客户的话单查询，建议配置为200，其它状况配置为100即可。PreFetchRows

DBService是iUAS系统提供的用来访问数据库的Service。DBService节配置例如：

[ICDLOCAL]ServiceNameDatabaseTypeDatabaseNameUserNamePassword

--数据源名称=DBService;=ORACLE;=ORA817;=icdmain;=icd;

--Service名称--数据库类型--数据库名称--用户名--密码

--详细日志文件大小,单元为M

DetailLogFileSize=30;

DBService节的配置项如表3-10所示。

表3-10DBService节各配置项含义

配置项名称[数据源名称]ServiceNameDatabaseTypeDatabaseNameUserNamePassword配置项含义DBService数据源名称，需与app.ini配置文件的Services节中的此数据源的名称保持一致。Service名称，就是iUAS系统提供的Service的执行程序名称。在DBService节，固定为DBService，注意区分大小写。此Service访问的数据库类型，目前只支持“ORACLE〞。此Service访问的数据库服务器的名字，即在客户端的tnsnames.ora中设置的服务名。此Service访问数据库的帐号此Service访问数据库的密码3-16

iUAS安装与配置上机指导书

配置项名称配置项含义第3章配置及启动

详细日志文件大小，单位为MB，默认值10MB。假使在此节设置，则覆盖Default节此配置项的值。DetailLogFileSize当详细日志文件大小达到参数设置值时，系统将原日志文件加.bak扩展名另存。注意：日志备份文件（.bak文件）只保存一份。一次从数据中获取记录数。假使从数据库中每次获取记录数多，譬如用于VIP客户的话单查询，建议配置为200，其它状况配置为100即可。PreFetchRows

DTService是iUAS系统提供的用来访问DTProxy的Service。在一些环境中，iUAS不能直接对数据库进行访问，而需要通过DTProxy访问数据库。DTService节配置例如：

[ICDFEP]ServiceNameDtProxyIPDtProxyID

--数据源名称=DTService;

--Service名称

=;--DtProxy的所在的机器地址=22;

--DtProxy的进程号

--发送客户端请求超时时长,单位为秒--接收DtProxy响应超时时长,单位为秒--详细日志文件大小,单元为M

SendRequestTimeOut=30;RevResponseTimeOut=30;DetailLogFileSize=20;

DTService节的配置项如表3-11所示。无缺省值的配置项为必配项。

表3-11DTService节各配置项含义

配置项名称[数据源名称]ServiceNameDtProxyIPDtProxyIDSendRequestTimeOut配置项含义DTService数据源名称，需与app.ini配置文件的Services节中的此数据源的名称保持一致。Service名称，就是iUAS系统提供的Service的执行程序名称。在DTService节，固定为DTService，注意区分大小写。DtProxy的所在的机器地址。DtProxy的进程号。发送客户端请求超时时长，单位为秒。缺省值为30秒。RevResponseTimeOut接收DtProxy响应超时时长，单位为秒。缺省值为30秒。详细日志文件大小，单位为MB，默认值10MB。假使在此节设置，则覆盖Default节此配置项的值。DetailLogFileSize当详细日志文件大小达到参数设置值时，系统将原日志文件加.bak扩展名另存。注意：日志备份文件（.bak文件）只保存一份。3-17

iUAS安装与配置上机指导书

配置项名称配置项含义第3章配置及启动

PreFetchRows一次从数据中获取记录数。假使从数据库中每次获取记录数多，譬如用于VIP客户的话单查询，建议配置为200，其它状况配置为100即可。

3.3.2配置实例

service.cfg配置文件例如随iUAS系统软件包一起发放，保存在“/home/iuas/config〞目录下，用户可依据实际环境和需求在提供的例如上直接修改，减少工作量。

依据示3.2.2节的举例，service.cfg的配置应为：

[iuas@DPiUAS01~/config]#cd/home/iuas/config[iuas@DPiUAS01~/config]#viservice.cfg

\\LineComment=--

\\BlockCommentOn=

------iUASV1.1D301服务配置文件--------Copyright2023-2023HuaweiTechnologiesCo.,Ltd.------

[Common]--所有Service的共同配置项IPCKey=20230108;--共享内存地址ErrorLog=ON;--错误日志开关

LongCallLog=ON;--超长调用日志开关

ErrorLogFileSize=20;--错误日志文件大小,单位为M

LongCallLogFileSize=20;--超长调用日志文件大小,单位为M

[Default]--假使在对应的Service中没有配置信息,则使用Default配置项DetailLogFileSize=10;--详细日志文件大小,单元为MPreFetchRows=200;--预取数据的行数

以下为Service的配置信息

[PTService]--数据源名称

ServiceName=PortalService;--Service名称,支持PortalService,--DBService和DTService,注意区分大小写

[ICDLOCAL]--数据源名称

ServiceName=DBService;--Service名称DatabaseType=ORACLE;--数据库类型DatabaseName=ORA817;--数据库名称UserName=icdmain;--用户名Password=icd;--密码

DetailLogFileSize=30;--详细日志文件大小,单元为M

[WEBICD]--数据源名称

3-18

iUAS安装与配置上机指导书

ServiceName=DBService;DatabaseType=ORACLE;DatabaseName=ORA817;UserName=webicd;Password=webicd;

[ICDFEP]--数据源名称

ServiceName=DTService;--Service名称

DtProxyIP=00;--DtProxy的所在的机器地址DtProxyID=22;--DtProxy的进程号

SendRequestTimeOut=30;--发送客户端请求超时时长,单位为秒--可选配置项,默认为30秒

RevResponseTimeOut=30;--接收DtProxy响应超时时长,单位为秒--可选配置项,默认为30秒

DetailLogFileSize=20;--详细日志文件大小,单元为M

[ICDREMOTE]--数据源名称ServiceName=DTService;

DtProxyIP=20;DtProxyID=22;

SendRequestTimeOut=10;RevResponseTimeOut=10;DetailLogFileSize=40;

第3章配置及启动

实际配置为：

[Common]

IPCKey=0x567123;DetailLog=ON;ErrorLog=ON;LongCallLog=OFF;ErrorLogFileSize=20;LongCallLogFileSize=20;

[Default]

DetailLogFileSize=10;LongCallThreshold=20000;AckMsgBuffSize=10;PreFetchRows=200;--MaxTimePerRequst=60;

[PTService]

ServiceName=PortalService;AckMsgBuffSize=1;

[ICDSC]

ServiceName=DBService;DatabaseType=ORACLE;

3-19

iUAS安装与配置上机指导书

DatabaseName=ora92;UserName=icdmain;Password=icd;DetailLogFileSize=30;

[OUTBOUND]

ServiceName=DBService;DatabaseType=ORACLE;第3章配置及启动

DatabaseName=ora92;UserName=outbound;Password=outbound;

[ICDFEP]

ServiceName=DTService;

DtProxyIP=19;DtProxyID=34;SendRequestTimeOut=1;RevResponseTimeOut=1;PerRevResponseTime=200;StartFieldName=Z;StartFieldIndex=1;DetailLogFileSize=20;