To Install Sun Java System Portal Server 7.1
From the installation location, go to the OS-arch directory, where OS-arch can be Solaris_sparc, Solaris_x86, or Linux_x86.
Run ./installer to invoke the wizard to install the software.
In the Welcome screen, click Next.
In the Software License Agreement screen, read the agreement and click Yes, Accept License.
The Choose Software Components screen appears. Select Portal Server 7.1.
When this option this selected, the following components are selected by default:
Select the other software components that you want to install.
To install Secure Remote Access (SRA) services, select Portal Server Secure Remote Access 7.1. When you select this option, the Gateway, Netlet Proxy, and the Rewriter Proxy are selected by default.
To install Application Server, select Application Server Enterprise Edition 8.2 . When you select this option, the Domain Administration Server, Command Line Administration Tool, and Sample Applications for the Application Server are selected by default. The Application Server High Availability Session Store 4.4 and Sun Java System Message Queue 3.7 UR1 are also selected by default.
Note –Select this option if you need EJB container for portal.
To install Web Server, select the Sun Java System Web Server 7.0. When you select this option, the Web Server CLI, Web Server Core, and Web Server Samples are selected by default.
Note –Select this option if you require only Web Applications.
To install multilingual support for the selected Java ES components, select Install Multilingual Packages for Selected Component(s).
Note –If J2SE-SDK or any shared components require upgrade, the installer displays the corresponding screens. By default, installer upgrade them with the latest version in the installer disk.
The Shared Component Upgrades Requires screen is displayed if any one of the shared components requires upgrading. Click Next to upgrade these shared components.
On the Specify Installation Directories page, specify the installation directory for the software. The following are the default locations. Use the Browse button to change the default location. Click Next.
- Access Manager
/opt
- Application Server
/opt/SUNWappserver
- Application Server: Data and Configuration
/var/opt/SUNWappserver
- Directory Server
/opt/SUNWdsee
- Directory Preparation Tool
/opt/SUNWcomds
- Web Server
/opt
- Web Server Instance
/var/opt/SUNWwbsvr7
- Service Registry
/opt
- Portal Server
/opt
The Verify System Requirements screen is displayed. The installer verifies each of the listed system requirements and displays OK if the requirements are met. If the installer indicates that all the requirements are met, the System Ready for Installation message appears. Click Next to continue with the installation. In case any of the requirements are not met, a text indicating the same appears with the following options: View Reports and Check Again. The View Report option provides the details about the requirements that are not met. It is recommended that you address these issues. After the requirements are met, click the Check Again option to verify whether the requirements are met.
Click Next to continue the installation.
The Choose a Configuration Type screen is displayed.
Select Configure Now, and click Next.
The installer only supports adding one portal and one instance only. 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 starts immediately.
Select Configure Now, and click Next.
The Custom Configuration screen is displayed.
Service Registry 3.1 and Java DB are not configured during the installation. It can be configured after the installation. Click Next.
The Specify Administrator Account Preferences screen is displayed.
Enter the Administrator ID and password. Type the password, and click Next.
You are also provided with an option to select different administrator accounts for each product.
The Specify Common Server Settings screen is displayed.
Specify the following server settings:
- Host Name, DNS Domain Name, and Host IP Address
Host name, domain, and IP address of the system. The installer automatically displays these values.
- System User and Group
System user name and group ID. For Solaris 10 OS and Linux, the default is root for system user name and root for group ID. For Solaris 9 OS, the default is root for system user name and other for group ID.
Note –Values you enter here appear as default values during the rest of the installation.
If you have selected Web Server as a component to install, the Choose Configuration Type screen is displayed. You have an option to configure administration instance as a server or as a node. By default, configure administration instance as server is selected. Click Next.
If you have selected Web Server as a component to install, the Web Server: Specify Administration Server Settings and Web Server: Specify Instance Settings screens are displayed. Provide the information for Web Server, and click Next.
Note –Specify the Runtime Unix user ID as root.
You need to specify the following details for the Web Server: Specify Administration Server Settings screen:
- Server Host
The default value is automatically created by joining the values that you provided for Host Name and DNS Domain Name under Common Server Settings. The value has the format hostname.domainname.
- SSL Port
The default value is 8989.
- HTTP Port
Port on which Web Server listens for HTTP connections. The default is 8800.
- Runtime User ID
User ID that the default instance of Web Server uses to run on the system. The default is root.
You need to specify the following details for the Web Server: Specify Instance Settings screen:
- Server Name
A host and domain value that resolves to the local host. The value has the format hostname.domainname.
- HTTP Port
Port on which Web Server listens for HTTP connections. The default value is 80.
- Runtime UNIX User ID
An existing non-root user. If you are installing Access Manager or Portal Server, set this value to root and set the Runtime Group to other. You can change these values after installation. For other servers, the Runtime User ID should be a non-root user. The default value is webservd.
- Document Root Directory
Location where Web Server stores content documents. For Solaris OS, the default value is /var/opt/SUNWwbsvr7/docs. For Linux and HP-UX, the default value is /var/opt/sun/webserver7/docs.
The High Availability Session Store (HADB): Specify Configuration Data screen is displayed. The Installer displays the default values. This screen is displayed only if you have selected Application Server as a component to install. Click Next.
- HADB Management Port
Port on which the HADB management listens. The default value is 1862.
- HADB Resource Directory
Location where HADB stores resource contents. The default value is /var/opt.
- HADB Administrator Group
The UNIX group (GID) in which the default instance of HADB runs as a user. The default value is other.
- Automatically start HADB when system starts
Choose this option to direct the installer to configure HADB to start automatically when the system restarts. By default, this is selected.
- Allow Group Management
Choose this option when you want HADB to be managed by the HADB Administration Group. If this parameter is set to yes, all members belonging to the group (HADB_DEFAULT_GROUP) can run and manage HADB. By default, it is set to No.
The Application Server: Domain Administration Server screen is displayed.
Provide or change values in the installer pages as needed and click Next.
The installer displays the default values. This screen is displayed only if you have selected Application Server as a component to install.
- Admin Port
Port on which Application Servers administrative server listens for connections. By default, it is 4849.
- JMX Port
The default is 8686.
- HTTP Port
The default value is 8080. If the installer detects that the default port is used, an alternative value is suggested.
- HTTPS Port
The default is 8181.
- Master Password
SSL certificate database password, used for asadmin operations such as Domain Administration Server startup and Node Agent startup. The default value is the Administrator Password you provided under Common Server Settings.
The Application Server: Node Agent screen is displayed.
Specify the details and click Next.
This screen displays only if you have selected Application Server as a component to install.
- Admin Host Name
Host name for administration server which the node agent can connect to.
- Admin User Name
User ID of the Application Server admin user. The default value is the Administrator User ID you provided under Common Server Settings.
If you chose to use a single administrator account, this field is not present.
- Password
Password for the Application Server admin user. There is no default value.
If you chose to use a single administrator account, this field is not present.
- Master Password
SSL certificate database password, used for asadmin operations such as Domain Administration Server startup and Node Agent startup. There is no default value.
- Admin Port
Port on which Application Servers node agent listens for connections. Provides access to the administration tools. The default value is 4849.
- Node Agent Name
Name of the local node. The default value is the local host name
The Application Server: Configure Load Balancing Plugin screen is displayed.
Specify the details and click Next.
This screen displays only if you have selected Application Server as a component to install.
- Web server that the load balancing plugin will use
You can select either Sun Java System Web Server or Apache Web Server. HP-UX does not support Apache Web Server.
- Web server installation directory
Installation directory for Web Server or Apache HTTP Server.
The default value is:
Solaris OS: /opt/SUNWwbsvr7
Linux and HP-UX: /opt/sun/webserver7
- Web Server instance directory
Installation directory for Web Server or Apache HTTP Server.
The default value is:
Solaris OS: /var/opt/SUNWwbsvr7
Linux and HP-UX: /var/opt/sun/webserver7
The Directory Server: Specify Instance Creation Information screen is displayed.
Specify the information for Directory Server instance creation and click Next.
- Instance Directory
Location of new instance.
- Directory Instance Port
The default value is 389.
- Directory Instance SSL Port
The default value is 636.
- Directory Manager DN
Distinguished Name (DN) of the user who has unrestricted access to Directory Server. The default value is cn=Directory Manager.
- System User
The default value is root.
- System Group
The default value is root.
- Directory Manager Password
Password for the directory manager.
- Suffix
Initial directory suffix managed by this instance. The default value is formed by the segments of the fully qualified domain name for the current host. For example, if you install on siroe.sub1.example.com, the default value is dc=sub1,dc=example,dc=com.
For more information, see Directory Server Configuration Information in Sun Java Enterprise System 5 Installation Reference for UNIX.
The Access Manager: Specify Configuration Information screen is displayed.
Specify the information for the Access Manager configuration and click Next.
- Install type
Indicates the level of interoperability with other components. You have a choice of Realm mode (version 7 style) or Legacy mode (version 6 style). Default option is Legacy mode. You must use Legacy mode if you are installing Access Manager with Portal Server, Messaging Server, Calendar Server, Delegated Administrator, or Instant Messaging. The default value for Legacy mode is Enabled. The default for Realm mode is Disabled.
Note –Portal Server supports Realm mode only if Sun Java System Directory Server is used as a user repository and Access Manager SDK is configured as the datastore plugin for the Realm mode. If you select the Configure Now option for the Realm mode, the installer does this by default.
- Administrator User ID
Access Manager's top-level administrator. This user has unlimited access to all entries managed by Access Manager. The default name, amadmin, cannot be changed. This ensures that the Access Manager administrator role and its privileges are created and mapped properly in Directory Server, allowing you to log into Access Manager immediately after installation.
- Administrator Password
Password of the amadmin user. The value must have at least eight characters.
- LDAP User ID
Bind DN user for LDAP, Membership, and Policy services. This user has read and search access to all Directory Server entries. The default user name, amldapuser, cannot be changed.
- LDAP Password
Password of the amldapuser user. This password must be different from the password of the amadmin user. It can be any valid Directory Service password.
- Password Encryption Key
A string that Access Manager uses to encrypt user passwords. For security purposes, it is recommended that the password encryption key be 12 characters or longer.
Note –amAdmin and amldapuser password should be different.
For more information, see the Access Manager Configuration Information in Sun Java Enterprise System 5 Installation Reference for UNIX.
Note –Portal Server supports installing Access Manager in the Realm mode or in the Legacy mode.
The Access Manager: Choose Deployment Container screen is displayed.
You can select either Sun Java System Web Server or Sun Java System Application Server. Select the option, and click Next.
For more information about configuring Web Server, see the Web Server Configuration Information in Sun Java Enterprise System 5 Installation Reference for UNIX in Sun Java Enterprise System 5 Installation Reference for UNIX.
For more information about configuring Application Server, see the Sun Java Enterprise System 5 Installation Reference for UNIX
The Access Manager: Specify Sun Java System Application Server screen is displayed.
Specify the details and click Next.
This screen is displayed only if you have selected Sun Java System Application Server as the web container for Access Manager.
- Secure Server Instance Port
Specify whether the value for Instance Port refers to a secure port. A secure port uses the HTTPS protocol. A non-secure port uses HTTP.
- Secure Administration Server Port
Specify whether the value for Administrator Port is a secure port. A secure port uses the HTTPS protocol. A non-secure port uses HTTP.
The Access Manager: Specify Web Container for Running Access Manager Services screen is displayed.
Specify the details for Access Manager and click Next.
- Host Name
Fully qualified domain name of the host on which you are installing.
- Services Deployment URI
Uniform Resource Identifier (URI) prefix for accessing the HTML pages, classes, and Java Archive (JAR) files associated with the Identity Management and Policy Services Core subcomponent. The default value is amserver. Do not enter a leading slash.
- Common Domain Deployment URI
URI prefix for accessing the common domain services on the web container. The default value is amcommon. Do not enter a leading slash.
- Cookie Domain
The names of the trusted DNS domains that Access Manager returns to a browser when Access Manager grants a session ID to a user. A leading dot (.) is required for each domain in the list. The default value is the current domain, prefixed by a dot (.).
- Password Deployment URI
URI that determines the mapping that the web container running Access Manager will use between a string you specify and a corresponding deployed application. The default value is ampassword. Do not enter a leading slash.
- Console Protocol
Specify whether the console uses a secure or unsecure port. A secure port uses the HTTPS protocol. A non-secure port uses HTTP. The default is HTTP.
The Access Manager: Choose Access Manager Console screen is displayed.
Note –This screen is displayed only if you select the Legacy mode to install Access Manager.
By default, Deploy New Console is selected. Click Next.
- Administration Console
Choose Deploy new console to deploy the console into the web container of the host on which Access Manager is being installed. Choose Use existing console to use an existing console that is deployed on a remote host.
- Console Deployment URI
URI prefix for accessing the HTML pages, classes, and JAR files associated with the Access Manager Administration Console subcomponent.The default value is amconsole.
- Console Host Name
Fully qualified domain name for the server hosting the existing console. This value is not needed if you are deploying a new console. You can edit the field only if you are using an existing console.
- Console Port
Port on which the existing console listens for connections. Permitted values are any valid and unused port number, in the range 0 (zero) through 65535.
The Access Manager: Choose Directory Server Instance screen is displayed.
Use the Directory Server Instance that you just created. Click Next.
Note –If you choose to use an existing instance instead of the default, the alternate instance must already be configured.
The Access Manager: Specify Directory Server Data screen is displayed.
You can select Yes or No for the option: Is Directory Server is Provisioned with User Data. By default, No is selected. If you select Yes, you need to provide the related information. Click Next.
If you have selected Application Server as the deployment container for Access Manager, the Specify Sun Java System Application Server Information screen is displayed. Click Next.
- Secure Server Instance Port
This protocol specifies whether the value for Server Instance port refers to a secure port. A secure port uses the HTTPS protocol. A non-secure port uses HTTP.
The Portal Server: Specify Web Container Deployment Information screen is displayed.
Specify the Web Container deployment information and click Next.
- Portal Access URL
The default is host name:port/portal1.
- Portal ID
The default is portal1.
- Search ID
The default is search1.
- Deployment URI
The default is /portal.
- Portal Instance ID
The default is hostname-8080.
Select the Enable Secure Remote Access option, if you wish to enable Secure Remote Access. Select Developer Sample, Enterprise Sample, and Community Sample if you wish to configure samples.
The Portal Server: Secure Remote Access screen is displayed. The Portal Server: Secure Remote Access: Configure Gateway screen is displayed.
Enter the following information and click Next.
- Gateway Protocol
It is https by default.
- Portal Server Domain Name
Portal Server domain name.
- Gateway Domain
Gateway domain.
- Gateway Port
It is 443 by default.
- Gateway Profile Name
It is default by default.
- Log User Password
The user password
Specify the details and click Next.
- Protocol
Protocol (HTTP or HTTPS) the gateway uses to communicate. In most cases the gateway should use HTTPS.
- Host Name, Subdomain, and Domain
The name, subdomain, and domain name of the machine on which the Gateway proxy resides. By default, the system values are used.
- Host IP Address and Access Port
The host IP address on which the Gateway Proxy resides. By default, the IP address is the IP address of the system and port is 443.
- Gateway Profile Name
The gateway profile name. By default, the gateway profile name is default.
The Portal Server: Secure Remote Access: Configure Netlet Proxy screen is displayed.
Specify the following information for the Netlet Proxy.
- Host Name, Subdomain, and Domain
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
The host IP address 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
The gateway profile name. By default, the gateway profile name is default.
Click Next.
The Portal Server: Secure Remote Access: Configure Rewriter Proxy screen is displayed.
Specify the following information to install the Rewriter Proxy.
- Host Name, Subdomain, and Domain
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
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
The gateway profile name. By default, the gateway profile name is default.
Click Next.
The Portal Server: Secure Remote Access: Specify Certificate Information screen is displayed.
Specify the following certificate information for the Secure Remote Access.
- Organization, Division, City/Locality, State/Province
The organization name, division, city, and state information.
- Country Code
The country code in two character format.
- Certificate Database Password
The certificate database password must be at least eight characters.
Click Next.
The Ready to Install screen is displayed. Specify whether you are ready to install by clicking Install.
Verifying the Portal Server 7.1 Installation
Verify the Portal Server installation by doing the following:
Accessing the samples.
Accessing the Portal Server administration console.
Verifying the Gateway port and running the Portal Server in secure mode.
To Verify Sun Java System Portal Server 7.1 Installation
Start Directory Server, web container, and gateway.
Access Portal Server. For example, type the URL in the browser.
http://host.domain-name:port/portal-URI
The welcome page appears. The page displays a short description of Portal server and links to sample portals that you selected for installation. Click on one of the links and access the anonymous portal desktop for the sample portal. If the sample portal desktop displays without exception, your Portal Server installation was successful.
Type http://host.domain-name:port/psconsole.
Verify whether Java DB process is running.
netsatat -an | grep 1527
If Java DB is not running, start Java DB. For more information, refer to To Start and Stop Java DB
Check whether the common agent container is running.
On the Solaris platform, type the following:
/usr/share/bin/cacaoadm status
On the Linux platform, type the following:
/opt/sun/cacao/bin/cacaoadm status
If the common agent container is not running, restart it.
On the Solaris platform, type the following:
/usr/share/bin/cacaoadm stop
/usr/share/bin/cacaoadm startOn the Linux platform, type the following:
/opt/sun/cacao/bin/cacaoadm stop
/opt/sun/cacao/bin/cacaoadm start
Note –By default, common agent container creates a self-signed CA cert and uses it to sign the server cert of the Cacao agent. The subject DN of this server cert is CN=hostname_agent (or CN=hostname_default_agent on MS Windows). When this default server cert is to be replaced by another server cert signed by the CA of the user's choice, the subject DN of the new server cert must be kept the same as the original one for Portal Server administration to continue function without interruption.
Verify whether Directory Server is running using the following commands:
netstat -an | grep 389
If it is not running, start the Directory Server using the following command:
cd /opt/SUNWdsee/ds6/bin
./dsadm start /var/opt/SUNWdsee/dsins1Verify whether the Application Server or Web Server is running using the following command:
For Web Server:
netstat -an | grep 80
For Application Server:
netstat -an | grep 8080
If it is not running, start the server using the following command:
For Application Server:
/ApplicationServer_base/Appserver/bin/asadmin
start-domain --user admin domain1For Web Server:
/var/opt/SUNWwbsvr7/https-host.domain-name/bin/startserv
Run the following command to check if the gateway is running on the specified port (the default port is 443):
netstat -an | grep 443
If the gateway is not running, do the following:
PortalServer-base/bin/psadmin provision-sra -u amadmin -f amadmin-password-file --gateway-profile gateway-profile --enable
PortalServer-base/bin/psadmin start-sra-instance -u amadmin -f amadmin-password-file --instance-type gateway --instance-name gateway-instance-name
Create a file and add the amadmin password in plaint text.
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:443
If you chose a different port number other than the default port (443) during installation, you need not specify that port number.
____________________________________________________________________
now how to uninstall portal server if any problem or issue ...
Uninstalling Portal Server
Use the following procedure to uninstall Portal Server.
To Uninstall Portal Server
As a root user, log in to the machine where you installed Portal Server.
Change directories to:
/var/sadm/prod/SUNWentsys5/ on Solaris.
/var/sadm/prod/sun-entsys5/ on Linux.
Type ./uninstall to uninstall Portal Server.
The Sun Java Enterprise System Uninstall Wizard is displayed.
Select the components to uninstall and select Next.
If you are uninstalling the Secure Remote Access component, you are asked to provide the portal administrator, Access Manager administrator, and LDAP passwords.
Select Uninstall to uninstall the software.
No comments:
Post a Comment