JBoss Portal 用户手册 002 安装

二、安装

1、JBoss Portal与JBoss AS捆绑版的安装

这种安装方式为安装运行JBoss Portal最快速的方式。捆绑包中包含了JBoss AS、JBoss Portal以及内置了HSQL数据库。

1. 获得捆绑包：从这里下载 ，下载名字类似JBoss Portal + JBoss AS的项目。
2. 解压缩：随便你解压缩到哪里。本文统一将解压缩目录命名为%JBOSS_HOME%。
3. 运行服务器：进入%JBOSS_HOME%/bin。Windows中，运行run.bat；Linux中，运行sh run.sh。可以添加运行参数，例如，以默认配置启动，可以添加参数-c default。
4. 登录JBoss Portal：打开浏览器，访问地址http://localhost:8080/portal，即可访问JBoss Portal首页。从以下两个用户中选择一个登录：user/user，admin/admin。

JBoss Portal首页

SQL错误

JBoss Portal首次启动的时候会自动在数据库中创建相关表。在创建表的过程中，控制台会报如下错误，可以忽视。

 

WARN [JDBCExceptionReporter] SQL Error: -22, SQLState: S0002
ERROR [JDBCExceptionReporter] Table not found in statement ...
WARN [JDBCExceptionReporter] SQL Error: 1146, SQLState: 42S02
ERROR [JDBCExceptionReporter] Table 'jbossportal.jbp_cms_repositoryentry' doesn't exist
WARN [JDBCExceptionReporter] SQL Error: 1146, SQLState: 42S02
ERROR [JDBCExceptionReporter] Table 'jbossportal.jbp_cms_version_refs' doesn't exist

2、二进制版的安装

如果你符合以下情况，那么建议你使用这种安装方式：

• 已经安装了JBoss EAP
• 已经安装了JBoss AS
• 想要将JBoss Portal安装在集群服务器上

 

二进制数据包中通常包含以下内容：

• jboss-portal.sar目录
• 文档
• 配置好的一些数据源文件（让JBoss Portal能够与扩展的数据库相集成）

2.1环境配置

2.1.1下载二进制版数据包

访问下载页面，找到JBoss Portal Binary包，下载并解压缩后，二进制包的目录结构如下图：

2.1.2JBoss EAP与JBoss AS安装

在安装JBoss Portal之前，请确保你已经安装了JBoss EAP或者JBoss AS。如果你已经加入了JBoss客服中心（JBoss Customer Support Portal，CSP） ，那么请下载JBoss EAP。否则请下载JBoss AS 。详细安装步骤，可以参考JBoss AS安装教程 。

注意：必须将JBoss Portal安装到解压缩版的JBoss EAP或JBoss AS中，安装版的JBoss EAP或JBoss AS无法安装JBoss Portal。

2.1.3配置环境变量

必须添加操作系统的环境变量JBOSS_HOME，指向JBoss EAP或者JBoss AS的根目录。

Windows操作系统：

Linux操作系统：

1、以你想要运行JBoss EAP或者JBoss AS的用户登录Linux，打开~/.bashrc文件，添加export JBOSS_HOME=/path/to/jboss/installation/

2、执行命令：source ~/.bashrc，用以启用JBOSS_HOME环境变量。

 

注意：如果你使用的是JBoss EAP，那么需要将JBOSS_HOME环境变量指向目录/path/to/jboss-eap-version/jboss-as/

2.1.4安装数据库

JBoss Portal需要数据库来存储数据。虽然内置了HSQL作为默认的数据库，不过这仅用于开发测试。正式运行，我们建议使用MySQL4或5、MSSQL、PostgreSQL 8、Oracle 9或10。JBoss Portal可以使用任何Hibernate支持的数据库。

配置数据库的方法为：

1. 新建一个数据库：新建名为jbossportal的数据库。
2. 授权：将jbossportal数据库的相关权限赋予指定用户。并且该用户的用户名与密码需要与数据源文件中指定的相同。
3. 安装JDBC：将JDBC文件复制到$JBOSS_HOME/server/default/lib/目录下。关于数据库的JDBC包，请参考各数据库的官方网站。

2.1.5数据源描述文件

