This section contains the requirements for installing Sun Java System Portal Server 7.2.
The installation instructions are specific to the Solaris and Linux platforms.
This section includes the following sections:
The following table lists hardware and operating system requirements:
Table 1–1 Hardware and Operating System Requirements
Component |
Platform Requirement |
---|---|
Supported platforms |
Sun BladeTM or comparable workstation or server |
Operating system |
SolarisTM 9 or Solaris 10 on SPARC® Solaris 9 or Solaris 10 on x86 Red Hat Enterprise Linux 4.0 on x86 |
RAM |
2.0 Gbytes for regular deployment on Sun Java System Application Server. |
Disk space |
1 Gbyte for Portal Server and associated applications. |
Swap space |
Twice the amount of physical memory. For example, if your machine has 2.0 Gbytes RAM, the swap space should be 4.0 Gbytes swap space. For Application Server 9.1, memory and disk space should be a minimum of 256 MB and 250 MB respectively. |
Portal Server 7.2 web-based user interfaces are supported on all web browsers that support the following standards on recent major versions:
HTML 4
Frames
CSS 2
Java 1.4
XMLHttpRequest
JavaScriptTM 1.5
DOM 1
The following features in Portal Server 7.2 are dependent on specific browser capabilities.
Proxylet — Requires specific proxy configuration manipulation functions. Supported on the most recent major versions of Internet Explorer (IE) 7 and Firefox 2.
Applets (Netlet, NetFile, and Proxylet) — Requires the most recent major versions of Java 1.4 support. Microsoft Cabinet (.cab) file formats are not supported.
AJAXTableContainerProvider — Requires the most recent major versions of HTML 4, JavaScript 1.5, and CSS 2. Supported on the most recent major versions of Firefox 2 and IE 7 web browsers.
Console — Requires the most recent major versions of CSS 2, HTML 4.0, JavaScript 1.5. Supported on the most recent major versions of Firefox 2 and IE 7 web browsers.
FCKeditor — Requires the most recent major versions of IE 7 (Windows), Firefox 2, Mozilla 1.3, and NetscapeTM 7.1.
Themes — Requires CSS 2. Supported on the most recent major versions of Firefox 2 and IE 7.
The following web browser / OS combinations are known to support the above standards and the special capabilities that are required for all Portal Server 7.2 features:
The most recent major versions of Firefox 2 on Windows 2000, XP (and later versions), Solaris 10 (SPARC and x86), and Red Hat Linux 4.0.
Remove the link /usr/share/bdb/db.jar before installation, if it exists.
Check that ant already exists on the system by running the following command:
rpm -qa | grep ant
If a version of ant below 1.6 is installed, remove it by running the following command:
rpm -e ant-older-version ant-libs-older-version
You need to use the version of ant sun-ant-1.6.5-2 to install or deploy Portal Server. When you run the installer, it is automatically installed at /opt/sun/bin/ant.
Before you begin installing Portal Server 7.2, you need to have the following requirements:
You need to have Java SETM 5 or Java SE 6 Update 5 or above pre-installed, before installing Portal Server 7.2.
The installer checks for the available Java SE version and prompts you to install the required version.
If you are using Solaris 5.9, you need to download and install the following patches from http://www.sunsolve.sun.com/, before installing Portal Server 7.2.
Patch id — 114677-05
Patch id — 114678-05
The above patches are required for Solaris 5.9 version on SPARC and x86 systems. There is no need to install these patches, if you use Solaris 10 or Red Hat Enterprise Linux.
You need an installed web container. You can use Sun Java System Application Server 9.1 as the web container for installing Portal Server 7.2. The web container must be installed and running, before you run Portal Server 7.2 installer.
You can also use GlassFishTM V2 as a web container only for evaluation purpose.
If you are using Application Server 9.1 as the web container, you can have the Application Server 9.1 installer install a JDKTM for you. For GlassFish V2 installation, you must manually install a JDK. Moreover, the installed JDK has to be package based. Otherwise, the Common Agent Container will not start.
Portal Server 7.2 requires Sun Java System Access Manager 7.1 and Sun Java System Directory Server 6. These need to be pre-installed and running. It is recommended that these components are installed from the Java ES 5 Update 1 distribution.
If you are installing Portal Server 7.2 in a multi-node environment and using Directory Server 6.2, you must first upgrade to Directory Server 6.3 before installing Portal Server 7.2. For more information, refer the Portal Server 7.2 Bugs in this Release in Sun Java System Portal Server 7.2 Release Notes.
If you are using the Java ES 5 Update 1 installer, install Access Manager 7.1 and Directory Server 6 on Application Server 9.1 in the Configure Now mode. Whereas, if you are using the Java ES 5 installer, install Access Manager 7.1 and Directory Server 6 in the Configure Later mode on Application Server 9.1.
If you are using the Java ES 5 Update 1 installer with Portal Server 7.2 on a single machine, do the following:
Install Application Server 9.1.
If you are installing Portal Server 7.2 with GlassFish V2, then you should set the Master Password to match the Administrator Password, using the command asadmin change-master-password.
Start Application Server 9.1. The command to start Application Server 9.1 is /opt/SUNWappserver/appserver/bin/asadmin start-domain --user admin domain1
Invoke the Java ES 5 Update 1 installer and install Access Manager 7.1 and Directory Server 6 in the Configure Now mode.
Ensure that you select Application Server 9.1 instance in the Access Manager web container panel and provide appropriate values.
If you are running the Java ES 5 Update 1 installer in text mode, choose Option 2 (Application Server Enterprise Edition 8.2 Patch 2). Though it is mentioned as Application Server Enterprise Edition 8.2, the Java ES 5 Update 1 installer will pick the values of Application Server 9.1 that you have installed.
Ensure that the instance directory and DocRoot values are correct. The default values are /opt/SUNWappserver/appserver/domains/domain1 and /opt/SUNWappserver/appserver/domains/domain1/docroot.
Ensure that the administration port is correct. The default value is 4848.
Start Directory Server after the installation is complete. The command to start Directory Server is /opt/SUNWdsee/ds6/bin/dsadm start /var/opt/SUNWdsee/dsins1
Stop and restart Application Server 9.1 after the Access Manager configuration is complete. The command to start Application Server 9.1 is /opt/SUNWappserver/appserver/bin/asadmin start-domain --user admin domain1
If you are using Java ES 5 installer with Portal Server 7.2 on a single machine, do the following:
Invoke the Java ES 5 installer and install Directory Server 6 in the Configure Now mode. Do not select any of the shared components. Select the run time user for Directory Server as root.
Start Directory Server.
Install Access Manager 7.1 in the Configure Later mode.
Install Application Server 9.1.
Start Application Server 9.1. The command to start Application Server 9.1 is /opt/SUNWappserver/appserver/bin/asadmin start-domain --user admin domain1
Modify the /opt/SUNWam/bin/amsamplesilent file (Access Manager silent installation file) with appropriate values. Use Application Server 9.1 as the web container property value.
Run the ./amconfig -s amsamplesilent command to configure Access Manager.
Start Application Server 9.1 after the Access Manager configuration is complete.
You can also install Sun Java System Access Manager 7.1 in realm mode with Sun Java System Directory Server 6 as datastore.
If the system on which you installed Portal Server does not have direct connectivity to the internet, an HTTP proxy needs to be specified. For example, for Application Server 9.1, specify the following in the domain.xml file:
<jvm-options>-Dhttp.proxyHost=proxy-host</jvm-options> <jvm-options>-Dhttp.proxyPort=proxy-port</jvm-options> <jvm-options>-Dhttp.nonProxyHosts="portalserver-host"</jvm-options>
Where, proxy-host is the fully qualified domain name of the proxy host, proxy-port is the port on which the proxy is run, and portalserver-host is the fully qualified domain name of the Portal Server software host.
Execute the command prtconf | grep Memory to check RAM.
For Linux, you can check the memory and swap size form the meminfo file. Use the vi /proc/meminfo command to view the meminfo file.
Use the command swap -l to see how much swap space your machine has. To temporarily increase your swap space by 4 Gbytes, you can use the following instructions:
mkfile 4g /swap-filename swap -a /swap-filename
where swap-filename is an empty file to be used as a swap area.
To increase the swap size on Linux, use the following instructions:
Create a swap file by using the mkswap /directory-name/swap-filename command.
You can create the swap file on any directory, where the disk space is available.
Mention the swap file name where you need to increase the swap size by using the swapon /directory-name/swap-filename command.
Increase the swap size by using the /directory-name/dd if=/dev/zero of=/directory-name/swap-filename bs=1024 count=x command.
where x is a variable that depends on the amount of swap you need to increase. The variable can be in the multiples of blocksize (bs), which is 1024.
Remove the swap file by using the rm —rf /directory-name/swap-filename, since the swap file consumes huge disk space.
The amconfig script and other configure later utilities, require the JDK to be installed and linked to /usr/jdk/entsys-j2se. This looks like the following:
lrwxrwxrwx 1 root root 27 Jan 17 09:28 entsys-j2se -> /usr/jdk/instances/jdk1.5.0