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創(chuàng)立業(yè)務數據庫1-4

1.4.1創(chuàng)立主數據庫1-41.4.2創(chuàng)立外呼數據庫1-9

第2章iUAS的安裝2-1

2.1安裝中間件平臺（APLauncher）2-12.2安裝ICDComm2-32.3安裝應用服務器（iUAS）2-6

第3章配置及啟動3-1

3.1配置環(huán)境變量3-1

3.1.1配置iuas_init3-23.1.2配置iuas_alias3-23.1.3生效環(huán)境變量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實例一：查詢系統(tǒng)參數表5-15.2實例二：協(xié)議接口調用5-55.3實例三：多地市協(xié)議接口調用5-7

ii

iUAS安裝與配置上機指導書

第1章Linux和Oracle的安裝

第1章Linux和Oracle的安裝

上機前請先閱讀上機指導書，確認了解設備環(huán)境和上機過程后再開始試驗，上機時請遵守機房管理規(guī)定，不明白時請咨詢指導教師。本課程總上機時間為8小時。

1.1軟件準備

培訓環(huán)境下，要求學員在各自分派的服務器上安裝Linux操作系統(tǒng)和Oracle9i數據庫，需要準備的軟件有：(1)TurboLinux7.0安裝光盤

1.2Linux安裝

Linux安裝過程較為簡單，對于IBMX/DELLPowerEdge系列服務器，Linux7.0安裝光盤中自帶硬盤驅動，因此，不需要制作驅動軟盤。Linux7.0共三張光盤，我們安裝只用第一張光盤即可。

將第一張光盤插入光驅內，開機進行安裝引導。在安裝過程中需要注意的地方有：

分區(qū)，不推薦使用自動分區(qū)，基本的分區(qū)大小推薦為：/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中缺省只有l(wèi)o一個網絡接口，若運行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工具，移動光標選擇“系統(tǒng)服務管理〞，敲空格選擇ProFTPd和TELNET，最終確定。

在不重啟機器的狀況下，需要以root用戶執(zhí)行：#xinetd#proftpd

以上命令為載入Telnet和Ftp服務。

若要讓root用戶telnet，則需要在/etc/pam.d/login中將authrequired/lib/security/pam_securetty.so解釋掉

Linux安裝完后，可以以root用戶登錄，輸入startx來啟動KDE圖形桌面。

1.3Oracle9i安裝

Oracle9i若用安裝盤進行安裝，大約需要2個小時，為節(jié)省安裝時間，我們將Oracle9i運行程序打包成一個tar文件，該tar文件包含了：Oracle的運行程序、Oracle的系統(tǒng)數據庫。以下是安裝包的安裝方法：以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文件（一定要在/下執(zhí)行）：

1-3

iUAS安裝與配置上機指導書

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

第1章Linux和Oracle的安裝

解壓完成后，Oracle9i數據即可以使用，Oracle9i的數據庫的SID及數據庫名稱均為ora92，listener的偵聽端口為1521，sys用戶口令為sys，system用戶口令為system。

Oracle9i數據庫常用命令：啟動數據庫

以oracle9用戶登錄操作系統(tǒng)：

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

關閉數據庫

以oracle9用戶登錄操作系統(tǒng)：

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

啟動listener：

以oracle9用戶登錄操作系統(tǒng)：

[oracle9@DPiUAS01oracle9]$lsnrctlstart

關閉listener：

以oracle9用戶登錄操作系統(tǒng)：

[oracle9@DPiUAS01oracle9]$lsnrctlstop

1.4創(chuàng)立業(yè)務數據庫

假定ICD3.0平臺的數據庫已經創(chuàng)立，且可以從網絡訪問。

創(chuàng)立業(yè)務數據庫分兩個步驟：創(chuàng)立主業(yè)務數據庫和創(chuàng)立外呼數據庫。

1.4.1創(chuàng)立主數據庫

創(chuàng)立業(yè)務數據庫過程在Windows客戶端進行，建議使用PL/SQLDeveloper，也可以使用SQL*Plus：

1-4

iUAS安裝與配置上機指導書

第1章Linux和Oracle的安裝

步驟1、創(chuàng)立存放數據文件目錄

