安装Pluto

安装Pluto

安装二进制发布版

安装二进制发布版

Pluto的二进制发布版与Tomcat(5.0.28版)捆绑在一起。Tomcat是一个web容器,而 Pluto作为一个portlet容器在Tomcat中运行。Pluto的二进制发布版中包含了Pluto Portlet Container,Portal Driver和Pluto Testsuite。

通过以下步骤安装Pluto的二进制发布版:

  • 下载Pluto二进制发布版的当前版本
  • 将下载文件解压缩到一个目录,假设是[PLUTO_HOME]
  • 执行[PLUTO_HOME]/bin目录下的启动脚本来启动服务器:在*nix下执行startup.sh,在Windows下执行startup.bat
  • 用浏览器打开Pluto Portal Driver:http://localhost:8080/pluto/portal

安装库文件发布版

安装库文件发布版

Pluto的库文件发布版可以集成到一个外部的portal服务器中。安装库文件发布版,需保证 pluto-x.x.x.jar文件可以被portal服务器的类载入器(classloader)载入,并可以被 portal以及使用了portlet的web应用程序访问。

安装源代码发布版

安装源代码发布版

源码发布版的安装是最麻烦的,对于那些不想对容器做修改的人而言,这种安装方法是不推荐的。 基本说来,源码发布版是源码库在某个特定时间的快照,所以关于如何从源码构建Pluto,请参 考构建源码指南。

通过以下步骤安装Pluto的源码发布版到Tomcat服务器:

  • 安装Java 1.3或更高版本
  • 安装Maven 1.0或更高版本
  • 安装Tomcat 4.x或Tomcat 5.x,假设安装目录是[TOMCAT_HOME]
  • 修改[PLUTO_HOME]/build.properties文件,使之包含以下属性:
    属性举例
    maven.tomcat.homeTomcat的安装目录 \\usr\\local\\jakarta-tomcat-5.0.27

    C:\\jakarta-tomcat-5.0.27

    maven.tomcat.version.majorTomcat的主版本号5
  • 在[MAVEN_HOME]目录下执行命令:
    maven fullDeployment
                  
  • 执行[PLUTO_HOME]/bin目录下的启动脚本来启动服务器:在*nix下执行startup.sh,在Windows下执行startup.bat
  • 用浏览器打开Pluto Portal Driver:http://localhost:8080/pluto/portal

安装Portlets

安装Portlets

目前,要自动部署和安装portlets,你必须使用Pluto的源码发布版。

为了把portlet应用部署到Pluto,请遵循以下步骤:

  • 把你的portlet应用集成到一个合法的war文件
  • 在你的war文件上执行maven的部署目标,如下:
    maven deploy -Ddeploy=/MyPathToMyPortlet/target/MyPortlet.war
                
    为了使之能正常工作,在此必须进行一些设置(属性等)。
  • 修改Portlet Entity Registry和Page Registry文件。这些配置文件位于:
    [PORTAL_HOME]/WEB-INF/data/portletentityregistry.xml
    [PORTAL_HOME]/WEB-INF/data/pageregistry.xml
                
  • 你必须在Portlet Entity Registry文件中为你的portlet定义一个application和 一个portlet ID。application的ID必须是唯一的,为了能够在web应用的路径中找到 portlet,你还必须定义portlet的名字和portlet的名字到类路径的映射。以下是一个 如何修改Portlet Entity Registry文件的例子:
    <application id="6">
      <definition-id>MyPortlet</definition-id>
      <portlet id="1">
          <definition-id>MyPortlet.MyPortlet</definition-id>
      </portlet>
    </application>
                
  • Page Registry文件为Pluto提供了关于如何布局portlets的信息。fragment的名字 必须保证是唯一的。以下是一个例子:
    <fragment name="MyPortlet" type="page">
      <navigation>
        <title>My First Portlet</title>
        <description>...</description>
      </navigation>
    
      <fragment name="row3" type="row">
        <fragment name="col3" type="column">
          <fragment name="p4" type="portlet">
            <property name="portlet" value="6.1"/>
          </fragment>
        </fragment>
      </fragment>
    </fragment>