IBM Websphere Portal管理工具
-----XML配置接口
1. 简介
1.1.
Portal管理工具
Portal的管理工具包括以下三种，分别以不同形式完成对portal的一些管理功能。
1.1.1.【管理Portlet】
以WEB页面的方式，提供Portal的各种管理，比如：页面的管理、portal用户的管理、站点管理、主题皮肤管理等等。如下图所示，这是我们管理portal最方便，最常用的工具之一。
1.1.2.【Portal脚本】
这种方式是由Websphere扩展而来，就是说，它是Websphere自带的功能，因为Portal本身也是基于Websphere的，使得portal也具有该功能。
这种脚本执行功能强大，也可以使用ANT的构建、批处理功能，同时集成TCL、JACL脚本（TCL语言，一种脚本语言），所以功能非常强大。常见的使用该功能的有Portal的一些复杂的内部管理，如：LDAP用户迁移、数据库迁移等。
1.1.3.【XML配置接口】
XML配置接口是通过配置Portal所能识别的XML格式文件，以达到更新potal配置的目的。XML文件作为一种功能输入，让Portal明白你让它给你做些什么事情，同时，一些Portal的配置信息，如页面、portlet等可以导出为一个XML文件。
1.2. 什么时候使用XML配置接口
1.2.1.完整或者部分环境的迁移
从一个Portal中拷贝部分配置，比如页面配置信息或者授权信息；很典型的应用场面就是你在做一个Portal试验环境中进行程序的安装部署和测试，然后需要从这台测试的Portal Server上，把所有配置信息转移到生产环境的Portal上去的时候；
1.2.2.安装部署portal资源
安装额外的资源到Portal中，比如，你开发的Portlet程序，就可以使用XML配置界面把war包部署到Portal中去，同时，把相关Portlet部署到相关页面上，创建页面，授权等等，只要是【管理portlet】所能做的功能，它都能做到；
1.2.3.关于备份功能的问题
使用XML配置界面作为备份功能是受的：
1、一个完整的Portal配置导出XML文件，并不能完全重建Portal，你还需要WAR文件和额外的资源文件，如Portal主题文件等；
2、XML配置界面本身设计并不是用于备份的，使用其做备份还原功能的效率会很低。真正的备份还是应该采用数据库和文件级的备份。
2. 任务执行方式
从命令行中，进入到PortalServer\\bin目录下，执行下面的命令： Portal服务器地址，如果在服务器本地执行，输入localhost即可
命令非常简单，【-in export.xml】为输入给portal的信息，即通过这个文件，告诉portal你所需要做的事情。【-user wpsadmin -password wpsadmin】这些是portal管理员用户名和密码，【-url http://portalserver: port /wps/config】为连接操作地址。【-out result.xml】这个是输入结果，即执行完成后，portal把所有所做的事情的情况，都返回并写入到该文件。
xmlaccess -in export.xml -user wpsadmin -password wpsadmin -url
http://portalserver: port /wps/config -out result.xml Portal服务器的端口，缺省6.0为10038，6.1为10040 3. 样本XML
当你看到XML文件的复杂性，你也许就觉得这种配置异常的复杂，但其实不然，因为你可以参考Portal提供样本XML，根据这些XML，作一些简单修改，就可以达到你所需要的目的。
其路径在：\\PORTAL_ROOT\\PortalServer\\doc\\xml-samples
传送完整配置
ExportRelease.xml 导出页面
ExportPage.xml 创建页面
CreatePage.xml
部署portlet
DeployPortlet.xml 克隆portlet
ClonePortlet.xml 修改更新portlet
ModifyPortlet.xml 导出portlet和页面
ExportPortletAndPage.xml 导出子页面
ExportSubTree.xml 。。。。。。
4. 示例
4.1.
安装portlet
4.1.1.示例描述
我们开发了一个Portlet（此处示例一个标准portlet），需要部署到portalServer中，同时把这个Portlet部署到某个页面上去。一般情况，我们是在Portal中的管理portlet中进行安装，然后创建页面，并把Portlet添加到页面中来。此处示例，我们将用XML配置接口来实现这样的功能。
4.1.2.编写XML文件
可参考样本XML文件（\\PORTAL_ROOT\\PortalServer\\doc\\xml-samples）中的DeployPortlet.xml文件，进行修改，修改完该XML文件后， 把本文件放到 wp_profile_root\\PortalServer\\bin文件夹下，它将作为你执行命令的输入信息传入给portal，即告诉portal，你要作什么事情。
XML脚本如下，主要参考war包中的portlet.xml文件：
4.1.3.war包准备
从开发工具中，导出你需要部署的程序war包，并拷贝到服务的目录对应地址，如上图XML文件示例的话，war文件名为PA_changAnDesignChange.war，并拷贝到C盘根目录（例：
）。
4.1.4.执行命令
从DOS命令行进入到文件夹：wp_profile_root\\PortalServer\\bin 输入如下命令：
xmlaccess -in DeployPortlet.xml -user wpsadmin -password wpsadmin -url http://portalserver: port /wps/config -out result.xml Portal服务器的端口，缺省6.0为10038，6.1为10040 Portal服务器地址，如果在服务器本地执行，输入localhost即可 4.2. 完整导出及导入
4.2.1.示例描述
此处示例从一台测试的portal服务器，把所有的portal页面、portlet-war、页面portlet配置等信息都导出来，然后导入到正式服务器中。正式服务器在完成导入后，所有页面和配置等信息，都和测试服务器完全一样。
4.2.2.从测试机导出
4.2.2.1. 导出完整的XML文件
从DOS命令行进入到文件夹：wp_profile_root\\PortalServer\\bin 输入如下命令：（ExportRelease.xml
可从
XML
示例文件夹中
（\\PORTAL_ROOT\\PortalServer\\doc\\xml-samples）拷贝到wp_profile_root\\PortalServer\\bin目录）
xmlaccess -in ExportRelease.xml -user wpsadmin -password wpsadminpwd
-url http:// portalserver:port\\wps\\config -out result.xml Portal服务器的端口，缺省6.0为10038，6.1为10040
执行命令后，所有配置信息都导出到了result.xml中。
Portal服务器地址，如果在服务器本地执行，输入localhost即可 4.2.2.2. 拷贝出war包文件
在测试服务器上，拷贝出wp_profile_root\\PortalServer\\deployed\\archive所有文件，该文件夹下包含了测试服务器portal上当前部署的所有portlet-war包。
4.2.3.导入到正式机
4.2.3.1. 拷贝war包文件
把前面备份出来的war文件，拷贝到正式服务器的该文件夹下：wp_profile_root\\PortalServer\\deployed\\archive。
4.2.3.2. 导入备份到portal
拷贝前面导出来的完整的XML文件result.xml到 wp_profile_root\\PortalServer\\bin目录。
从DOS命令行进入到正式服务器文件夹wp_profile_root\\PortalServer\\bin，输入如下命令： xmlaccess -in result.xml -user wpsadmin -password wpsadminpwd -url http:// portalserver:port\\wps\\config -out 1.xml Portal服务器的端口，缺省6.0为10038，6.1为10040 Portal服务器地址，如果在服务器本地执行，输入localhost即可
执行完成后，重新启动portal服务器即可。
4.3. 用xmlaccess进行Portal主题策略的修改
利用Portal的xmlaccess操作界面，完成数据的导出。 导出的xml脚本
xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"> file:///d:/tmp/DoubleTopNavThemePolicy.xml
这个脚本导出DoubleTopNav这个主题策略到d:/tmp/DoubleTopNavThemePolicy.xml文件中， 执行
xmlaccess.bat
-in
d:/tmp/exportThemePolicy.xml
-user
wpadmin
http://localhost:10040/wps/config xmlaccess在PortalServer/bin目录下
更新主题策略
修改导出的xml文件，更新脚本如下
xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\"> file:///d:/tmp/DoubleTopNavThemePolicy.xml
执行
xmlaccess.bat
-in
d:/tmp/updateThemePolicy.xml
-user
wpadmin
http://localhost:10040/wps/config
-pwd
passw0rd
-pwd
passw0rd
-url
-url