培訓環(huán)境中，數據庫創(chuàng)立在與iUAS同一部TurboLinux主機上，建議將要創(chuàng)立的數據文件存放在/data下面，例如：/data/SCDB，這個目錄需要提前創(chuàng)立。

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

[root@DPiUAS01/data]#chownoracle9:dbaSCDB

步驟2、修改腳本

獲取數據庫腳本，根據建立的文件目錄的路徑修改腳本“1.創(chuàng)立表空間及回滾段.orasql〞：

使用UltraEdit或NotePad開啟腳本文件“1.創(chuàng)立表空間及回滾段.orasql〞，要創(chuàng)立的數據文件分別以rlv_dat01～rlv_dat14命名，依照實際狀況更改這些文件的目錄。

數據庫腳本默認創(chuàng)立數據文件需要磁盤空間大約是26GB，在培訓環(huán)境中，假使磁盤空間不足，就要調整表空間大小，方法是調整各表空間中數據文件的大小，建議各表空間大小的最低值為：SERVICE_MAIN_DAT800MSERVICE_MAIN_IDX500MSERVICE_LOG_DAT2000MSERVICE_LOG_IDX200MSERVICE_HIST_DAT1500MSERVICE_HIST_IDX300MSERVICE_TEMP200M調整之后總共使用5.5G硬盤空間。

不用創(chuàng)立回滾表空間SERVICE_RBS和回滾段SERVICE_RBS01～SERVICE_RBS20，由于Oracle9i使用自動管理回滾表空間，可以通過檢查數據庫參數證明：

[oracle9@DPiUAS01oracle9]$sqlplus\SQL>showparameterundo_management

NAMETYPEVALUE

undo_managementstringAUTO

參數undo_management的值為AUTO說明數據庫采用了自動管理回滾表空間的方式，不需管理員創(chuàng)立回滾表空間和回滾段。

1-5

iUAS安裝與配置上機指導書

第1章Linux和Oracle的安裝

?說明：

?

?

?

在培訓環(huán)境創(chuàng)立數據庫時，腳本中涉及回滾表空間和回滾段的部分都需要解釋掉。

刪除表空間的語句缺省是被解釋掉的，需要重建數據庫時，可以去掉解釋行。

做刪除操作前，一定要確認目標不是在線服務的數據庫服務器，切記。

步驟3、創(chuàng)立表空間

在Windows客戶端使用Net8Assistant（Oracle8i）或NetManager（Oracle9i）新建數據庫服務名，或者直接編輯客戶端的tnsnames.ora文件新建數據庫服務名。

啟動PL/SQLDeveloper，以sys用戶（sysassysdba）登錄到相應的Oracle服務器，選擇[File/New/CommandWindow]菜單，進入命令執(zhí)行窗口，加載以下腳本文件：

?

“1.創(chuàng)立表空間及回滾段.orasql〞

?說明：加載方法有兩種：

??

將腳本文件內容拷貝到Editor頁簽下，單擊按鈕。

在“SQL>〞命令符后鍵入命令“@腳本文件路徑\\腳本文件名稱〞，例如：@d:\\1.創(chuàng)立表空間及回滾段.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、創(chuàng)立用戶及授權

以sys用戶登錄到PL/SQLDeveloper，選擇[File/New/CommandWindow]菜單，進入命令執(zhí)行窗口，加載以下腳本文件：

?

“2.創(chuàng)立用戶及授權.orasql〞

步驟5、創(chuàng)立數據庫對象

以icdmain用戶（asnormal）登錄到PL/SQLDeveloper（口令為icd），選擇[File/New/CommandWindow]菜單，進入命令執(zhí)行窗口，按順序加載以下腳本文件：

???

“3.創(chuàng)立表、視圖及序列.orasql〞“4.創(chuàng)立存儲過程及函數.orasql〞“6.創(chuàng)立定時任務.orasql〞

?說明：

一定要切換到icdmain用戶加載腳本，切記。步驟6、初始化數據

以icdmain用戶登錄到PL/SQLDeveloper，選擇[File/New/CommandWindow]菜單，進入命令執(zhí)行窗口，加載以下腳本文件：

?

“5.創(chuàng)立初始化數據.orasql〞

?說明：