二进制下载包的setup目录中包含了一些预先配置好的数据源文件。复制与你的数据库对应的文件到$JBOSS_HOME/server/ configuration /deploy/目录下。其中configuration可以为all、default、minimal或production（production只在JBoss EAP下才有）。最后确认数据源配置文件中的内容与你的实际情况是否符合。主要检查用户名、密码、连接字符串与驱动类的配置。有关数据源文件的更多信息，可以参考JBoss JDBC 数据源文件说明页面 。

2.2部署与启动JBoss Portal

参考1、JBoss Portal与JBoss AS捆绑版的安装中第三步以后部分。

3、通过源代码安装

3.1获得源代码

下载页面：JBoss Portal Downloads

下载包名称：JBoss Portal Source Code

同样可以从SVN上下载源代码，SVN地址为：http://anonsvn.jboss.org/repos/portal/branches/JBoss_Portal_Branch_2_7

一些子模块已经从主SVN中分离出来了。分别如下：

• JBoss Portal Common 1.2.4: http://anonsvn.jboss.org/repos/portal/modules/common/tags/JBP_COMMON_1_2_4
• JBoss Portal Web 1.2.3: http://anonsvn.jboss.org/repos/portal/modules/web/tags/JBP_WEB_1_2_3
• JBoss Portal Test 1.0.3: http://anonsvn.jboss.org/repos/portal/modules/test/tags/JBP_TEST_1_0_3
• JBoss Portal Portlet 2.0.6: http://anonsvn.jboss.org/repos/portal/modules/portlet/tags/JBP_PORTLET_2_0_6
• JBoss Portal Identity 1.0.8: http://anonsvn.jboss.org/repos/portal/modules/identity/tags/JBP_IDENTITY_1_0_8
• JBoss Portal CMS 1.2.4: http://anonsvn.jboss.org/repos/portal/modules/cms/tags/JBP_CMS_1_2_4

最终的目录结构如下图：

如果是从SVN下载的源代码，那么上图所示的目录结构在trunk/src/下。这是thirdparty目录下是空的，编译后才会出现。更多有关SVN的信息以及从SVN中下载其他版本的代码，请参考JBoss Portal SVN Repo。

3.2、JBoss EAP与JBoss AS安装

参考2.1.2与2.1.3

3.3、编译与部署

首次编译时，第三方包是从网上临时下载的，所以你需要连接到互联网。如果你通过代理连接互联网，那么需要配置代理信息。配置代理的方法为在$JBOSS_HOME/bin/run.conf文件中修改一下信息：

JAVA_OPTS=-Dhttp.proxyHost=<proxy-hostname> -Dhttp.proxyPort=<proxy-port>

切换到JBOSS_PORTAL_SOURCE_DIRECTORY/build/目录下，执行编译程序：

Windows：build.bat deploy

Linux：sh build.sh deploy

 

在编译进程的最后，jboss-portal.sar目录会被拷贝到$JBOSS_HOME/server/default/deploy/目录下。

 

注意：Portal模块

前面介绍的步骤安装部署的是一个干净的没有额外模块的JBoss Portal。之前的版本中，会自动编译部署一些附加组件。不过现在，这些模块都已经分离出去了。这样JBoss Portal能够更好的实现模块化，并且能够让额外组件的安装更加灵活。如果你想要部署额外组件，请查看模块列表 。如果你想要直接编译部署所有的模块，那么可以执行以下命令：

Windows：build.bat deploy-all

Linux：sh build.sh deploy-all

 

在Linux操作系统中，编译部署集群服务器版本：

1. 切换到JBOSS_PORTAL_SOURCE_DIRECTORY/build/目录下，执行命令sh build.sh main
2. 切换到JBOSS_PORTAL_SOURCE_DIRECTORY/core/目录下，执行命令sh build.sh deploy-ha
3. jboss-portal-ha.sar会自动部署到$JBOSS_HOME/server/all/deploy/目录下
4. 在Windows环境下的操作完全类似，只要将sh build.sh换成build.bat

3.4安装数据库

参考2.1.4

3.5数据源文件配置

参考2.1.5

4、部署JBoss Portal

参考1、JBoss Portal与JBoss AS捆绑版的安装中第三步以后部分。