一、下载uPortal
http://www.jasig.org/uportal/download
二、uPortal Environment Requirements
安装uPortal之前需要安装一下软件:
- Java 1.6 Update 21 (or later)orJava 7
- Maven 3.0.3+
- Ant 1.8.2
- The Servlet Container (such as Tomcat 6.x or 7.x)
- Database(uPortal默认是用hsqldb,可以根据需求修改为postgresql或者oracle等)
配置好环境变量:
ANT_HOME=/path/apache-ant-1.8.x
JAVA_HOME=/path/java/jdk1.x
M2_HOME=/path/apache-maven/apache-maven-3.0.x
并且配置好path变量:
path = %ANT_HOME%/bin;%JAVA_HOME%/bin;%M2_HOME%/bin
三、构建和发布uPortal
Step 1: 配置build.properties文件
uPortal的构建需要build.properties文件对uPortal工程的描述和参数信息。
1、备份build.properties文件,防止配置失败,直接可以用它重新配置。
2、打开build.properties文件把server.home配置成为你的容器(如tomcat)的安装路径。
如下图:
Step 2: Configure filters (配置local.properties文件)
该文件位于uPortal的安装路径下的uPortal-4.0.1\filters下面,你需要在这里配置数据库连接、uPortal服务配置、CAS服务配置以及日志信息和LDAP的配置,代码如下:
## HSQL Configuration
environment.build.hsql.port=
8887
## Database Connection Settings (Uncomment the Maven Filters section in rdbm.properties)
environment.build.hibernate.connection.driver_class=org.hsqldb.jdbc.JDBCDriver
environment.build.hibernate.connection.url=jdbc:hsqldb:hsql:
//localhost:${environment.build.hsql.port}/uPortal
environment.build.hibernate.connection.username=sa
environment.build.hibernate.connection.password=
environment.build.hibernate.dialect=org.hibernate.dialect.HSQLDialect
# uPortal server configuration properties
environment.build.uportal.server=localhost:
8080
environment.build.uportal.protocol=http
environment.build.uportal.context=/uPortal
environment.build.uportal.email.fromAddress=portal
@university
.edu
# CAS server configuration properties
environment.build.cas.server=localhost:
8080
environment.build.cas.protocol=http
# Log4J values applied to portlets and portals. See log4j.properties file
# in WEB-INF or resources directory
for
each portlet. This provides a
# single point of control
for
most logging.
environment.build.log.rootLevel=INFO
# Directory to place portal and portlet log files into.
environment.build.log.logfileDirectory=${catalina.base}/logs
# Assume a DailyRollingFileAppender is used. Set the pattern to daily log-file roll-overs.
# Can also set to hourly, weekly, etc. Use yyyy-MM-dd-HH
for
hourly.
# See http:
//logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/DailyRollingFileAppender.html
environment.build.log.rollingLogFileDatePattern=yyyy-MM-dd
# Pattern to specify format of each log file entry. See http:
//logging.apache.org/log4j/1.2/apidocs/index.html.
environment.build.log.layoutConversionPattern=%5p [%t] %c{
2
}.[%x] %d{ISO8601} - %m%n
environment.build.logback.layoutConversionPattern=%-5level [%thread] %logger{
36
} %d{ISO8601} - %msg%n
# LDAP server connection settings (optional)
# To connect to LDAP, provide your connection information here and uncomment one
# or both integration beans in uportal-war/src/main/resources/properties/contexts/ldapContext.xml
environment.build.ldap.url=
environment.build.ldap.baseDn=
environment.build.ldap.userName=
environment.build.ldap.password=
默认情况下,uPortal 4使用local.properties过滤文件,但是你可以创建自己的过滤器文件,并建立/使用标记来选择需要的过滤器文件部署uportal。
例如,我可以创建一个名为test.properties一个新的过滤器文件,并设置所有的服务器以指向测试服务器。然后,当我构建和部署uPortal我可以使用标志-DENV =test。请注意,这个标志是该过滤文件.properties 的文件名的一部分。此标志适用于Ant和Maven。
Step 3: Configure your database
除了在步骤2中local.properties过滤器文件进入你的数据库服务器的信息,还有额外的数据库配置,可能需要执行。查找您所选择的数据库,并依照步骤数据库特定指令。
uPortal支持一下数据库(默认为hsqldb):
四、修改Tomcat的配置
Shared Libraries
uPortal库放置在CATALINA_BASE/shared/lib 下面,Tomcat 6.0默认不会从这个目录下载需要的jar包。要解决这一点,你必须编辑CATALINA_BASE / conf /中catalina.properties和改变开始“shared.loader =”,如下:
Shared Sessions
Jasig的portlet,以及许多其他流行的JSR-168 portlet的,靠分享门户Web应用程序和portlet应用程序之间的用户会话数据的能力。要启用此功能
- Tomcat 6.0: add the emptySessionPath="true" parameter to the in-use connector (configured in Tomcat in CATALINA_BASE/conf/server.xml).
- Tomcat 7.0 (for uPortal 4.0.10+): add the "sessionCookiePath="/" to CATALINA_BASE/conf/context.xml.
代码如下:
五、JVM Heap Configuration
uPortal需要比可以在默认情况下被分配一个标准的PermGen空间更大的堆内存。一个好的保守的一套堆设置为“-XX:MaxPermSize =300米-Xmx1024m”。还得取决于具体的操作系统:
六、部署uPortal(Deploy uPortal)
在uPortal的安装路径下面运行以下命令部署uPortal并加载数据库
ant initportal
警告:运行此命令将先删除所有表重新初始化您的数据库。如果您对现有数据库的内容将丢失。
七、重启tomcat( Restart Tomcat)
八、访问uPortal(Access uPortal)
在浏览器的地址栏输入一下地址:
如果一切都配置正确,那么将会看到如下页面:
尊重原创,ki_boy于2014-7-4翻译自:https://wiki.jasig.org/display/UPM40/Building+and+Deploying+uPortal