初始化數據比較費時，在保持網絡連接的前提下，可以同時完成其他上機工作。

步驟7、創(chuàng)立數據庫鏈接

首先確定ICD3.0平臺數據庫（UIDB）的鏈接信息，例如：

?

數據庫服務器名/IP地址：67數據庫監(jiān)聽服務端口號：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章配置及啟動

本章詳細介紹了應用服務器的環(huán)境變量和四個配置文件的配置，以及如何啟動應用服務器。

表3-1給出本章描述內容列表：

表3-1配置及啟動應用服務器任務列表

任務操作章節(jié)號設置環(huán)境變量依據不同的sh，對iUAS系統(tǒng)提供的“iuas_alias.csh〞、“iuas_init.csh〞、3.1“iuas_alias.ksh〞、“iuas_init.ksh〞文件進行編輯，設置系統(tǒng)的環(huán)境變量。介紹了app.ini文本配置文件中各配置項的含義并給出app.ini配置例如。介紹了如何把app.ini文本文件轉換成二進制文件。介紹了service.cfg文本配置文件中各配置項的含義并給出service.cfg配置例如。介紹了iuas.cfg文本配置文件中各配置項的含義并給出iuas.cfg配置例如。介紹了icdcomm.cfg文本配置文件中各配置項的含義并給出icdcomm.cfg配置例如。介紹如何啟動iUAS系統(tǒng)，以及啟動的先后順序。配置app.ini3.2配置service.cfg3.6配置iuas.cfg配置icdcomm.cfg啟動iUAS系統(tǒng)

3.1配置環(huán)境變量

環(huán)境變量例宛如iUAS系統(tǒng)軟件包一起發(fā)放，保存在“/home/iuas/bin〞目錄下。該目錄下與環(huán)境變量有關的文件有四個（實際版本只提供了前兩個）：

????

iuas_alias.cshiuas_init.cshiuas_alias.kshiuas_init.ksh

其中的“iuas_alias.csh〞、“iuas_init.csh〞用于csh環(huán)境，“iuas_alias.ksh〞、“iuas_init.ksh〞用于ksh環(huán)境。

3-1

iUAS安裝與配置上機指導書

第3章配置及啟動

3.1.1配置iuas_init

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

假使安裝時是依照本書的建議的目錄進行安裝和設置的，那么除了“WSNADDR〞外，文件中的其它環(huán)境變量的設置都不再需要更改了。當然假使安裝時不是依照本書的建議的目錄進行安裝和設置，則需要根據實際規(guī)劃的目錄狀況修改相關環(huán)境變量。“iuas_init〞文件中每個環(huán)境變量的含義已經在文件中給出說明，這里就不再贅述了。下面只對“WSNADDR〞變量的配置進行說明：

假設，WSNADDR的IP地址是72，端口號是10800?！癷uas_init.csh〞修改如下：

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

setenvWSNADDR//72:10800#WSL（WorkStationListener，偵聽和分發(fā)客戶端的連接的接口進程）監(jiān)聽地址和端口，需依據實際安裝環(huán)境修改

3.1.2配置iuas_alias

為便利操作，iUAS系統(tǒng)提供了“iuas_alias〞文件，用于設置命令的別名。通過設置和使用別名，用戶可減少字符輸入量，因而提高工作效率，同時也可避免大量輸入過程中帶來的錯誤。

用戶可以依據自己的實際狀況決定是否使用此文件。“iuas_init〞文件缺省使用“iuas_alias〞文件，假使不想使用此文件，應修改“iuas_init〞文件，解釋相關內容。

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

[iuas@DPiUAS01~/bin]#viiuas_init.csh#執(zhí)行快捷命令設置文件#source${IUAS_DIR}/bin/iuas_alias.csh

用戶也可以修改“iuas_alias.csh〞文件，使文件中定義的別名更符合用戶的使用習慣和便利記憶。

別名的設置方式為“alias別名原名〞。例如：aliasll'ls-l'，就是把“l(fā)s-l〞設置為“l(fā)l〞，這樣以后敲擊“l(fā)l〞，就表示“l(fā)s-l〞。

3-2

iUAS安裝與配置上機指導書

第3章配置及啟動

3.1.3生效環(huán)境變量

