TUXEDO管理配置中文说明new.doc

Tuxedo的配置管理简要说明Tuxedo的配置管理简要说明1一、Tuxedo基本命令2二、UBB文件配置说明3三、数据库XA设置73.1 ORACLE XA7四、Tuxedo多机方式配置要点94.1启动tlisten94.2 ubb文件配置94.3管理11五、用JOLT连接Tuxedo和Weblogic115.1在Tuxedo上安装、配置JOLT Server115.2 配置Weblogic Server 6.x125.3 Example setup13六、TUXEDO动态配置136.1 用tmadmin修改配置136.2 用tmconfig更改TUXCONFIG（UBBCONFIG）14一、Tuxedo基本命令#1.设置环境变量TUXDIR,APPDIR,TUXCONFIG，LANG(跟OS相关),LD_LIBRARY_PATH(跟OS相关)#2.编译ubb文本生成二进制配置文件：tmloadcf y ubbconfig#3.所有机器上运行tlisten,具体见文档中NETWORK一节#4.启动tmboot y #5.关闭tmshutdown y参数： -A在所有机器上启动/关闭管理的Server进程-M只在MASTER机器上启动/关闭管理的Server进程-isrvid 启动/关闭某个server id指定的Server进程-ggrpname启动/关闭某个server group名字指定的Server Group-S启动/关闭所有应用服务器（LMID）-sserver-name 启动/关闭某个server名字指定的Server进程-llmid option 在指定的机器上启动/关闭所有TMS进程和应用服务器（LMID）-Tgrpname 启动/关闭指定的server group中所有的TMS进程-Blmid 在指定的机器上启动/关闭BBL进程-ecommand 指定一个程序可以当在MASTER机器上启动任何一个进程失败时执行-c计算出当前UBB配置的Tuxedo启动最少要占用的系统IPC资源#用tmunloadcf generated.ubb 可以得出目前配置得UBB文件所有得参数值（没有设置的有缺省值）#用tmloadcf c或tmboot c可以计算出当前UBB配置的Tuxedo启动最少要占用的系统IPC资源。二、UBB文件配置说明UBB配置文件分成*RESOURCES,*GROUP,*SERVER,*SERVICE,*NETWORK等若干节。DEFAULT表示该节中所有对象共有的缺省属性。*RESOURCES #RESOUCES节提供整个系统的基本参数。IPCKEY55555 （32767-262143） #进行IPC通讯的key值DOMAINIDunicom #DOMAIN的ID值MASTERunicom1,unicom2#指定DOMAIN中的管理主机为unicom1,运行过程中unicom1若出现问题，管理主机切换至unicom2MAXACCESSERS 1000 #这里该值表示整个系统中单个机器上可以访问TUXEDO的最多的Client和Server的总数(可以访问 BBL的最大进程数)，应大于license用户数+server数（副本应记入）。该字段会被MACHINE部分的MAXACCESSERS覆盖。#系统核心参数中SEMAPHORE的数目(SEMMNS)要大于这里的MAXACCESSERS数目，而ipc消息个数（MSGMAX）应大于MAXACCESSERS数+所有带REPLYQ的SERVER的个数。MAXSERVERS80 #最大的server数（副本应记入）MAXSERVICES200 #最大的service数（多个server重复记入）MAXGTT20#系统最多的并发的全局交易数目MODELMP #表示cluster方式，否则为SHMOPTIONSLAN,MIGRATE #多机cluster方式时必须指定为LAN方式，MIGRATE表示可以以组为单位进行机器间SERVER的迁移。LDBALY #允许负载均衡SCANUNIT10#SCANUNIT 是BBL在所有服务请求中定期扫描以寻找超时的交易和被阻塞德调用和德间隔时间（秒）。这个参数指定BBL扫描间隔时间的基本单位， 它会影响在tpbegin中指定的交易超时时间和用BLOCKTIME指定的请求阻塞超时时间的精确程度。SANITYSCAN, BBLQUERY, DBBLWAIT, BLOCKTIME等参数都是SCANUNIT的倍数，而不是实际秒数。而作为时间单位SCANUNIT必须是5的倍数，并且满足0SCANUNIT1，并且使用了MSSQ（RQADDR， RQPERM）的Server可以配置-p来控制进程的增加和减少。控制算法如下：如果请求队列中的请求个数大于high_water后超过create_time 秒,就增加该服务的一个新进程； 如果请求队列中的请求个数小于low_water 后超过terminate_time 秒, 就停止该服务的一个进程。low_water 缺省是平均每个服务进程有一个请求消息或者workload 50；high_water 缺省是平均每个服务进程有两个请求消息或者workload 100。create_time 缺省最小是50秒, and terminate_time 缺省最小是60秒。注意：使用TUXEDO的服务进程池时，用户自己在程序中如果用alarm（）等系统调用来停止进程是不起作用的，但也不会报错。 L 标记意味着增减服务进程基于负载而不是请求队列的长度。仅用于SHM模式下并且LDBAL=Y，否则会报错 (LIBTUX_CAT:1542) ，服务进程也不会增减。WSLSRVGRP=GROUP2 SRVID=1CLOPT=-A - -n /03:8889 -m 3 -M 10 -x 10 -T 10#WSL用于和client端进行连接。-n 表示出接入点为IP:PORT方式，-m M 表示最小和最大启动多少个WSH和前端通讯，-x则表示一个WSH和几个client端连接。-T 10表示如果client端和server连接后10分钟内没有交易请求则关闭连接。*SERVICES#不要求将所有的service在这里描述，当某个service有特别参数时才在SERVICE节中说明。TOUPPERLOAD=60 / 负载，当LDBAL=Y时有用PRIO=80/ 服务在请求队列中的优先级TRANSTIME=120 / 交易时间SVCTIMEOUT=600/ 服务超时时间*NETWORK#NETWORK节对多机之间如何进行网络连接进行描述。#cluster方式下要求先启动tlisten。事实上，对于非master机启动应用服务器是由tlisten完成的。#tlisten的启动方式为 #unicom1: tlisten l /01:8891#unicom2: tlisten l /02:8891#NADDR指定网络连接的接入点。#NLSADDR则指定tlisten的接入点。#BRIDGE则指TCP连接所用的设备文件。unicom2 NADDR=/02:8899NLSADDR=/02:8891BRIDGE=/dev/streams/xtiso/tcpunicom1NADDR=/01:8899NLSADDR=/01:8891BRIDGE=/dev/streams/xtiso/tcpWSL CLIENT&冷热备份配置 1,需要远程访问tuxedo service buildclient时需要加 w option 2,关于tuxedo server冷热备份问题冷备份时tuxedo /ws 配置 WSNADDR=ADDR1, ADDR2如果需要两台服务器做负载均衡 WSNADDR=(ADDR1|ADDR2)分类总结TypeParameters requiring tuningIdentificationTUXCONFIG, UID, GID, IPCKEY, DOMAINIDThresholdsMAXACCESSERS, MAXSERVERS, MAXSERVICES, MAXGTT, MAXCONV, MAXBUFSTYPE, MAXWSCLIENTSTime-outsSCANUNIT, SANITYSCAN, DBBLWAIT, BBLQUERY, BLOCKTIMEAvailabilityMASTER, MIGRATE, RESTART, GRACE, MAXGEN, RCMDMachineTYPE, CMPLIMIT, NETLOAD, SPINCOUNT, TLOGDEVICE, PERMNetworkNADDR, NLSADDRServersCLOPT, ENVFILEServicesLOAD, PRIO, BUFTYPE, SVCTIMEOUTWorkstationsWSNADDR, WSRPLYMAX三、数据库XA设置3.1 ORACLE XA1. 在附件中提供了rm文件,另外建议运行oracle的demo文件获得要连接的所有lib库的名称.然后将这些名称全部写在RM文件中.如： #Oracle 8i for NTOracle_XA;xaosw;%ORACLE_HOME%RDBMSXAORAXA8.LIB %ORACLE_HOME%PRECOMPLIBMSVCORASQL8.LIB %ORACLE_HOME%PRECOMPLIBMSVCORASQX8.LIB %ORACLE_HOME%OCILIBMSVCOCI.LIB %ORACLE_HOME%OCILIBMSVCOCIW32.LIB#Oracle 8i for UnixOracle_XA:xaosw:-L$ORACLE_HOME/lib -lclntsh2. ubb 文件中 *GROUP节加上 TMSNAME=TMS_ORA TMSCOUNT=3 OPENINFO=Oracle_XA:Oracle_XA+Acc=P/scott/tiger+SesTM=120+LogDir=.+SqlNet=abcde具体在Oracle联机文档Application Development-oracle8 Application Developments Guild-Oracle XA-Defining the xa_open String中提供了解释3. 在oracle用sys用户登录sqlplus，a) 运行$ORACLE_HOME/rdbms/Admin/xaview.sql,b) grant select on v$xatrans$ to public;c) grant select on dba_pending_transactions to scott; d) commit;4.运行 buildtms -o $(TUXDIR)/bin/TMS_ORA -r Oracle_XA5. 在tpsvrinit()中EXEC SQL CONNECT .改成 tpopen(), tpsrvdone()中EXEC SQL DISCONNECT.改成tpclose(); 实际可拷贝$TUXDIR/apps/bankapp/appinit.c6.需在ubb文件中MACHINE节指定TLOGDEVICE,TLOGSIZE例:TLOGDEVICE=/home/usr1/TLOGDEV TLOGSIZE=5007.建立TLOG文件直接拷贝$TUXDIR/apps/bankapp/crtlog.sh.设定相关的环境变量后运行该shell文件.8.启动事务用tpbegin(3,0),提交回滚用tpcommit/tpabort.四、Tuxedo多机方式配置要点tuxedo多机方式配置有两个方面4.1启动tlistentlisten在tuxedo启动时扮演控制者的角色,在非master机上由tlisten启动bbl和应用服务器,tlisten的启动方法为tlisten -l /hostip:ipport 1注意这里的ipport必须和ubb文件中NETWORK域的NLSADDR一致,最好都用IP地址，以避免双方对同一机器名解释出不同的IP地址。2 tlisten必须在所有的机器上启动,启动后才能运行tmboot.建议操作系统启动时就运行tlisten.3注意各个节点的tlisten都有PASSWORD，存在%APPDIR%.admtlisten.pw文件下，如果那里没有，就读TUXEDO的%TUXDIR%udataobjtlisten.pw文件中的内容。各节点的tlisten password要保证绝对一样（包括回车！）。否则会报错：Security Violation。4.2 ubb文件配置对于多机模式一般就是指单一domain管理的多台机器,所有机器上仅需要一个ubb文件,以下是ubb文件的模板*RESOURCESIPCKEY80952MAXACCESSERS40MAXSERVERS35MAXSERVICES75MASTERSITE1,SITE2OPTIONSLAN,MIGRATE / MIGRATE表示MASTER可以动态迁移MODELMP/ 多机模式*MACHINESPATRICKLMID=site1APPDIR=D：/Bea/tuxedo/samples/atmi/simpappTUXCONFIG=d:/Bea/tuxedo/samples/atmi/simpapp/tuxconfigTUXDIR= d:/Bea /tuxedoUID=0GID=0TYPE=NTMAXWSCLIENTS=5MAXACCESSERS=40test60LMID=site2APPDIR=/bea/tuxedo/samples/atmi/simpappTUXCONFIG=/bea/tuxedo/samples/atmi/simpapp/tuxconfigTUXDIR=/bea/tuxedoUID=1002GID=101TYPE=SunMAXWSCLIENTS=15MAXACCESSERS=100*GROUPSGROUP1 LMID=site1GRPNO=1OPENINFO=NONEGROUP2 LMID=site2GRPNO=2OPENINFO=NONE*SERVERSDEFAULT:DEFAULT: RESTART=Y MAXGEN=5 REPLYQ=Y CLOPT=-AWSLSRVGRP=GROUP1 SRVID=20 CLOPT=-A - -n /01:9009WSLSRVGRP=GROUP2 SRVID=10 CLOPT=-A - -n /00:9009simpservSRVGRP=GROUP1 SRVID=3simpservSRVGRP=GROUP2 SRVID=4*SERVICES*NETWORKsite1NADDR=/01:6044 NLSADDR=/01:6045site2NADDR=/00:6044NLSADDR=/00:6045# BRIDGE=/dev/tcp4.3 管理只能在master机上运行tmadmin进行管理。要获得统计信息在tmadmin中应运行default m命令。$tmadmindefault m SITE1psrbbi当MASTER主机意外当机时，TUXEDO仍可以正常运行，可以在backup的节点上手工做MASTER的动态迁移，在当前的backup节点上 DBBL充当MASTER。$tmadminmWindows NT/2000下要注意的问题：1.由于NT机器上MAXACCESSORS受IPC的限制通常较小,因此建议在MACHINES部分单独设置MAXACCESSORS.2.在MACHINES部分要单独设置UID=0和GID=03.和其他类型的CPU机器互连时,在MACHINES部分一定要指定不同的TYPE.否则将提示tlisten版本不匹配。TUXEDO在SERVER和CLIENT之间进行数据交换缺省进行数据翻译,但一个domain的server之间缺省不进行数据翻译!5.有时LANG环境变量无法改变为C, 可以在 %TUXDIR%locale创建文件夹 mkdir %LANG%.6.RM文件使用中发现有效的RM后一定要有回车,否则将报RM不存在.五、用JOLT连接Tuxedo和Weblogic5.1在Tuxedo上安装、配置JOLT Server1 安装JOLT Server 2 - set your environmentset TUXDIR=d:beatuxedo set JOLTDIR=%TUXDIR%udataobjjoltset APPDIR=%TUXDIR%samplesatmisimpappset PATH=%TUXDIR%bin;%JOLTDIR%bin;%APPDIR%;%PATH%set NLSPATH=%TUXDIR%localeCset TUXCONFIG=%APPDIR%tuxconfigset FIELDTBLS32=jrep.f32;jwsladmin.f32set FLDTBLDIR32=%TUXDIR%udataobjjoltudataobjappletviewer RE.html3 added in UBBconfig file JSLSRVGRP=GROUP1 SRVID=6 CLOPT=-A - -n /12:9001JREPSVRSRVGRP=GROUP1 SRVID=7 CLOPT=-A - -W -P d:BeatuxedoudataobjjoltrepositoryjrepositoryJREPSVRSRVGRP=GROUP1 SRVID=8 CLOPT=-A - -P d:Beatuxedoudataobjjoltrepositoryjrepository5.2 配置Weblogic Server 6.x1,Download the Jolt client package for WLS from , unzip it and copy the jar file to %WL_HOME%lib. Then add the jar files into your Weblogic domain environment file:classpath=%classpath%;%WL_HOME%libjolt.jar;%WL_HOME%libjoltweblogic.jar2,Config Jolt pool manager startup class in Weblogic a,start Weblogic and access the console b,create Startup class and Shutdown classin console:Deployments-Startup & Shutdown,right clickselect create a new StartUp class.:name:demojoltpoolStartupclassname:bea.jolt.pool.servlet.weblogic.PoolManagerStartUp3,Create a jolt poolin console:Services-Jolt,right clickSelect the panel:Configurationin TAB Generalname:demojoltpoolMinimum Pool Size:1Maximum Pool Size:3Click the button Createin TAB addressPrimary Address:/hostname:portFailover Address:/hostname:portClick the button ApplySelect Targets:in Listbox Available:select your server add into the listbox ChosenClick the button Apply4. Restart your Weblogic5.3 Example setup1. Run %WL_HOME%configexamplesetExampleEnv.cmd, 2. compile the SimpAppServlet by:javac -d %EX_WEBAPP_CLASSES% SimpAppServlet.java3. Edit WL_HOME%configexamplesapplicationsexamplesWebAppWEB-INFweb.xmladd the servlet description: JoltServlet examples.jolt.servlet.simpapp.SimpAppServlet JoltServlet /joltservlet 4. Edit a html and put it to %WL_HOME%configexamplesapplicationsexamplesWebApp内容包含调用JoltServletType some text here and click the Post button:5. Goto %WL_HOME%configexample, start the examples domain, 6. Access http:/localhost:7001/examplesWebApp/jolt.html六、TUXEDO动态配置TUXEDO的动态配置可以通过tmadmin和tmconfig两个命令行工具实现不同级别的配置修改。tmadmin的作用主要是监控TUXEDO的运行，可以修改服务的参数；而tmconfig功能更强大，可以在线修改当前TUXEDO的系统UBB配置，即通过MIB修改用UBBCONFIG生成的二进制TUXCONFIG在内存的拷贝。6.1 用tmadmin修改配置进入tmadmin后用命令help可以列出所有命令。6.2 用tmconfig更改TUXCONFIG（UBBCONFIG）tmconfig工具实际上遍历TUXCONFIG的内容并通过MIB API修改其配置。要正确运行tmconfig，建议设置以下环境变量：TUXDIR=/usr/tuxedoTUXCONFIG=/usr/app/tuxconfigEDITOR=vi主要的界面如下： $ tmconfig Section: 1) RESOURCES, 2) MACHINES, 3) GROUPS 4) SERVERS 5)SERVICES 6) NETWORK 7) ROUTING q) QUIT 9) WSL 10) NETGROUPS 11) NETMAPS 12) INTERFACES 1: Operation: 1) FIRST 2) NEXT 3) RETRIEVE 4) ADD 5) UPDATE 6) CLEAR BUFFER 7) QUIT 1: 4 Enter editor to add/modify fields n? Perform operation y?1. 用tmconfig增加新主机1. 进入tmconfig后，选择2）MACHINES项2. 然后可以先选择3）RETRIEVE看看当前的配置，缺省是第一个MACHINE的配置3. 通过选择2）NEXT可以一直向后搜索MACHINE配置，直到空记录为止。4. 选择4）ADD Enter editor to add/modify fields n? y 5. 进入vi编辑状态，可以按照一定格式增加配置。格式为：MIB域名tab值6. 增加MACHINE必须加入以下的域：o TA_TUXCONFIGo TA_TUXDIRo TA_APPDIRo TA_TLOGDEVICEo TA_TLOGSIZEo TA_PMIDo TA_LMIDo TA_TYPE例：TA_TUXCONFIG /usr/apps/bank/tuxconfigTA_TUXDIR /usr/tuxrootTA_APPDIR /usr/apps/bankTA_TLOGDEVICE /usr/apps/bank/TLOGTA_ULOGPFX /usr/apps/bank/ULOGTA_ENVFILE /usr/apps/bank/ENVFILETA_TLOGSIZE 150TA_PMID SERVER109TA_LMID SITE1TA_TYPE Sun7. 存盘退出vi，执行操作即可。 8. 激活新增的MACHINE： 重新选择2）MACHINES 5)UPDATE9. 进入vi后查找TA_STATE,将其值从NEW改为ACTIVE10. 存盘退出vi并执行操作。2. 用tmconfig增加新Server进程1. 进入tmconfig后，选择2）SERVER项2. 可以先选择3）RETRIEVE看看当前的配置，缺省是第一个SERVER的配置3. 通过选择2）NEXT可以一直向后搜索SERVER配置，直到空记录为止。4. 选择4）ADDEnter editor to add/modify fields n? y 5. 进入vi编辑状态，可以按照一定格式增加配置。格式为：MIB域名tab值6. 增加MACHINE必须加入以下的域：o TA_SERVERNAME o TA_SRVGRP o TA_SRVID 例：TA_SERVERNAME /usr/apps/bank/teller_serverTA_SRVGRP GROUP1TA_SRVID 157存盘退出vi，执行操作即可。 七、系统核心参数参考Message Queues Parameters MSGMNI: Total Number of Queues (Use this formula: Add MAXACCESSERS + (No. Servers with Reply Queues) - (No. Servers in MSSQ Set) + (No. MSSQ Sets) + 7) to determine the appropriate value MSGMAP: Number of entries in control map used to manage message segments (Not defined in NT). Set to 2 * MSGMNI MSGMAX: Maximum message size in bytes. Set to the largest message size or 75% of the queue size (whichever is bigger) MSGMNB: This is the queue size itself (64K, 128K, etc.) MSGSSZ: Size of a segment in bytes (Not defined in NT). The value of MSGSSZ should be such that a multiple of MSGSSZ is equal to the size (including the BEA TUXEDO System header) of the most commonly sent message. Usually set to 16, 32, or 64. MSGTQL: Total Number of In-Flight messages in the system at once MSGSEG: Number of message segments in the system (Not defined in NT). You need to find out the queue space of your machine and then the following formula applies: MSGSEG * MSGSSZ = Machine Queue Space Size (note it will swap)Semaphores Parameters SEMMNS: Maximum number of semaphores in the system. The minimum requirement for SEMMNS is MAXACCESSERS - MAXWSCLIENTS + 13 (local clients and all servers) SEMMNI: Maximum number of active semaphore sets. For small apps,(100 to 500 servers),10 sets are usually sufficient. For large apps, (500 servers) 32-64 sets are usually sufficient (do a tmloadcf -c to see which is the best) SEMMSL: Maximum number of semaphores per semaphore sets (Not defined in NT). Use the formula: SEMMNS = SEMMNI * SEMMSL SEMMAP: Size of the control map used to control semaphore sets (Not defined in NT). Set to SEMMNI SEMMNU: Number of undo structures in the system. Set to SEMMNS SEMUME: Maximum number of undo entries per undo structure (Not defined in NT). Set to SEMMNSShared Memory Parameters SHMMAX: Maximum shared memory segment size in bytes. Bulletin Board Size (must be greater than 1,400,000). Largest BB today is approx. 5 MB (this parameter is normally set much higher for the database, so use their rules) SHMSEG: Maximum number of segments one process can attach to (for a busy application you need to set this from 32-64) SHMMNI: Maximum number of shared memory identifiers in the system. Normally the default of 100 is acceptable (unles