Appendix D Understanding How Portal Server Files and Directories Are Installed

This appendix describes the Sun Java^TM System Portal Server directory structure and properties files used to store configuration and operational data.

Directories Installed for Portal Server

Table D–1 shows the SPARC® platform-specific directory structures that are installed for Portal Server.

Table D–1 Portal Server Directories

Description	Location
Default installation directory	portal-server-install-root/SUNWportal
Default installation directory for configuration information	/etc/opt/SUNWportal
Default installation directory for SDK	portal-server-install-root/SUNWportal/sdk
Temporary files	/usr/tmp
Log files	/var/opt/SUNWam/log /var/opt/SUNWportal/portals/portal-instance/logs The default instance directory is portal1
Search Engine logging, configuration, and data directories	/var/opt/SUNWportal/searchservers/search-server-instance The default search server instance name is search1
Container and channel display profile	portal-server-install-root/SUNWportal/par-src/default-portal/dp/global-desktop.xml
HTML template files	/var/opt/SUNWportal/portals/portal-instance/desktop/default/provider-name/html The default portal instance name is portal1
JSP template files	/var/opt/SUNWportal/portals/portal-instance/desktop/default/*jsp The default portal instance name is portal1
Command-line utilities	portal-server-install-root/SUNWportal/bin/
Tag library definitions	/var/opt/SUNWportal/portals/portal1/desktop/default/tld/*tld
Display profile DTD	/etc/opt/SUNWportal/dtd/psdp.dtd
Java properties files	/var/opt/SUNWportal/portals/portal1/desktop/classes/

Directories Installed for Secure Remote Access Server

This section describes the Sun Java System Secure Remote Access directory structure and configuration files used to store configuration and operational data.

Table D–2 shows the platform-specific directory structures that are installed for Secure Remote Access.

Table D–2 Portal Server Secure Remote Access Server Directories

Description	Location
Default installation directory	portal-server-install-root/
Default installation directory for configuration information	/etc/opt/SUNWportal
Log files	/var/opt/SUNWportal/logs

Portal Server Log File Locations

Log files provide information about installation status or error reporting. Table D–3contains a list of log files and locations that you can use to troubleshoot and view install information.

Table D–3 Log File Locations

Log File	Location
Java Enterprise System installer logs   These logs contain information about portal packages installed and basic configuration status.	/var/sadm/install/logs
Detailed Portal Server configuration logs	/var/opt/SUNWportal/logs/config/portal.fabric.0.log
Portal Admin and Mbean logs	/var/opt/SUNWportal/logs/admin/portal.0.0.log
Runtime Portal instance logs	/var/opt/SUNWportal/portals/portalID /logs

Portal Server File Locations

Table D–4 Portal Server File Locations

Files	Location
Portal Server packages	/opt/SUNWportal/
Host-level configuration files	/etc/opt
Instance structure and files	/var/optSUNWportal contains the following: derby logs portals/portal-ID Communitytemplates config desktop portletapps War Web-src wiki searchservers/server-ID

Portal Server Community Sample Files

The community sample files allow you to set up and configure a community. The following sections list the locations of the community sample files:

Community Template Locations

The community templates are located in /var/opt/SUNWappserver/domains/domain1/applications/j2ee-modules/portal/communitytemplates. The following list shows the template directories and property file names for the community sample:

• 2column/ — Directory location for the two-column template contents.

• 2column.properties — Properties file for the two–column template.

• menucontainer/ — Directory location for the left-side navigation template contents.

• menucontainer.properties — Properties file for the left-side navigation template.

• wiki/ — Directory location for the wiki template contents.

• wiki.properties — Properties file for the wiki template.

Dynamic Content File Locations

Dynamic Content files are located in /var/opt/SUNWportal/portals/portal1/desktop/community_sample/.

• tld/portletSetupTags.tld — Provides single tag to include Lockhart theme support for stylesheet and JavaScript functionality.

• message.properties — Provides properties used in error/*.template files.

• openURLInParent.js — Provides JavaScript to allow for detached portlets.

• singlePreferenceMenubar.jsp — Provides menu bar used by JSPDynamicSingleContainer.

• singlePreferenceHeader.jsp — Provides header used by JSPDynamicSingleContainer.

• header.jsp — Provides header used by all other containers.

• footer.html — Provides footer used by all containers.

• error — Provides error templates.

• datetime.jsp — Provides for date/time in header.

• breadcrumb.jsp — Provides for breadcrumb trails in headers.

• SearchProvider — Provides for Community look and feel changes.

• portletEdit.jsp — Wraps portlet and Provider content in edit page.

• PagePreferencesContainer — Provides for changing Container content and layout preferences

• Login — Provides for login and account creation.

• JSPTableContainerProvider — Provides for portlets in row/column layout.

• JSPMenuContainerProvider — Provides for left-side navigation layout.

• JSPEditContainer — Provides for portlet and Provider preference editing.

• JSPDynamicSingleContainer — Used by Discussions.

• DiscussionProvider — Provides for Community look and feel changes.

• CommunityParentContainer — Instance of JSPDynamicSingleContainer for Community Sample .

• AccountPreferencesContainer — Provides for changing user preferences

Community Sample Portal Properties File Location

The CommunitySamplePortal.properties file contains the properties settings for the community sample. This file is located in /var/opt/SUNWportal/portals/portal1/desktop/classes/CommunitySamplePortal.properties. Note: changing properties requires a server restart.

---

Note –

If you change the community sample properties requires you to restart the server.

---

Static File Locations

The static content for the community sample is located in /var/opt/SUNWappserver/domains/domain1/applications/j2ee-modules/portal/community/.

• js/ — JavaScript used, including drop-down menu.

• images/desktop/*.gif — non Lockhart images.

• css/desktop.css — non Lockhart stylesheet.

• content/

  • Documentation/index.html — HTML scrapped for Documentation channel.

  • Introduction/index.html — HTML scrapped for Introduction channel.

  • Help/*.html — Community Sample help files.

  • Help/graphics/*.gif — Community Sample help file.

Comparison of Solaris and Linux Path Names

Table D–5 Comparison of Solaris and Linux Path Names

Solaris Path Name	Linux Path Name
/opt/SUNWportal (default)	/opt/sun/portal (default)
/etc/opt/SUNWportal (configuration)	/etc/opt/sun/portal (configuration)
/var/opt/SUNWportal (data)	/var/opt/sun/portal (data)