完成上面的設置后，對于csh用戶，在iUAS用戶目錄下的“.login〞或“.cshrc〞（實際為.tcshrc）文件的末尾增加“source${HOME}/bin/iuas_init.csh〞語句，并重新執(zhí)行“.login〞或“.cshrc〞，使環(huán)境變量生效。

%vi./.cshrc[iuas@DPiUAS01~]#vi./.tcshrc#使iuas_init.csh文件被執(zhí)行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中間件開發(fā)平臺的文本配置文件稱為app.ini，用戶可以依據自己的習慣定義這個文件具體的文件名。app.ini配置文件由RESOURCE、MACHINES、GROUPS、SERVERS、SERVICES、ROUTING六部分組成。各配置小節(jié)相互間的關系如圖3-1所示：*RESOURCE????ó|ó???*MACHINES??ú÷??D??￠*GROUPSé?×?D??￠*SERVERSìD3ò??????D??￠*SERVICES|?1ü??????D??￠圖3-1各配置小節(jié)相互間的關系3-3iUAS安裝與配置上機指導書

第3章配置及啟動

一個應用系統(tǒng)可由一臺或多臺機器組成。一臺機器中可有一個或多個GROUP（組）。一個組又有一個或多個SERVER（服務）組成。一個SERVER尋常由一個或多個SERVICE（基本服務）組成。

注意：

??

app.ini文件的配置項區(qū)分大小寫。

配置文件中配置的數字，假使是以0開頭，則認為此配置的數字是八進制，校驗規(guī)則就是八進制數校驗規(guī)則；假使是以0x開頭，則認為此配置的數字是十六進制，校驗規(guī)則以十六進制為準；其余狀況認為配置的數字是十進制，校驗規(guī)則以十進制為準。

1.配置RESOURCES

RESOURCES節(jié)設置應用服務器的基本信息，包括規(guī)律機器名、最大服務數等。

RESOURCE節(jié)配置例如：

*RESOURCESIPCKEYMASTERMAXACCESSERSMAXSERVERSMAXSERVICESMODELLDBAL

37398iUAS300100100SHMY

RESOURCES節(jié)配置項如表3-2所示。

表3-2RESOURCES節(jié)配置項說明

設置項*RESOURCES描述表示RESOURCES節(jié)，此配置項無需修改。創(chuàng)立核心的共享內存等進程間通訊資源必需的鍵值。取值為界于32770和16777215之間的整數。該值必需設置。注意：要求該值與系統(tǒng)中其它程序此配置項取值不同。可用ipcs–m命令查看當前系統(tǒng)中已經被設置的IPCKEY的值。為本機的規(guī)律機器名，該值必需設置。MASTER該規(guī)律值是在MACHINES節(jié)配置項LMID設置的值。例如：iuas1LMID=iUAS，則iuas1為實際的機器名，iUAS為規(guī)律機器名。IPCKEY3-4

iUAS安裝與配置上機指導書

設置項描述第3章配置及啟動

包括APLauncher客戶端、服務端所有進程在內的最大進程個數，一定要大于MACHINES節(jié)的MAXWSCLIENTS。應當大于座席MAXACCESSERS個數加上service的個數。例如：有200個座席，則此值配置為200＋100=300。MAXSERVERSMAXSERVICES本機可同時啟動服務的最大數。建議值100。本機中可同時調用MAXSERVICES的最大數。建議值100。系統(tǒng)的組成模式。可以為SHM（SharedMemory），即單機模式。MP（MultiProcess），即多機模式。此處固定設置為“SHM〞。LDBAL服務器負載是否均衡。MODEL

2.配置MACHINES

MACHINES節(jié)描述應用服務器所在機器的狀況。MACHINES節(jié)配置例如：

*MACHINESiuas1

LMID=iUAS

APPDIR=\

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

MACHINES節(jié)配置項如表3-3所示。

表3-3MACHINES節(jié)配置項說明

