Outline

UPORTAL 3.2.X SUPPORT DOCUMENTATION

3.2.x MANUAL

I. UPORTAL: WHAT'S INCLUDED
II. INSTALLING UPORTAL
III. UPORTAL CONFIGURATION
IV UPORTAL SITE ADMINISTRATION
V SYSTEMS ADMINISTRATION DOCUMENTATION (???)
VI DEVELOPER'S GUIDE

UPORTAL: WHAT'S INCLUDED (???)

       ---- https://wiki.jasig.org/display/UPC/uPortal+Architecture+Overview

       --- http://www.jasig.org/uportal/features

       1. Overview --- http://www.jasig.org/uportal

       2. Bundled Portlets -- https://wiki.jasig.org/display/PLT/Home

INSTALLING UPORTAL

    This documentation is for the basic out of the box installation of uPortal and all components needed to support your portal system.

    1. Requirements
        1. Java 1.6
        2. Maven 2.2+
        3. Ant 1.7.1
        4. Servlet Container (Tomcat 6.0+)
        5. Database

  

    2. Apache Tomcat Servlet Container --- https://wiki.jasig.org/display/UPM32/Tomcat+Configuration
        1. Installing/configuring
        2. SSL
        3. Apache HTTP Server (optional)
            a. installing/configuring
            b. mod_jk/mod_proxy

    3. Download
        1. quickstart
        2. source
        3. SVN

    4. Building/Deploying uPortal --- https://wiki.jasig.org/display/UPM32/Building+and+Deploying+uPortal

    5. Database Configuration for uPortal -- https://wiki.jasig.org/display/UPM32/Configuring+a+Database
        1. PostGres -- https://wiki.jasig.org/display/UPM32/PostgreSQL
        2. MySql -- https://wiki.jasig.org/display/UPM32/MySQL+Configuration
        3. MSSQL -- https://wiki.jasig.org/display/UPM32/MSSQL+with+the+jTDS+JDBC+Driver
        4. Oracle -- https://wiki.jasig.org/display/UPM32/Oracle
        5. HypersonicSQL -- https://wiki.jasig.org/display/UPM32/HypersonicSQL
        6. Sybase SQL -- https://wiki.jasig.org/display/UPM32/Sybase+SQL+Server
        7. DB2 --- https://wiki.jasig.org/display/UPM32/DB2
        8. JNDI: Managed Data Sources -- https://wiki.jasig.org/display/UPM32/Using+JNDI+managed+DataSources

    6. Web Contexts
        1. What is a web context?
        2. Included Web Contexts -- https://wiki.jasig.org/display/UPM32/Included+Web+Contexts

    7. Stopping/Starting uPortal

    8. Troubleshooting

 UPORTAL CONFIGURATION

    This documentation goes through configuration options you have customizing your uPortal instance after the basic installation.
    
    1. Authentication

        1. Sources
            1. CAS --- https://wiki.jasig.org/display/UPM32/CAS
            2. LDAP --- https://wiki.jasig.org/display/UPM32/LDAP
                1. Basic Configuration --- https://wiki.jasig.org/display/UPM32/Authenticating+Against+LDAP
                2. Configuring w/ CAS --- https://wiki.jasig.org/display/UPM32/Configuring+the+Bundled+CAS+Server+to+Authenticate+Against+LDAP
            3. Shibboleth -- https://wiki.jasig.org/display/UPM32/Shibboleth
            4. PubCookie -- https://wiki.jasig.org/display/UPM32/PubCookie
            5. Internal Accounts -- https://wiki.jasig.org/display/UPM32/Internal+Accounts

        2. Caching/Replaying Credentials

    2. Layout Management

        1. Distributed Layout Management (DLM) -- https://wiki.jasig.org/display/UPM31/01+Background+Information+on+DLM  https://wiki.jasig.org/display/UPM32/Layout+Management
            2. Configuration Steps

                1. dlm.xml -- https://wiki.jasig.org/display/UPM32/Layout+Management (Introducing the dlm.xml file)

                2. guest fragment
      
                3. defining fragments -- https://wiki.jasig.org/display/UPM32/Defining+DLM+Fragments
                4. defining audiences
                5. setup fragment layouts
            3. Custom UI changes
            4. Filtering Channels -- https://wiki.jasig.org/display/UPM32/Filtering+Channels+within+DLM+Fragments
            5. Future

        3. Caching

    3. Users and Groups

        1. Configuring
            1. Person Directory  
            2. Person Attribute Group Store (PAGS)    
            3. LDAP
            
        
    4. Single-Sign-On (SSO)
        
    5. Skins/Themes
        1. Overview
        2. Customizing
        3. Accessibility
        4. Supported Web Browsers
        5. Tips

    6. Portal Recipes
        1. Adding a Portal Administrator
        2. uPortal: Root Context

UPORTAL SITE ADMINISTRATION (End User Documentation)

    This documentation is intended for portal administrators who are interested in learning the front-end side of uPortal. This will give you instructions on how to use your uPortal system after you have installed and configured your portal.

        1. Managing Content
            1. Adding Content
            2. Publishing Portlets -- https://wiki.jasig.org/display/UPM32/Portlet+Publishing+Types

        2. Managing Users and Groups

        3. Switching Themes

        4. Adding Columns
            
    
SYSTEMS ADMINISTRATOR DOCUMENTATION (???)

    This documentation is intended for administrators who need quick access to troubleshooting tips for maintaining uPortal's backend servers.    

----

    1. Unix/Linux-based    
    2. Windows
    3. OS X
    4. Servlet Container
    5. Web Server (optional)
    6. Database
    7. Security
    8. JAVA performance tuning
    10. Statistics
    11. Troubleshooting
    12. Tips