Solaris stand-alone: Install WebSphere Portal

WebSphere Portal is installed as a single component, complete with an integrated database for storing information. This allows you to get WebSphere Portal up and running quickly for a proof of concept phase where you can immediately begin building and working with it. You can also expand environment to include high availability failover, a more robust database, and LDAP-based authentication.

To install WebSphere Portal:

  1. Installation methods, options, and sources

  2. WebSphere Portal detailed system requirements

  3. Verify the fully qualified host name is configured...

      ping myserver.myco.com

  4. Type ping localhost on a command line to verify that network is properly configured.

  5. If you are installing with an existing WAS instance, ensure it is installed at the supported level and has the following features installed:

    • Application Server
    • Administration

      • Scripted Administration
      • Administrative Console

    • Ant and Deployment Tools

      • Deploy Tool

      • Ant Utilities

    WAS installations that have an existing WebSphere Portal v7.0 profile or that do not meet the correct software versions will not be included in the list of available, existing WAS instances.

    Besides ensuring that the existing WAS instance is at the supported level, verify that Apache Derby is installed at the supported level before installing WebSphere Portal. See WebSphere Portal detailed system requirements for supported levels.

  6. Optional. If you want to install WebSphere Portal using a non-root user:

    Although it is possible to install WAS as a non-root user, there are limitations to this option that can affect WebSphere Portal functionality, which is why you should install WAS as a root user.

    1. Install the current supported version of WAS as a root user.

    2. Create a non-root user and change ownership:

      1. Use the appropriate system commands to create a new group, to create a new user, and to add the new user to the new group.

      2. Run the following tasks to change the rights of the non-root user: 

          chmod -R g+rwx /opt/IBM
chgrp -R group_name /opt/IBM
chmod -R g+wr /tmp
chgrp -R group_name /tmp
chmod -R g+wr /var/tmp
chgrp -R group_name /var/tmp

      3. If you are also installing WAS as a non-root user, choose one of the following additional tasks based on the type of OS that you have:

        OS Additional task
        32-bit OS 

          chmod -R g+rwx /OS_code-Setup
chgrp -R group_name /OS_code-Setup

        64-bit OS 

          chmod -R g+rwx /OS_code-Setup
chgrp -R group_name /OS_code-Setup

        Enter the appropriate OS code letter, based on whether you have a 32-bit or 64-bit OS, where you see OS_code in the additional task:

        • AIX(32-bit and 64-bit) = A

        • Intel Linux™ (32-bit and 64-bit) = IL

        • PowerPC Linux (32-bit and 64-bit) = PL

        • zLinux (64-bit) = ZL

        • Solaris (32-bit and 64-bit) = SS

        • Solaris (64-bit) = SO

    3. Launch the installation program per the next step. During the installation, select the existing WAS using the non-root user and set the installation location to a unique location under the path where non-root permissions were granted.

  7. Choose one of the following installation commands:

    When defining installation path, the ONLY supported characters are ASCII letters [A-Z and a-z], numbers [0-9], slashes [/ or /, depending on OS], and the dash [-].
    Advance installation parameters: To customize installation, you can add various parameters to installation commands; for example, you can specify port information. See "Advanced installation parameters" under Related references at the end of this document for information.

    Type Task
    GUI ./install.sh
    Console mode ./install.sh -console
    Silent install ./install.sh -options "/path/to/installresponse.txt"

    Do not place the response file in a path that contains a space and do not put a space in the file name.

    If you have a Solaris 9 on Sun SPARC, the WebSphere Portal installation program automatically installs in 32-bit mode. If the installation program does not detect a WAS instance that you know exists, exit the installation program and pass the WAS instance location using the command line; for example...

      ./install.sh -W was.undetectedWas="/my/WAS/location"
    If the GUI or console mode installation program fails to detect ports for either WAS or WebSphere Portal, a warning message displays and the installer offers another chance to enter the values. If the silent installation fails to detect ports for either WAS or WebSphere Portal, the installer will exit.

  8. To verify success go to...

      http://myserver:port/wps/portal

  9. Generate the server1_PortMatrix.txt and WebSphere_Portal_PortMatrix.txt files:

      Files are created in WP_profile/ConfigEngine/log/ and list the WAS (server1) and WebSphere Portal (WebSphere_Portal) ports for installation.

      • ./ConfigEngine.sh list-server-ports -DWasPassword=foo

      • ./ConfigEngine.sh list-server-ports-by-name -DServerName=server1 -DWasPassword=foo

      • ./ConfigEngine.sh list-server-ports-by-name -DServerName=WebSphere_Portal -DWasPassword=foo

  10. To enable the sample IBM Web Content Manager content, such as internet and intranet sample sites...

        cd WP_PROFILE/ConfigEngine


      ./ConfigEngine.sh configure-express -DPortalAdminPwd=foo -DWasPassword=foo

    Run configure-express before configuring database, user registry, context root, security, etc. If you ran any tasks other than the install task, do not run this task.

    The sample content includes:

    • Creates a group called contentAuthors; members of this group are given privileges to create content in the sample Internet and intranet sites. Navigate to the Administration area and then click Access -> Users and Groups.

    • Creates two new Web Content Manager Libraries: "Internet Web Content 7.0.0" and "Intranet Web Content 7.0.0". Navigate to the Administration area and then click Portal Content -> Web Content Libraries.

    • Adds a portlet filter and applies the filter to various portlets in the sample Internet and intranet sites. You can see the definition of the filter in the WAS Administration console and examining the custom resources under the Environment area.

    • Creates two new theme policies: InternetStyle and IntranetStyle. These styles are applied to sample Internet and intranet sites. Navigate to Theme Customizer and then select the style.

    • Creates several portlet clones of the Web Content Manager rendering portlet. These portlet clones are used on sample Internet and intranet sites.

    • Creates two virtual portals with context roots of wps/portal/intranet and wps/portal/internet. These are the sample Internet and intranet sites. Go to http://myserver:port/wps/portal/internet and http://myserver:port/wps/portal/intranet to access them.

    • Creates several sample credential slots, including "Default slot for E-mail", "Default slot for Feeds", "Default slot for Miscellaneous", "Default slot for Web Clipping", and "Default slot for Web Content Management". Navigate to the Administration area and then click Access -> Credential Vault -> Manage System Vault Slots.

  11. Optional. If you ran the configure-express task, the owner of the items in the Web content libraries containing the Internet and Intranet Site Template content will be listed as...

      uid=xyzadmin,o=defaultWIMFileBasedRealm

    To update the owner information for these items to correspond to the portal administrator ID...

    1. Edit...

        WP_PROFILE/PortalServer/wcm/shared/app/config/wcmservices/MemberFixerModule.properties

    2. Add the following lines to the file: 

        uid=xyzadmin,o=defaultWIMFileBasedRealm -> portal_admin_DN