設置項*MACHINES描述表示MACHINES節(jié)，此配置項無需修改。為了便于APLauncher系統(tǒng)讀取和動態(tài)配置，APLauncher的配置文件有文本和二進制兩種形式。文本形式的供用戶使用，二進制的供系統(tǒng)和用戶程序使用。本配置項就是指明二進制配置文件所在的絕對路徑。該路徑即為應用服務器配置文件的路徑，文件名固定為“aplconfig〞。APLauncher系統(tǒng)在本機器上的安裝路徑，必需為絕對路徑。應用服務器服務程序所在的路徑，必需為絕對路徑。APLCONFIGAPLDIRAPPDIR3-5

iUAS安裝與配置上機指導書

設置項描述第3章配置及啟動

是應用服務器使用的環(huán)境文件，該文件尋常在應用服務器的安裝路徑/bin下，文件名固定為envfile。指定路徑時要指定絕對路徑。ENVFILE注意：ENVFILE必需保證與iuas_setup.csh（或iuas_setup.ksh）中的envfile設置一致，否則無法啟動服務。MAXWSCLIENTS同時允許接入的客戶端數，應不小于座席個數。TYPE本機器的操作系統(tǒng)類型。有HP及AIX兩種（實際配置為linux-i686）。設置物理機器名及規(guī)律機器名，設置方法如下：主機名LMID=規(guī)律名主機及LMID設置例如：iuas1LMID=iUAS，則iuas1為實際的主機名，iUAS為規(guī)律機器名。說明：可以利用hostname取得主機名。

3.設置GROUPS

在本系統(tǒng)中把提供一致服務的程序歸為一組。同一個組的程序分布在同一臺機器上。組同數據源一一對應，一個數據源對應一個組。GROUPS節(jié)配置例如：

*GROUPSDEFAULT:GROUP1GROUP2GROUP3GROUP4

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

TMSNAME=\

TMSCOUNT=2

GROUPS節(jié)配置項如表3-4所示。

表3-4GROUPS節(jié)配置項說明

設置項*GROUPS描述表示GROUPS節(jié)，此配置項無需修改。設置GROUPS節(jié)配置項的缺省配置。假使某個組沒有對某個配置進行描述，則使用此處設定的值。例如：例如中，4個組的LMID、TMSNAME和TMSCOUNT都使用在DEFAULT處設定的值。組的規(guī)律名稱。GROUPNAME例如：例如中的GROUP1、GROUP2和GROUP3。LMID組所在的機器的規(guī)律名稱。該規(guī)律值是在MACHINES小節(jié)LMID設置的值。DEFAULT3-6

iUAS安裝與配置上機指導書

設置項GROUPNO描述第3章配置及啟動

組號，用來唯一標識一個組，在同一臺機器上組號不能重復。例如：例如中的GRPNO=1、GRPNO=2、GRPNO=3。TMSNAME事務管理進程的名字，APLauncher提供的默認事務管理進程的名稱為“TMS〞。啟動的事務管理進程的個數。TMSCOUNT假使資源允許，啟動的事務管理進程的個數越大越好，但是個數限定在2～10之間。

4.設置SERVERS

在SERVERS節(jié)中設置iUAS系統(tǒng)提供的各種服務。一個SERVER就是iUAS系統(tǒng)提供的一個服務進程。SERVERS節(jié)配置例如：

*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節(jié)配置項如表3-5所示。

表3-5SERVERS節(jié)配置項說明

設置項*SERVERSDEFAULTSERVERNAME取值是PortalServer、DBServer、DTServer、WSL之一。服務所隸屬的組的名字。SRVGRP取值是GROUPS節(jié)設置的GROUPNAME值。WSL和PortalServer可以隸屬于任何已經在GROUPS節(jié)設置的組名。服務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))上面公式中，客戶端的個數表示同時訪問同一個數據源的最大可能個數。啟動的實例的最大個數。即本服務程序可以啟動的最大個數，系統(tǒng)會根據負載狀況自動增加啟動本服務程序的個數，總的個數最大不超過本參數的設定值。該值建議和MIN相等。應用服務器異常終止后是否可以被APlauncher應用程序拉起。配置為“Y〞表示應用服務器可以被自動拉起，設置為“N〞表示應用服務器不能被自動拉起。尋常設置為“Y〞。應用服務器異常終止后，在一天范圍內，允許被自動拉起的次數。設置50即可。描述表示SERVERS節(jié)，此配置項無需修改。對各個Server都要用到的配置項進行設置。服務程序的名字，也即可執(zhí)行文件的名字。SRVIDMAXRESTARTMAXGEN3-8

