Chapter 7 Creating a New Portal

This chapter includes instructions for creating a new empty portal and deploying sample content into an empty portal.

Creating a New Portal

This sections contains the following:

To Create a New Empty Portal

Steps

Create a new web container instance.

For example, second.

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

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

Run the following commands:

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

Restart the web container.

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.

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

Steps

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

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)

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

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"/>

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

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.

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

Steps

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

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)

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

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"/>

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

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.