Setting Up Portals

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:

• To List Portals

• To Create a Portal

• To Delete a Portal

• To Export Portal Data

• To Import Portal Data to a Portal

To List Portals

You can view a list of Portal Servers that are already set up.

1. Log in to the Portal Server management console.

2. Select the Portals tab.

Equivalent psadmin Command

psadmin list-portals

To Create a Portal

During Portal Server installation, a default portal named portal1 is created. You can also create a new portal server using the Create Portal wizard.

1. Log in to the Portal Server management console.

2. Select the Portals tab.

3. Click the New Portal button to launch the wizard.

4. Provide a unique name for the Portal Server, for example, portal5.

5. Type a URI that enables end users to access the Portal Server, for example, /portal.

6. Enter Web Container Information.

   The available types are the following:

   • Sun Java^TM 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

7. (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.

8. Verify the information you supplied.

9. Click Finish to create the new portal.

10. (Optional) View the log file to monitor the process.

    1. Log in to the machine where portal is to be created.

    2. Run the psdadmin set-logger command.

       ./psadmin set-logger -u uid -f password -m component-type -O logger-name

Equivalent psadmin Command

psadmin create-portal

Templates for webcontainer.properties for supported web containers are in the portal-install-dir/template directory.

To Delete a Portal

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.

1. Log in to the Portal Server management console.

2. Select the Portals tab.

3. From the list of portals, select the portal you want to remove, and click the Delete Portal button.

Equivalent psadmin Command

psadmin delete-portal

To Export Portal Data

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:

1. Log in to the Portal Server management console.

2. Select the Portals tab.

3. Select a portal from the table.

4. Click the Export button.

5. 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

Equivalent psadmin Command

psadmin export

This command does not support user data in the Directory Server.

To Import Portal Data to a Portal

You can import into any portal any portal data that you previously exported.

1. Log in to the Portal Server management console.

2. Select the Portals tab.

3. Select a portal from the table.

   The Import Desktop Data page appears.

4. Click the Import button and specify the following:

   • The par file path for the imported data. The par file must be located on the Portal Server system.

   • Whether to continue if the storage structure of the portal does not match the archived file you want to import.

5. Redeploy the portal web applications.

   1. 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.

   2. Run the psadmin redeploy command.

      psadmin redeploy -u amadmin -f passwordfile -p portalID --allwebapps

Equivalent psadmin Command

psadmin import

This command does not support user data in the Directory Server.