iUAS安裝與配置上機指導書

設置項WSL的啟動參數例如為：描述第3章配置及啟動

CLOPT=\其中，18為WSL所在機器的IP地址，25000為WSL偵聽端口號。WSL端口號的取值范圍是[10000，30000]。-m指定啟動WSH（WorkStationHandler）的最小個數，在APlauncher系統(tǒng)啟動時將有m個WSH被拉起。該值應不少于SERVICE的個數。建議值為座席平均同時訪問數。-M指定啟動WSH的最大個數，超過最小個數的WSH將由WSL根據客戶端的接入狀況自動增加拉起。推薦值為座席最大同時訪問數。最多啟動個數乘上一個WSH最多服務的客戶端數所得的積不得少于客戶端總數。-x指定一個WSH最多可以代理的遠程客戶端的個數，取值在5～10之間的整數，建議取5。其它SERVER的啟動參數例如：CLOPT=\-s指數據源的名稱。注意：這個數據源名稱要與后面講到的service.cfg和iuas.cfg中的數據源名稱保持一致。CLOPT

5.設置SERVICES

是iUAS系統(tǒng)中一個服務進程提供的基本服務單元。用于完成一項功能。SERVICES節(jié)配置例如：

*SERVICESDBService

DTService

ROUTING=DtLabelROUTING=DbLabel

SERVICES節(jié)配置項如表3-6所示。

表3-6SERVERS節(jié)配置項說明

設置項*SERVICES描述表示SERVICES節(jié)，此配置項無需修改。服務程序的名字，也即可執(zhí)行文件的名字。SERVICENAME由于只有DBServer和DTServer訪問數據庫，所以此配置項取值是DBServer和DTServer之一。ROUTINGLABEL路由字段名稱。

3-9

iUAS安裝與配置上機指導書

第3章配置及啟動

6.設置ROUTING

在進行數據庫調用時，可以對每個數據源指定調用的組，假使需要通過SQLAPI直接訪問多個數據庫時，必需設置路由信息。ROUTING節(jié)配置例如：

*ROUTINGDbLabel

DtLabel

FIELD=DSLabel

RANGES=\BUFTYPE=\FIELD=DSLabel

RANGES=\BUFTYPE=\

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

表3-7ROUTING節(jié)設置項說明

設置項*ROUTINGROUTINGLABEL描述表示ROUTING節(jié)，此配置項無需修改。路由標識，與在SERVICES指定的ROUTINGLABEL相對應。路由字段，該名稱固定為“DSLabel〞，不能修改。FIELD注意：該值區(qū)分大小寫，該值設置錯誤將導致BBL（BulletinBoardLiaison，）服務無法啟動。路由范圍，設置方法為：“數據源名稱:組名〞，每個路由之間用“,〞（半角逗號）分割。RANGES此處的數據源名稱與SERVER節(jié)中配置的數據源名稱相對應。該名稱與后面介紹的service.cfg和iuas.cfg中的數據源名稱應保持一致。路由類型，即應用服務器使用的路由描述文件，固定為TBL32。BUFTYPE

3.2.2配置實例

app.ini配置文件例如隨iUAS系統(tǒng)軟件包一起發(fā)放，保存在“/home/iuas/etc〞目錄下，用戶可依據實際環(huán)境和需求在提供的例如上直接修改，減少工作量。舉例：應用服務器需要通過DBService訪問數據庫ICDLOCAL和WEBICD，通過DTService訪問ICDFEP和ICDREMOTE，ICDFEP的IP地址是00，ICDREMOTE的IP地址是20。對于上述4個

3-10

iUAS安裝與配置上機指導書

第3章配置及啟動

數據源劃分4個組，依據3.2.1節(jié)介紹的各節(jié)的配置，則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系統(tǒng)在運行時讀取的是二進制配置文件。使用ptgencfg命令進行轉換。

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

系統(tǒng)生成二進制配置文件aplconfig，并保存在“/home/iuas/etc〞下。

3-13

iUAS安裝與配置上機指導書

第3章配置及啟動

3.3配置service.cfg

3.3.1配置文件說明