cn=contentauthors,o=defaultWIMFileBasedRealm -> content_authors_group_DN

        • Ensure the portal administrator you specify for portal_admin_DN is a member of the group you specify for content_authors_group_DN, otherwise the portal administrator cannot access the Web content libraries for the Intranet and Internet Site Templates.

        • If you plan to run the express-memberfixer task in an environment with multiple realms, if it exists, remove group...

            cn=contentauthors,o=defaultWIMFileBasedRealm

          If this group exists in an environment with multiple realms, the Member Fixer task does not have any effect.

    3. Save changes and close the file.

    4. Run...

        ./ConfigEngine.sh express-memberfixer -DPortalAdminPwd=foo

  12. Optional. If you need to change the ports for WAS or WebSphere Portal:

      The starting port parameter is required for a successful completion of the modify-ports-by-startport task. Once you specify a start port, this port becomes the base for assigning port values. The code increments this value as each port is assigned, which means that the WebSphere Portal ports will be assigned incrementally starting with the port defined with the modify-ports-by-startport task.

      1. Stop the server1 and WebSphere_Portal servers.

      2. Run one of the following commands for each server you need to change:

        Commands to change port numbers using the starting port number

        Method Task
        Start port number ./ConfigEngine.sh modify-ports-by-startport -DWasPassword=foo -DModifyPortsServer=servername -DStartPort=starting port number
        Port file Sample port files are available on the Setup disc. ./ConfigEngine.sh modify-ports-by-portsfile -DWasPassword=foo -DModifyPortsServer=servername -DPortsFile=full path to ports file

        The following is an example of the information within a port file although the port values will be different based on environment: 

          BOOTSTRAP_ADDRESS=10035
SOAP_CONNECTOR_ADDRESS=10025
ORB_LISTENER_ADDRESS=10034 
SAS_SSL_SERVERAUTH_LISTENER_ADDRESS=10041
CSIV2_SSL_SERVERAUTH_LISTENER_ADDRESS=10036
CSIV2_SSL_MUTUALAUTH_LISTENER_ADDRESS=10033
WC_adminhost=10042
WC_defaulthost=10039
DCS_UNICAST_ADDRESS=10030
WC_adminhost_secure=10032
WC_defaulthost_secure=10029
SIP_DEFAULTHOST=10027
SIP_DEFAULTHOST_SECURE=10026
IPC_CONNECTOR_ADDRESS=10037
SIB_ENDPOINT_ADDRESS=10028
SIB_ENDPOINT_SECURE_ADDRESS=10038
SIB_MQ_ENDPOINT_ADDRESS=10040
SIB_MQ_ENDPOINT_SECURE_ADDRESS=10031

  13. Restart the server1 and WebSphere_Portal servers.

  • To prevent Out of Memory errors, perform the following steps to set the MaxPermSize:

      If Maximum Heap Size is set to 2048 M or higher, set the MaxPermSize to a quarter of the value entered for the Maximum Heap Size; for example, if Maximum Heap Size is 3000 M, set MaxPermSize to 750 M. If Maximum Heap Size is less than 2048 M, set MaxPermSize to 512 M.

      1. Log in to the WAS Administration Console.

      2. Click Servers -> Server Types -> WebSphere application servers -> WebSphere_Portal.

      3. Under Server Infrastructure, click Java and Process Management -> Process Definitions -> Additional Properties -> Java Virtual Machine.

      4. In the Generic JVM arguments field, change the MaxPermSize value to -XX:MaxPermSize=numeric value, where numeric value is a quarter of the value entered for the Maximum Heap Size.

        If MaxPermSize does not exist in the Generic JVM arguments field, add it to the field but do not replace existing information in the Generic JVM arguments field with the MaxPermSize information.

  • Click OK to save changes.

  • Click Save to save changes to the master configuration.

  • Log out of the WAS Administration Console.

  • Restart the server1 and WebSphere_Portal servers.

    You can create additional WebSphere Portal profiles immediately after installation and then configure each profile individually or you can continue to configure WebSphere Portal environment and then create multiple profiles so that each profile has the same configuration.


    Parent

    Set up a stand-alone server on Solaris


    Previous

    Prepare the Solaris OS


    Next topic

    Configure WebSphere Portal to use a database
    Data collection and symptom analysis
    Use the web content member fixer task


    Related tasks


    Create multiple profiles on Solaris
    Advanced installation parameters


    Explore the sample site templates

     


    +

    Search Tips   |   Advanced Search