This chapter explains multiple portals and how to manage a portal and Portal Server instances. The topics provided include the following:
Multiple portals share the same user set. The features of multiple portals include the following:
A portal is identified by a URL. For example: http://hr.xyz.com/portal or http://eng.xyz.com/portal
Multiple portals share the same user repository, which is the same Access Manager and the Directory server. You use Access Manager to manage end users, and you do not need to synchronize end-user data in LDAP with any other repository. All data related to end users resides in only one directory server.
You can deploy multiple portals and Portal Server instances on one or more hosts. For example, one host may have two portal server instances serving content for one portal and three Portal Server instances serving another portal. Each Portal Server instance must run inside a different web container instance.
All portals share these components:
Rewriter - Although this component is shared, you can define a different rule set for each portal.
SSO Adapter - Although this component is shared, you can define a different adapter for each portal.
All Secure Remote Access services
The following components have a one-to-one relationship with portals:
Desktop - Each portal has an independent Desktop.
Subscriptions - This is configured differently per portal.
WSRP - Producer and Consumer - Independent set of Producers and Configured Producers for each portal.
Search can have a many-to-many relationship with portals:
One portal can use one search server.
Many portals can use a single search server.
Each portal can use more than one search server.
End users see different content for different portals and can customize the each portal's Desktop. Single sign-on between portals is possible. An end user who has access to two portals at a corporation would typically experience the following sequence:
Types in a URL for Portal One and authenticates using the corporate identify.
Views personalized content on Portal One.
Types in a URL for Portal Two without needing to provide authentication.
Views personalized content on Portal Two.
Portals that use different Access Managers are not multiple portals. They are independent and unrelated portals, each with its own set of users.
Access Manger can be a collection of its own instances, all using the same set of Directory Server instances. Different Access Managers are two unrelated Access Managers, not different instances of the same Access Manager.
A portal consists of one or more portal server instances that deliver the same content and are mapped to a single Uniform Resource Locator (URL). The content and services delivered by a portal are common to all its instances.
Multiple portals share the same user set. These portals can be deployed on one or more hosts, but they all share the same user repository — the same Access Manager and the Directory server.
Portals that use different Access Managers are not multiple portals. They are independent and unrelated portals, each with its own set of users.
Access Manger can be a collection of its own instances, all using the same set of Directory Server instances. Different Access Managers are two unrelated Access Managers, and not different instances of the same Access Manager.
This section explains how to complete the following tasks:
You can view a list of Portal Servers that are already set up.
During Portal Server installation, a default portal named portal1 is created. You can also create a new portal server using the Create Portal wizard.
Select the Portals tab.
Click the New Portal button to launch the wizard.
Provide a unique name for the Portal Server, for example, portal5.
Type a URI that enables end users to access the Portal Server, for example, /portal.
Enter Web Container Information.
The available types are the following:
Sun JavaTM System Web Server 6.0
Sun Java System Web Server 7.x
Sun Java System Application Server 8.x
BEA WebLogic 8.1SP4/SP5
IBM WebSphere 5.1.1.6
(Optional) Change the default web container instance properties.
For information, see Creating a New Portal in Sun Java System Portal Server 7.1 Configuration Guide.
Verify the information you supplied.
Click Finish to create the new portal.
(Optional) View the log file to monitor the process.
Templates for webcontainer.properties for supported web containers are in the portal-install-dir/template directory.
You can delete all existing instances of a portal on all hosts and clean up the portal's data in the Access Manager LDAP directory.
Select the Portals tab.
From the list of portals, select the portal you want to remove, and click the Delete Portal button.
You can archive the following portal data in a par file:
Data stored in the Access Manager directory
Desktop file system files, located by default in the /var/opt/SUNWportal/portals/portal-URI/desktop directory
Desktop customized classes, located by default in the /var/opt/SUNWportal/portals/portal-URI/desktop/classes directory
Portal Server web applications, located by default in the /var/opt/SUNWportal/portals/portal-URI/war directory
Portal Server web source data, located by default in the /var/opt/SUNWportal/portals/portal-URI/web-src directory
After you archive data, you can import the data to the same portal or to a different portal. To export a portal from psconsole:
Select the Portals tab.
Select a portal from the table.
Click the Export button.
Specify the par file location on the Portal Server machine and what you want to export:
All Desktop data — the exported par includes file system data and display profile data
File system data only — the exported par file includes only the desktop file system data, which is data deployed into the portal desktop and portal web-src
Display profile data only — the exported par includes only display profile data
This command does not support user data in the Directory Server.
You can import into any portal any portal data that you previously exported.
Select the Portals tab.
Select a portal from the table.
The Import Desktop Data page appears.
Click the Import button and specify the following:
Redeploy the portal web applications.
Schedule a time to run the psadmin redeploy command.
Plan to do this step off hours or in system maintenance mode, when your system is not in production. This action redeploys the portal war file, and it logs out users who are running a Desktop, causing them to lose their work.
Run the psadmin redeploy command.
psadmin redeploy -u amadmin -f passwordfile -p portalID --allwebapps
This command does not support user data in the Directory Server.
A Portal Server instance is a web application deployed to a web container. An instance uses a particular Portal Server context URI to serve requests on a specific network port. Each Portal Server instance is associated with a single Portal.
A server instance listens on a particular port, bound to either one IP address or any IP address of the host. For the Portal Server, a server instance corresponds to a deployment container process listening on a port and running a single Java™ Virtual Machine (JVM™ software).
Sun Java™ System Web Server and Sun Java™ System Application Server support multiple instances.
This section explains how to complete the following tasks:
You can view a list of Portal Server instances that are already set up.
Select the Portals tab.
Click the name of Portal Server from the table.
Select the Server Instances tab.
The table displays all the instances of the Portal Server you selected.
Create a new instance for an existing Portal Server on your web container instance.
Start the web container instance.
Start the administration server of the web container.
Select the Portals tab.
Select the name of a Portal Server.
Select the Server Instances tab.
Click on the New Instance button to launch the wizard.
Provide the name of the portal identifier.
Enter Web Container Information.
(Optional) Change the default web container instance properties.
For information, see Creating a Portal on the Same Node in Sun Java System Portal Server 7.1 Configuration Guide.
Verify the information you supplied, and click Finish to create the new portal instance.
A progress bar displays the status of this procedure. When the procedure is complete, a results page is provided.
Click Finish to create your new portal instance.
You can delete an instance of a Portal Server.
Select the Portals tab.
Select the name of a Portal Server.
Select the Server Instances tab.
From the table, select the instance you want to remove.
Click Delete Instance button.