service.cfg是iUAS系統(tǒng)的配置文件，它由[Common]節(jié)、[Default]節(jié)，以及針對各數據源的屬性節(jié)組成。

注意：

??

service.cfg文件的配置項區(qū)分大小寫。

配置文件中配置的數字，假使是以0開頭，則認為此配置的數字是八進制，校驗規(guī)則就是八進制數校驗規(guī)則；假使是以0x開頭，則認為此配置的數字是十六進制，校驗規(guī)則以十六進制為準；其余狀況認為配置的數字是十進制，校驗規(guī)則以十進制為準。

1.配置Common

Common節(jié)設置了所有Service的共同配置項。Common節(jié)配置例如：

[Common]IPCKeyErrorLog

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

--共享內存地址--錯誤日志開關--超長調用日志開關

--錯誤日志文件大小,單位為M--超長調用日志文件大小,單位為M

LongCallLogErrorLogFileSize

LongCallLogFileSize=20;

Common節(jié)配置項如表3-8所示：

表3-8Common節(jié)各配置項含義

配置項名稱配置項含義創(chuàng)立核心的共享內存等進程間通訊資源必需的鍵值。取值為界于0和2147483647之間的整數。IPCKey注意：不要與系統(tǒng)其它程序的IPCKey重復?？墒褂胕pcs–m命令查看已經被系統(tǒng)使用的IPCKey值。ErrorLogLongCallLog錯誤日志開關。ON：開啟日志開關；OFF：關閉日志開關。超長調用日志開關。ON：開啟日志開關；OFF：關閉日志開關。3-14

iUAS安裝與配置上機指導書

配置項名稱配置項含義第3章配置及啟動

錯誤日志文件大小，單位MB，默認值20MB。ErrorLogFileSize當錯誤日志文件大小達到參數設置值時，系統(tǒng)將原日志文件加.bak擴展名另存。注意：日志備份文件（.bak文件）只保存一份。超長調用日志文件大小，單位MB，默認值20MB。LongCallLogFileSize當超長調用日志文件大小達到參數設置值時，系統(tǒng)將原日志文件加.bak擴展名另存。注意：日志備份文件（.bak文件）只保存一份。

2.配置Default

Default節(jié)設置了一些缺省配置項，當某個Service的配置節(jié)中沒有相應的配置信息時,則使用Default節(jié)中的配置項。Default節(jié)的配置項是幾類Service配置項的總和。Default節(jié)配置例如：

[Default]配置項

DetailLogFileSizePreFetchRows

=10;=200;

--詳細日志文件大小,單元為M--預取數據的行數

--假使在對應的Service中沒有配置信息,則使用Default

3.配置Service

Service節(jié)描述了具體Service的配置項。iUAS系統(tǒng)供提供三種Service：PortalService、DBService和DTService。

PortalService是iUAS系統(tǒng)提供的門戶Service。它負責接收來自客戶端的請求，然后對請求進行預處理和分類，最終依據需求類型把需求轉發(fā)給DBService和DTService處理。PortalService節(jié)配置例如：

[PTService]ServiceName

--數據源名稱=PortalService;

--Service名稱

PortalService節(jié)的配置項如表3-9所示。

表3-9PortalService節(jié)各配置項含義

配置項名稱[數據源名稱]配置項含義PortalService數據源名稱，需與app.ini配置文件的Services節(jié)中的此數據源的名稱保持一致。3-15

iUAS安裝與配置上機指導書

配置項名稱ServiceName配置項含義第3章配置及啟動

Service名稱，就是iUAS系統(tǒng)提供的Service的執(zhí)行程序名稱。在PortalService節(jié)，固定為PortalService，注意區(qū)分大小寫。詳細日志文件大小，單位為MB，默認值10MB。假使在此節(jié)設置，則覆蓋Default節(jié)此配置項的值。DetailLogFileSize當詳細日志文件大小達到參數設置值時，系統(tǒng)將原日志文件加.bak擴展名另存。注意：日志備份文件（.bak文件）只保存一份。一次從數據中獲取記錄數。假使從數據庫中每次獲取記錄數多，譬如用于VIP客戶的話單查詢，建議配置為200，其它狀況配置為100即可。PreFetchRows

