iii
Please Read: Important Trademark Information .................................................................. xi
JBoss Portal - Overview .................................................................................................. xiii
Feature List ..................................................................................................................... xv
Target Audience .............................................................................................................. xix
Acknowledgments ............................................................................................................ xxi
1. System Requirements ................................................................................................. 1
1.1. Minimum System Requirements .......................................................................... 1
1.2. Supported Operating Systems ............................................................................. 1
1.3. JBoss Application Server .................................................................................... 1
1.4. Databases .......................................................................................................... 1
1.5. Source Building .................................................................................................. 2
2. Installation ................................................................................................................... 3
2.1. The JBoss Portal and JBoss AS Bundle .............................................................. 3
2.2. Installing the Binary Download ............................................................................. 4
2.2.1. Setting up your Environment ..................................................................... 5
2.2.2. Deploying JBoss Portal ............................................................................ 8
2.3. Installing from the Sources .................................................................................. 9
2.3.1. Getting the Sources ................................................................................. 9
2.3.2. JBoss EAP and JBoss AS Setup ............................................................ 11
2.3.3. Building and Deploying from the Sources ................................................. 13
2.3.4. Database Setup ..................................................................................... 15
2.3.5. Datasource Configuration ........................................................................ 15
2.4. Deploying JBoss Portal ..................................................................................... 16
3. Customizing your Installation .................................................................................... 19
3.1. Changing the Port ............................................................................................. 19
3.2. Changing the Context Path ............................................................................... 20
3.2.1. Changing the context-root ....................................................................... 21
3.3. Forcing the Database Dialect ............................................................................. 21
3.3.1. Database Dialect Settings for JBoss Portal .............................................. 21
3.3.2. DB Dialect Settings for the CMS Component ........................................... 22
3.4. Configuring the Email Service ............................................................................ 22
3.5. Configuring proxy settings ................................................................................. 23
3.6. Disabling Dynamic Proxy Un-wrapping ............................................................... 24
4. Upgrading JBoss Portal 2.6 to 2.7 ............................................................................. 25
4.1. Usage of JBossActionRequest ........................................................................... 25
5. Portlet Primer ............................................................................................................ 27
5.1. JSR-168 and JSR-286 overview ........................................................................ 27
5.1.1. Portal Pages .......................................................................................... 27
5.1.2. Rendering Modes ................................................................................... 28
5.1.3. Window States ....................................................................................... 28
5.2. Tutorials ........................................................................................................... 29
5.2.1. Deploying your first Portlet ...................................................................... 29
5.2.2. JavaServer™ Pages Portlet Example ..................................................... 36
6. XML Descriptors ........................................................................................................ 45
