自动部署工具ControlTier使用指南.doc

ControlTier使用指南一、 安装首先下载ControlTier 3.6的Zip安装包，网址/projects/controltier/files/Installer/3.6.0/ControlTier-3.6.0.zip/downloadControlTier安装分2中，Server端安装和client端安装。Server端是ControlTier服务器所在机器。Client是需要执行自动化部署任务的机器。1Server端安装1.1 设置ControlTier的根目录环境变量CTIER_ROOT，以及创建根目录下pkgs文件夹。$ export CTIER_ROOT=/ctier$ mkdir -p $CTIER_ROOT/pkgs1.2 将安装包放入$CTIER_ROOT/pkgs后然后解压。$ cd $CTIER_ROOT/pkgs$ unzip ControlTier-3.6.0.zip1.3设置JAVA_HOME环境变量。（如果已有，可忽略）$ export JAVA_HOME=/opt/j2sdk1.5.0_151.4执行安装脚本$ cd $CTIER_ROOT/pkgs/ControlTier-3.6.0$ sh install.sh1.5安装结束后。修改.bashrc。使用户登录后ControlTier环境变量立即生效执行。$ vi /.bashrc将 if -f /.ctierrc ; then . /.ctierrc else echo /.ctierrc not found 1&2 fi放入/.bashrc文件末尾。(如果没有设置JAVA_HOME，也可将JAVA_HOME置于此)。然后立即执行，使环境变量生效。$ . /.bashrc1.6修改ssh超时，设为0。表示不设置ssh超时时间。$ vi $CTIER_ROOT/ctl/etc/perties找到framework.ssh.timeout，设置值改为0。1.7 运行ControlTier服务器。$ jetty.sh start1.8 检验安装$ ctl -help2. Client端安装设置环境变量，解压与Server安装1.1, 1.2, 1.3相同。2.1 修改/etc/hosts文件$ vi /etc/hosts增加ControlTier Server的host。例如，server的hostname叫hc-62， ip为2。增加2 hc-62到hosts文件。2.2 Client执行安装脚本$ cd $CTIER_ROOT/pkgs/ControlTier-3.6.0$ sh install.sh -client -Dserver.hostname= 2.3 设置环境变量，于Server安装1.5相同。2.4检验安装$ ctl -helpSsh配置由于ControlTier是Server端通过ssh调用Client的脚本执行部署任务。SSH不能使用密码，因此需要配置public key。ControlTier默认使用DSA。在ControlTier的Server端执行$ ssh-keygen -t dsa当有提示时，全部回车。密码为空。产生/.ssh/id_dsa.pub文件。在ControlTier的Client端$ ssh-keygen -t dsa当有提示时，全部回车。密码为空。将ControlTier Server端产生的/.ssh/id_dsa.pub文件复制到Client端的/.ssh/authorized_keys文件。设置authorized_keys权限$ chmod 600 authorized_keys 设置.ssh目录权限$ chmod 700 .ssh二、安装第一个工程进入ControlTier界面，需要使用火狐或者ie7以上版本。配置好访问机器的Server的hosts.本例使用2 hc-62。访问Server http:/hc-62:8080/点击Workbench (3.6.0) 进入工作台界面。默认用户名密码是default 。点击New Project 创建一个新工程。输入工程名、描述(可选)、组织(可选)，点击Create创建一个新工程。目前ControlTier仅支持英文。点击create开始创建。完成后的界面。现在创建好一个名叫train的工程。点击Node Manager，可以看到当前train工程下的Node列表。 Node即代表注册在工程下的Client主机。因为安装Server时，机器也同时作为一台Client。Client端加入train工程如果其他机器也要加入该工程，成为train部署的Client。在Client端执行$ ctl-project p train a create-p 后面是工程名称。train是刚才Server端建立的工程名称。此时重新进入控制台的Node Manager。发现此时Node列表增加了刚才的Client。在Server端调用Client执行命令$ ctl-exec I hc-61 p train pwd此时输出hc-61的控制台输出。表明ssh配置成功，hc-61已注册train工程。三、创建部署任务资源包在控制台的主界面，点击Package Manager，下一界面点击Package List，在界面坐上角点击在下一界面设置资源参数。大多选项为选填。l 在Choose Type选择资源类型，本例选择war。l Name设置资源包的名称b2bmy.war，Filename同样设置为b2bmy.war。该Filename将决定Client端从Server的文件服务器下载到本地后的文件名。l Filetype 设置为war。l Base Name 设置为b2bmy，该值将决定文件安装包解压到的目录名称。本例由于采用wsadmin安装不涉及解压，所以该设置值无限制。l Version Release Release Tag Architecture Buildtime 可选填。l Install Rank 将决定安装的优先级别。1为最高级别，数字越大安装级别越低。l Install Root 将决定Client端从Server文件服务器下载到本地的哪一目录。本例设置为/temp/my。表示执行部署时b2bmy.war将自动下载到/temp/myl Repository URL 暂不填写。该值表示资源包所在文件服务器的URL。点击save 完成资源包的创建。再次进入Package List, 列出刚创建的资源包。点击该资源进入资源视图-Resource View点击Upload file，在弹出的界面，选择浏览按钮，选择本地要发布的部署文件b2bmy.war。鼠标点击Suggested Path:的右边的链接，该值ControlTier的建议值，将决定资源的URL。本例为/pkgs/train/war/wars。点击Upload按钮上传部署文件。该资源的完整URL将是http:/hc-62:8080/jackrabbit/repository/controltier/pkgs/train/war/wars/b2bmy.war测试。浏览器访问该链接，输入默认用户名及密码default可下载b2bmy.war文件。在该界面点击Parent Referrers (0)，点击，选择该部署文件的将要部署的Client hc-61。点击保存。点击左上角的，返回工作台主界面。四、创建更新服务资源1创建ServiceControlTier把Service定义为资源部署的业务类型， Service类型预定义部署所需的大部分命令。用户可以扩展它，以满足自己的业务需要。为了便于以后ControlTier的更新，我们创建Service的子类型，在子类型上增加我们的业务规则。点击工作台右上角的，再点击Browser，列出ContrlTier的类型。点击Assembly 左边的，Module左边的，直到出现Service 类型。点击Service。在Service类型视图的右上角，点击，输入新类型的名称，本例叫WebsphereWas。点击Save Type创建类型。保存后自动进入WebsphereWas的类型视图。此时创建了名叫WebsphereWas的Service 子类型。注意页面右上角的，有红色感叹号标志。此时需要点击该按钮，以Build该WebsphereWas类型。Build之后该类型才会上传到文件服务器，Client端才可下载更新到该类型。点击之后，图标变为。在WebsphereWas类型创建调用wsadmin的更新命令点击Commands标签，在Commands(25)的右方点击，在弹出对话栏选择Shell Command。/opt/IBM/WebSphere/AppServer/bin在输入框输入wsadmin部署命令。l Name为WebsphereWas类型下命令名称，此例为updateAppl Execution，在linux下为bash，表示bash命令。Arguments为具体的在61DM上执行的部署命令。此处为sh /opt/IBM/WebSphere/AppServer/bin/wsadmin.sh -c $AdminApp update b2bmy_war app -operation update -cluster b2pool -contextroot my -contents /temp/my/b2bmy.war。点Add Command完成。Client端执行部署的第一步，是需要从文件服务器获取安装部署资源文件。需要定义一个下载命令。由于ControlTier 已经package已经定义了下载命令，因此Service只需要执行调度命令调用Package类型资源的下载方法get。调度需要采用Dispatch Command。它能对资源的子资源进行命令调度。点击Commands 最右边的，添加命令，弹出对话框选择Dispatch Command，调度命令。新窗口Name表单输入命令名称getPackage。点击Add Command保存命令。在Dispatch Command编辑视图的Command Name中输入Package类型的下载资源命令get。Strategy选择Local Dispatch表明该调度指令只在Service资源所在本机执行，选择后点击set按钮。在Dispatch Targets区域，该区域运行输入规则表达式。Relation Type输入Package，表示命令的调度目标必须为Package类型或其子类型。点击Update Command保存命令。在Commands标签下的命令列表找到 Deploy命令，该命令由Service类型继承。 是Workflow 命令，它会顺次调用类型的Stop , Packages-Install , Configure , Start命令。由于本例采用wsadmin执行热部署，不需执行stop、start以重启服务。点击右边。覆写从Service继承的该命令。此时Deploy命令左边的图标由变为。再点击，编辑该命令。进入Workflow编辑页面。点击Stop、Packages-Install和Start命令右边的，删除。在右边的Controls下拉列表框选择刚才新增的updateApp、getPackage命令点击Add Command按钮。命令被添加到左边的Command Sequence列表中。点击把get命令调整到第一位， updateApp调整到第三位。点击Update Command。保存。再次点击界面右上角的Build Type。再点击Resource(0)标签。创建该类型下的一个WebsphereWas资源。点击+符号。输入WebsphereWas资源信息。l Name为实例名称。此处命名为61servie，标明该service资源将安装到61机器l Base Directory 以及 Install Root Directory，该例未使用，可空。l Startup Rank表示启动级别。数值越大级别越低。ControlTier可同时并发运行多Service资源，按照Startup Rank来决定优先执行顺序。点击Save保存该资源。进入Resource(1)标签，刚才创建的资源出现在下方。点击该资源。进入资源视图。Resource View选择要部署资源包作为61service的子资源。点击Child Resource的add。在修改子资源视图选择资源包b2bmy.war。点击SAVE，将b2bmy.war资源作为61service的子资源。重新回到61service的资源视图， 点击Parent Referrers (0)的Add，进入父资源视图。选择要执行部署的机器hc-61。点击SAVE，这样hc-61Client就拥有了执行部署命令61service资源。2. 创建Site建立Site类型。ControlTier的Site类型被设计成拥有一组Service资源，用来执行跨环境的一组Service的部署任务。只需执行Site的Deploy，Site会将部署委派给它下面的Service子资源执行部署任务。通过点击右上角的Search/Browser导航到Site类型。点击Site进入类型视图，在点击右上角的Create Subtype，创建Site的子类型MySite。点击Save Type保存类型。最后同样点击Build Type。Build类型。在MySite类型视图Resource标签页，创建资源，hcsite。点击Save保存。此时在MySite类型的R