DBService是iUAS系統(tǒng)提供的用來訪問數據庫的Service。DBService節(jié)配置例如：

[ICDLOCAL]ServiceNameDatabaseTypeDatabaseNameUserNamePassword

--數據源名稱=DBService;=ORACLE;=ORA817;=icdmain;=icd;

--Service名稱--數據庫類型--數據庫名稱--用戶名--密碼

--詳細日志文件大小,單元為M

DetailLogFileSize=30;

DBService節(jié)的配置項如表3-10所示。

表3-10DBService節(jié)各配置項含義

配置項名稱[數據源名稱]ServiceNameDatabaseTypeDatabaseNameUserNamePassword配置項含義DBService數據源名稱，需與app.ini配置文件的Services節(jié)中的此數據源的名稱保持一致。Service名稱，就是iUAS系統(tǒng)提供的Service的執(zhí)行程序名稱。在DBService節(jié)，固定為DBService，注意區(qū)分大小寫。此Service訪問的數據庫類型，目前只支持“ORACLE〞。此Service訪問的數據庫服務器的名字，即在客戶端的tnsnames.ora中設置的服務名。此Service訪問數據庫的帳號此Service訪問數據庫的密碼3-16

iUAS安裝與配置上機指導書

配置項名稱配置項含義第3章配置及啟動

詳細日志文件大小，單位為MB，默認值10MB。假使在此節(jié)設置，則覆蓋Default節(jié)此配置項的值。DetailLogFileSize當詳細日志文件大小達到參數設置值時，系統(tǒng)將原日志文件加.bak擴展名另存。注意：日志備份文件（.bak文件）只保存一份。一次從數據中獲取記錄數。假使從數據庫中每次獲取記錄數多，譬如用于VIP客戶的話單查詢，建議配置為200，其它狀況配置為100即可。PreFetchRows

DTService是iUAS系統(tǒng)提供的用來訪問DTProxy的Service。在一些環(huán)境中，iUAS不能直接對數據庫進行訪問，而需要通過DTProxy訪問數據庫。DTService節(jié)配置例如：

[ICDFEP]ServiceNameDtProxyIPDtProxyID

--數據源名稱=DTService;

--Service名稱

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

--DtProxy的進程號

--發(fā)送客戶端請求超時時長,單位為秒--接收DtProxy響應超時時長,單位為秒--詳細日志文件大小,單元為M

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

DTService節(jié)的配置項如表3-11所示。無缺省值的配置項為必配項。

表3-11DTService節(jié)各配置項含義

配置項名稱[數據源名稱]ServiceNameDtProxyIPDtProxyIDSendRequestTimeOut配置項含義DTService數據源名稱，需與app.ini配置文件的Services節(jié)中的此數據源的名稱保持一致。Service名稱，就是iUAS系統(tǒng)提供的Service的執(zhí)行程序名稱。在DTService節(jié)，固定為DTService，注意區(qū)分大小寫。DtProxy的所在的機器地址。DtProxy的進程號。發(fā)送客戶端請求超時時長，單位為秒。缺省值為30秒。RevResponseTimeOut接收DtProxy響應超時時長，單位為秒。缺省值為30秒。詳細日志文件大小，單位為MB，默認值10MB。假使在此節(jié)設置，則覆蓋Default節(jié)此配置項的值。DetailLogFileSize當詳細日志文件大小達到參數設置值時，系統(tǒng)將原日志文件加.bak擴展名另存。注意：日志備份文件（.bak文件）只保存一份。3-17

iUAS安裝與配置上機指導書

配置項名稱配置項含義第3章配置及啟動

PreFetchRows一次從數據中獲取記錄數。假使從數據庫中每次獲取記錄數多，譬如用于VIP客戶的話單查詢，建議配置為200，其它狀況配置為100即可。

3.3.2配置實例

service.cfg配置文件例如隨iUAS系統(tǒng)軟件包一起發(fā)放，保存在“/home/iuas/config〞目錄下，用戶可依據實際環(huán)境和需求在提供的例如上直接修改，減少工作量。

依據示3.2.2節(jié)的舉例，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,注意區(qū)分大小寫

[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;--發(fā)送客戶端請求超時時長,單位為秒--可選配置項,默認為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;