Sun Java System Portal Server 7 Configuration Guide

Creating a New Portal

This sections contains the following:

ProcedureTo Create a New Empty Portal

Steps
  1. Create a new web container instance.

    For example, second.

  2. Copy PortalServer7-base/SUNWportal/template/Webcontainer.properties.JESWS6 to PortalServer7-base/SUNWportal/bin/second.properites file.

  3. Edit the following properties in the PortalServer7-base/SUNWportal/bin/second.properties file.

    • Host=host.domain

    • Port=port

    • WebContainerInstanceName=second

    • WebContainerInstanceDir=/opt/SUNWwbsvr/https-second

  4. Run the following commands:

    psadmin create-portal -u amadmin -f ps_password -p Second --uri /portal -w second.properties

  5. Restart the web container.

  6. Verify that the new portal is created properly. To verify:

    • Type psadmin list-portals -u amadmin -f ps_password

    • Login to Access Manager administration console to see new portal-centric services.

    • Access the new portal via the browser.

ProcedureTo Deploy Sample Content (3 samples) on a New Portal

Steps
  1. Make a copy of the PortalServer7-base/SUNWportal/samples/portals/shared/input.properties file and edit the following properties in the file.

    • ps.config.location=/etc/opt/SUNWps

    • ps.portal.id=Second

    • ps.instance.id=host_port


      Tip –

      You can find out the exact instance-ID from the output of psadmin list-portals command.


    • ps.access.url=http://host.domain:port/portal For example, http://siroe.com:80/portal

    • ps.webapp.uri=/portal

    • ps.profiler.email=admin@siroe.com

    • ps.profiler.smtp.host=host.domain

    • search.access.url=http://host.domain:port/mySearch/search

    • search.id=search1

    • am.admin.dn=uid=amAdmin,ou=People,dc=siroe,dc=com

    • default.org.dn=dc=siroe,dc=com

  2. Make a copy of PortalServer7-base/SUNWportal/samples/portals/shared/password.properties file and edit the following properties in the file to set proper passwords.

    • amadminPassword=%AMADMIN_PASSWORD%

    • amldapuserPassword=%AMLDAPUSER_PASSWORD%

    • userManagementPassword=%USER_MANAGEMENT_PASSWORD% (optional; can be ignored if you are not setting up the comm channels)

  3. Remove the following files before running the sample content configuration ant script:

    • Directory:

      • /var/opt/sun/portal/tmp/par on Linux

      • /var/opt/SUNWportal/tmp/par on Solaris

    • Files:

      • community_sample.par

      • developer_sample.par

      • enterprise_sample.par

      • welcome_sample.par

  4. Change the order of targets in PortalServer7-base/SUNWportal/samples/portals/developer/build.xml file.

    For example, change:

    <target name="run" 
    			depends="config_am, config_portal, config_portlets, 
    			config_wsrp, par_create, par_import, config_authless, 
    			config_orgadmin, config_subscriptions, deploy"/>

    to

    <target name="run" 
    			depends="config_am, config_portal, par_create, 
    			par_import, config_authless, config_orgadmin, 
    			config_subscriptions, config_portlets, deploy, 
    			config_wsrp_dp"/>
  5. Type /usr/sfw/bin/ant -buildfile PortalServer7-base/SUNWportal/samples/portals/build.xml.

    You will be required to specify the location of the customized input.properties and password.properties file.


    Note –

    To capture the output of the sample portal content configuration, specify a log file when invoking ant. For example, type ant -buildfile PortalServer-base/SUNWps/samples/portals/build.xml -logfile /tmp/samplesinstall.txt.


ProcedureTo Deploy Sample Content (Any One Sample) on a New Portal

Steps
  1. Make a copy of the PortalServer7-base/SUNWportal/samples/portals/shared/input.properties file and edit the following properties in the file.

    • ps.config.location=/etc/opt/SUNWps

    • ps.portal.id=Second

    • ps.instance.id=host_port


      Tip –

      You can find out the exact instance-id from the output of psadmin list-portals command.


    • ps.access.url=http://host.domain:port/portal For example, http://siroe.com:80/portal

    • ps.webapp.uri=/portal

    • ps.profiler.email=admin@siroe.com

    • ps.profiler.smtp.host=host.domain

    • search.access.url=http://host.domain:port/mySearch/search

    • search.id=search1

    • am.admin.dn=uid=amAdmin,ou=People,dc=siroe,dc=com

    • default.org.dn=dc=siroe,dc=com

  2. Make a copy of PortalServer7-base/SUNWportal/samples/portals/shared/password.properties file and edit the following properties in the file to set proper passwords.

    • amadminPassword=%AMADMIN_PASSWORD%

    • amldapuserPassword=%AMLDAPUSER_PASSWORD%

    • userManagementPassword=%USER_MANAGEMENT_PASSWORD% (optional; can be ignored if you are not setting up the comm channels)

  3. Remove the following files before running the sample content configuration ant script:

    • Directory:

      • /var/opt/sun/portal/tmp/par on Linux

      • /var/opt/SUNWportal/tmp/par on Solaris

    • Files:

      • community_sample.par

      • developer_sample.par

      • enterprise_sample.par

      • welcome_sample.par

  4. Change the order of targets in PortalServer7-base/SUNWportal/samples/portals/developer/build.xml file.

    For example, change:

    <target name="run" 
    			depends="config_am, config_portal, config_portlets, 
    			config_wsrp, par_create, par_import, 
    			config_authless, config_orgadmin, 
    			config_subscriptions, deploy"/>

    to

    <target name="run" 
    			depends="config_am, config_portal, par_create, 
    			par_import, config_authless, config_orgadmin, 
    			config_subscriptions, config_portlets, 
    			deploy, config_wsrp_dp"/>
  5. Type:

    • /usr/sfw/bin/ant -buildfile PortalServer7-base/SUNWportal/samples/portals/welcome/build.xml to deploy the Welcome page content.

    • /usr/sfw/bin/ant -buildfile PortalServer7-base/SUNWportal/samples/portals/developer/build.xml to deploy the Developer Sample Portal content.

    • /usr/sfw/bin/ant -buildfile PortalServer7-base/SUNWportal/samples/portals/enterprise/build.xml to deploy the Enterprise Sample Portal content.