Contained Within
Find More Documentation
Featured Support Resources
| Scarica il manuale in formato PDF (531 KB)
Chapter 2 Installing the Sun Java System Portal Server 7 Software
This chapter provides installation information and instructions for the Portal
Server software.
Installing the Portal Server Software
This section contains the following procedures:
To Install the Portal Server Software
Before You Begin
Tip –
Some post-install configuration tasks require you to use values that you
entered during the install. Keep these values available for future use.
-
Unzip the download bits and go to the OS-arch directory,
where OS-arch can be Solaris_sparc,
or Solaris_x86, or Linux_x86.
-
Type ./installer to invoke the wizard to install
the software.
-
Select Next (at the Welcome Screen), and Accept License.
-
Select the language support you want to install and the components you
wish to install on this system.
To install Portal Server software, select Sun Java System Portal Server 7.
-
Specify the installation directory for the following software.
Note –
Access Manager must be installed in Legacy Mode.
- Directory Preparation Tool
-
By default, this is installed in /opt/SUNWcomds
- Access Manager
-
By default, this is installed in /opt
- Web Server
-
By default, this is installed in /opt/SUNWwbsvr
- Portal Server
-
By default, this is installed in /opt
Portal Server Secure Remote Access core cannot be installed on the same machine
as Portal Server in different sessions. If Portal Server is selected without Secure
Remote Access, a warning is displayed saying that Secure Remote Access core cannot
be installed or configured in the second session.
-
Specify whether or not you wish to configure now.
The installer
only supports adding one portal and one instance; for any other configuration, the
configure later option must be selected. If the configure now option is selected,
after the packages are installed, the configuration is immediately started; otherwise,
the configuration can be done by selecting the configure later option. See Chapter 5, Configuring After the Installation for more
information.
If you selected configure now option, proceed to the next
step; otherwise, skip to step 24.
-
Specify the following common server settings:
- Host Name, DNS Domain Name, Host IP Address
-
Host name, domain, and IP address of the system.
- Administrator User ID and Password
-
User ID and password of the top-level administrator (typically amadmin).
- System User and Group
-
System user name and group ID.
Values you enter here appear as default values during the rest of the installation.
-
Specify the web container settings for administration and default web
container Instance.
For more information about configuring Web Server,
see the Web Server Configuration Information in Sun Java Enterprise System 2005Q4 Installation Reference.
For more information
about configuring Application Server, see the Sun Java Enterprise System 2005Q4 Installation Reference
-
Specify the Directory Server administration settings, server settings, configuration
information, data storage location, populate data information.
For more
information, see the Directory Server Configuration Information in Sun Java Enterprise System 2005Q4 Installation Reference.
-
Specify the Access Manager administration information, web container information,
services information, directory server information, and provisioned directory information.
For more information, see the Access Manager Configuration Information in Sun Java Enterprise System 2005Q4 Installation Reference.
-
Select a web container for Portal Server software.
You can
select one of the following:
-
Specify the information for you web container information.
Your selection in Step 8 affects the information you provide. For:
-
Specify the following to deploy in to the web container:
- Portal Access URL
-
By default, this is protocol://hostname.domain:port/portal.
Note –
The Portal Access URL and the Deployement URI must be the same. For example,
if the Portal Access URL is protocol://hostname.doman:port/portal, the Deployment URI must be /portal
- Portal ID
-
By default, this is portal1.
- Search ID
-
By default, this is search1.
- Deployment URI
-
By default, this is /portal.
-
Specify whether or not you wish to configure all sample portals.
You can select one or more sample portals to configure.
-
To install Secure Remote Access also, specify the following; otherwise, skip to step 24.
- Protocol
-
The protocol can be HTTP or HTTPS.
- Host and Port
-
By default, host is the hostname.domain and port is 80.
- Deployment URI
-
By default, /portal.
-
Specify the following information to install the Gateway:
- Gateway Protocol
-
Specifies the protocol by which the gateway communicates. By default,
this is HTTPS.
- Portal Server Domain
-
Specifies the domain in which the Portal Server is installed. By default,
this is the domain name of the system.
- Gateway Domain and Port
-
Specifies the domain in which the gateway is installed and the port
used by the gateway. By default, the domain is the default domain of the system and
port is 443.
- Gateway Profile Name
-
Specifies the profile name of the gateway. By default, this is default.
- Log User Password
-
Specifies the password for the log user. Log user password
- Host Name, Subdomain, and Domain
-
Specifies the host name subdomain and domain name for the gateway.
By default, this is the host name, sub domain, and domain of the system on which you
are installing the Gateway.
- Host IP Address and Access Port
-
Specifies the host IP address and access port for the gateway. By
default, this is the IP address of the system on which you are installing the Gateway
and the port is, by default, 443.
- Gateway Profile Name and Log User Password
-
Specifies the gateway profile name and log user password. By default,
the gateway profile name is default.
-
Specify whether or not you wish to start Gateway after installation.
-
Specify the following information for the Netlet Proxy.
- Host Name, Subdomain, and Domain
-
Specifies the name, subdomain, and domain name of the machine on which
the Netlet proxy resides. By default, the system values are used.
- Host IP Address and Access Port
-
Specifies the host IP address and access port of the machine on which
the Netlet Proxy resides. By default, the IP address is the IP address of the system
and port is 10555
- Gateway Profile Name and Log User Password
-
Specifies the gateway profile name and log user password that the
Netlet Proxy uses. By default, the gateway profile name is default.
-
Specify whether or not you wish to start Netlet Proxy after installation.
-
Specify the following information to install the Rewriter Proxy.
- Host Name, Subdomain, and Domain
-
Specifies the host name, subdomain, and domain name of the machine
on which the Rewriter Proxy resides. By default, the system values are used.
- Host IP Address and Access Port
-
Specifies the Host IP address and access port of the machine on which
the Rewriter Proxy resides. By default, the IP address is the IP address of the system
and port is 10443.
- Gateway Profile Name and Log User Password
-
Specifies the gateway profile name and log user password that Rewriter
Proxy uses. By default, the gateway profile name is default.
-
Specify whether or not you wish to start Rewriter Proxy after installation.
-
Specify the following proxy information for the Secure Remote Access software.
Note –
Based on whether or not you wish to work with Portal Server software on
another host, the ability to edit this page varies. If the proxy server being installed
are to work with an instance of Portal Server installed on a different host, select
the option to Work with Portal Server on another host, and specify the following information.
- Portal Server Protocol, Host, Port, and Deployment URI
-
By default, host is the hostname.domain of the system where Portal Server is installed, port
is 81, and URI is /portal.
- Organization DN
-
Organization distinguished node.
- Access Manager Service URI and Encryption Key
-
By default, the URI is /amserver.
-
Specify the following certificate information for the Secure Remote Access software:
- Organization, Division, City/Locality, State/Province
-
Specify your organization name, division, city, and state information.
- Country Code
-
Use the two character format.
- Certificate Database Password
-
The certificate database password must be at least eight characters.
-
Specify whether or not you are ready to install by selecting
the Next.
-
Specify whether or not you wish to open the registration window during
installation and select Install to install the software.
To Install on a Second Machine
The GUI installer cannot be used for multi portal installation. Follow the instructions
in this section to install Portal Server on a second machine.
-
Install Access Manager SDK and web container first.
-
Start the web container and then invoke the Portal Server software GUI
installer to install the software in configure later mode.
-
Copy the /etc/opt/SUNWcacao/security directory from
the machine where the first portal resides to the second machine.
-
Restart the CACAO server on the second machine.
For Solaris,
use the command /opt/SUNWcacao/bin/cacaoadm restart.
for Linux, use the command /opt/sun/cacao/bin/cacaoadm restart.
-
Complete the Portal Server installation by running the psconfig --config example-config-xml-file command.
The psconfig utility is located in PortalServer7–base/bin. By default, PortalServer7–base is /opt/SUNWportal.
The example files
are located in the following directories:
For Solaris:PortalServer7-base/samples/psconfig
For Linux: PortalServer7-base/samples/psconfig. By default, PortalServer7–base for Linux is /opt/portal.
-
Edit the configuration xml example files to specify the configuration
details.
For more details on constructing a config xml file, see Constructing a Configuration XML File.
To Verify the Installation
Verify the Portal Server software installation by:
-
Type protocol://fully-qualified-hostname:port/portal-URI in
the browser.
When you type the URL, the welcome page, a short description
of Portal server and links to sample portals that you selected for installation is
displayed. Click on one of the links and access the anonymous portal desktop for the
sample portal. If the sample Portal desktop displays without any exception, then your
Portal Server installation was successful.
-
Type protocol://fully-qualified-hostname:port/psconsole in the browser.
-
Run the following command to check if the gateway is running on the specified
port (the default port is 443):
netstat -an | grep port-number
If the gateway is not running, use the following command to
start the gateway:
PortalServer7-base/bin/psadmin
start-sra-instance -u amadmin -f amadmin-password-file --instance-type gateway --instance-name GatewayInstanceName
By default the PortalServer7–base is /opt/SUNWportal
Note –
Create a file and add amadmin password in plaint text
and pass it as an input to the -f option above.
Also view the log files. The log file name is picked up from the property called
debug.com.sun.portal.handler.java.util.logging.FileHandler.pattern in
the platform.conf file.
-
Run the Portal Server in secure mode by typing the gateway URL in your
browser:
https://gateway-machine-name:portnumber
If you have chosen the default port (443) during installation, you need not specify
the port number.
|