IBM WebSphere Portal Extend v8.5 install
These were the steps I followed to install IBM WebSphere Portal and Web Content
Manager Extend v8.5. Everything was installed on a single server.
IBM WebSphere Portal Extend v8.5 install ........................................................................ 1
1. Software ...................................................................................................................... 2
Install WebSphere Portal v8.5 ............................................................................................ 4
1.1. Install WebSphere Portal ...................................................................................... 4
2. Configure WebSphere Portal with LDAP................................................................. 22
2.1. Manual steps to map ibm-primaryEmail to mail ................................................ 26
Apply recommended updates for WebSphere Portal ........................................................ 31
3. Install WAS prerequisite updates.............................................................................. 33
4. Install Latest Portal CF (8.5 CF08) ........................................................................... 40
4.1. Run Health Check Tool prior to CF install ........................................................ 40
4.2. Install WebSphere Portal CF 08 ......................................................................... 42
5. Post install tasks ........................................................................................................ 52
1.
Software
I downloaded the following files prior to installing:
IBM WebSphere Portal Extend V8.5 Multiplatform Multilingual eAssembly (CRRY8ML)
 IBM WebSphere Portal Extend Setup V8.5 Multiplatform Multilingual
IMPORTANT: All parts of this image (Setup, Install, WAS ND, SDK) must
be extracted into the same directory to create an installable image (CIZ5TML )
 IBM WebSphere Portal Server Install V8.5 Multiplatform Multilingual
IMPORTANT: All parts of this image (Setup, Install, WAS ND, SDK) must
be extracted into the same directory to create an installable image (CIYV9ML )
 IBM WebSphere Portal Extend Install V8.5 Multiplatform Multilingual
IMPORTANT: All parts of this image (Setup, Install, WAS ND, SDK) must
be extracted into the same directory to create an installable image.
(CIZ5UML )
 IBM WebSphere Application Server Network Deployment V8.5.5.2
Multiplatform Multilingual IMPORTANT: All parts of this image (Setup,
Install, WAS ND, SDK) must be extracted into the same directory to create an
installable image (CIYW0ML )
 IBM WebSphere SDK Java Technology Edition V7.0.6.1 Multiplatform
Multilingual IMPORTANT: All parts of this image (Setup, Install, WAS ND,
SDK) must be extracted into the same directory to create an installable image
(CIYW1ML )
 IBM WebSphere Portal V8.5 Remote Search and Document Conversion
Services Multiplatform Multilingual (CIYW2ML )
Once downloaded Extract all files into the same Directory (C:\DownloadDirector\wps85
in my test env)
Recommended Updates for WebSphere Portal and IBM Web Content Manager V8.5
http://www-01.ibm.com/support/docview.wss?uid=swg24037802
At the time of this install (26 Oct 2015) The following fixes were recommended
From the Recommended Update package from Fix Central I downloaded
interim fix: 8.5-WP-WCM-Combined-CFPI45447-Server-CF08
WebSphere Application Server 8.5.5 fp7
Recommended fixes: http://www01.ibm.com/support/docview.wss?uid=swg27004980
8.5.5.7: http://www-01.ibm.com/support/docview.wss?uid=swg24040533
IBM WebSphere SDK PI50090: http://www01.ibm.com/support/docview.wss?uid=swg24041099
Install WebSphere Portal v8.5
This step involves setting up a DMGR server, 1 managed node (in this case I installed
everything on 1 system, so I installed a cell).
1.1. Install WebSphere Portal
From where you extracted the Portal files from IBM WebSphere Portal Extend V8.5
Multiplatform Multilingual eAssembly (CRRY8ML) run
C:\DownloadDirector\wps85\SETUP\setup.exe
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
16.
17.
18.
19.
2.
Configure WebSphere Portal with LDAP
If you have the WebSphere Portal First Steps open select Open Configuration Wizard,
otherwise, open a browser to http://cpportal.rtp.raleigh.ibm.com:10200/ibm/wizard
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
2.1. Manual steps to map ibm-primaryEmail to mail
12. Use a text editor to open
C:\IBM\WebSphere\wp_profile\ConfigEngine\properties\wkplc.properties file.
13. Enter a value for the following set of parameters in the wkplc.properties file to correct
any issues that are found in the configuration trace file:
The following parameters are found in the VMM Federated repository properties
heading:
federated.ldap.attributes.nonSupported
federated.ldap.attributes.nonSupported.delete
federated.ldap.attributes.mapping.ldapName
federated.ldap.attributes.mapping.portalName
federated.ldap.attributes.mapping.entityTypes
The following values flag certificate and members as unsupported attributes and maps
ibm-primaryEmail to mail and ibm-jobTitle to title for the PersonAccount
entityTypes:
NOTE: I left the following 2 blank:
federated.ldap.attributes.nonSupported=certificate, members
federated.ldap.attributes.nonSupported.delete=
I set the following 3 to the recommended values:
federated.ldap.attributes.mapping.ldapName=mail, title
federated.ldap.attributes.mapping.portalName=ibm-primaryEmail, ibm-jobTitle
federated.ldap.attributes.mapping.entityTypes=PersonAccount
14. Save your changes to the wkplc.properties file.
15. Run the following task to update the LDAP user registry configuration with the
following items:
C:\IBM\WebSphere\wp_profile\ConfigEngine\ConfigEngine.bat wp-updatefederated-ldap-attribute-config -DWasPassword=password
16. Stop and restart the Portal Server by running
a. C:\IBM\WebSphere\wp_profile\bin>stopServer.bat WebSphere_Portal -user
localadmin -password password
b. C:\IBM\WebSphere\wp_profile\bin>startServer.bat WebSphere_Portal
17.
18.
19.
20.
21.
22.
23.
24.
25.
26. At this point you should be able to open a browser to the portal server and log in with
an ldap user (http://cpportal.rtp.raleigh.ibm.com:10039/wps/portal)
Apply recommended updates for WebSphere Portal
Please keep in mind the steps show application of 8.5 CF08 on a standalone server. I
would strongly recommend you check out the offocial documentation to ensure you are
completing all necessary steps for your environment.
http://www10.lotus.com/ldd/portalwiki.nsf/xpDocViewer.xsp?lookupName=Combined+Cumulative
+Fix+Readme+V8.5.0.0#action=openDocument&res_title=WebSphere_Portal_and_Web
_Content_Manager_V8.5.0.0_combined_cumulative_fix_overview_cf8500&content=pdc
ontent
Software used at this step:
Recommended Updates for WebSphere Portal and IBM Web Content Manager V8.5
http://www-01.ibm.com/support/docview.wss?uid=swg24037802
At the time of this install (26 Oct 2015) The following fixes were recommended
From the Recommended Update package from Fix Central I downloaded
interim fix: 8.5-WP-WCM-Combined-CFPI45447-Server-CF08
WebSphere Application Server 8.5.5 fp7
Recommended fixes: http://www01.ibm.com/support/docview.wss?uid=swg27004980
8.5.5.7: http://www-01.ibm.com/support/docview.wss?uid=swg24040533
IBM WebSphere SDK Java Technology Edition 7.1.3.10
IBM WebSphere SDK PI50090: http://www01.ibm.com/support/docview.wss?uid=swg24041099
Extract the downloaded files to different directories. Make sure part1 and part2 of the
WAS and SDK fixes are extracted to the same location (I used
C:\DownloadDirector\CF08)
3.
Install WAS prerequisite updates
1. Shut down WebSphere Portal by running:
a. C:\IBM\WebSphere\wp_profile\bin>stopServer.bat WebSphere_Portal -user
localadmin -password password
2. Shut down the cw_profile server by running
a. C:\IBM\WebSphere\AppServer\profiles\cw_profile\bin>stopServer.bat server1 username localadmin -password password
3. Run IBM Install Manager
4.
5. Add the repository for WebSphere Application Server 8.5.5.7
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
4.
Install Latest Portal CF (8.5 CF08)
After extracting 8.5-WP-WCM-Combined-CFPI45447-Server-CF08 to it's own directory
(I used C:\DownloadDirector\CF08\7.1.0.0-WS-WASJavaSDK7-WinX64-IFPI50090)
open this directory and extract HealthCheckTool-Portal85.zip to
C:\IBM\WebSphere\PortalServer and replace the existing files with the files from the zip.
Then extract WP8500CF08_Server.zip to the downloaded location (I used
C:\DownloadDirector\CF08\8.5-WP-WCM-Combined-CFPI45447-ServerCF08\WP8500CF08_Server)
4.1. Run Health Check Tool prior to CF install
1. Start WebSphere Portal by running
C:\IBM\WebSphere\wp_profile\bin\startServer.bat WebSphere_Portal
2. Verify the following settings in
C:\IBM\WebSphere\wp_profile\ConfigEngine\properties\wkplc.properties
WasRemoteHostName=cpportal.rtp.raleigh.ibm.com
WasSoapPort=10033
WasUserid=localadmin
WasPassword=password
PortalAdminId=localadmin
PortalAdminPwd=password
WpsHostName=cpportal.rtp.raleigh.ibm.com
WpsHostPort=10039
WpsContextRoot=wps
NOTE: The only ones I had to change in my environment were
WasPassword=password
PortalAdminPwd=password
3. Verify the following settings in
C:\IBM\WebSphere\wp_profile\ConfigEngine\properties\wkplc_dbdomain.properties
release.DbPassword=<your database user password>
community.DbPassword=<your database user password>
customization.DbPassword=<your database user password>
jcr.DbPassword=<your database user password>
likeminds.DbPassword=<your database user password>
feedback.DbPassword=<your database user password>
NOTE: I did not change from the default database, so no changes were made
4. Verify the following settings in
C:\IBM\WebSphere\wp_profile\ConfigEngine\properties\wkplc_comp.properties
XmlAccessHost=localhost
XmlAccessPort=10039
NOTE: These were set correctly in my env
5. Run the following command to validate the install
C:\IBM\WebSphere\wp_profile\ConfigEngine>ConfigEngine.bat health-checkupdate -DPortalAdminPwd=password -DWasPassword=password
NOTE: When I ran this command, I got the following error:
BUILD FAILED
C:\IBM\WebSphere\PortalServer\installer\wp.update\config\includes\upgrade_health
_check.xml:1097: java.net.MalformedURLException: For input string:
"10039${WpsContextRootPath}"
Total time: 20 seconds
This is caused by a bug in the upgrade_health_check.xml file. APAR PI51240 has
been opened and a fix is being worked on, if you are unable to find that fix, you can
simply use these steps to workaround the issue:
a. Edit
C:\IBM\WebSphere\PortalServer\installer\wp.update\config\includes\ upgrade_he
alth_check.xml
b. We need to add a / before ${WpsContextRootPath}, so Change line #1092 from
<get src="http://${WpsHostName}:${WpsHostPort}${WpsContextRootPath}
to
<get src="http://${WpsHostName}:${WpsHostPort}/${WpsContextRootPath}
4.2. Install WebSphere Portal CF 08
1. Stop Portal if it's running by running:
C:\IBM\WebSphere\wp_profile\bin\stopServer.bat WebSphere_Portal -user
localadmin -password password
2. If IBM Install Manager is not started, start it now
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
5.
Post install tasks
1. Make sure Portal is shut down and run the following task:
C:\IBM\WebSphere\wp_profile\PortalServer\bin>applyCF.bat DPortalAdminPwd=password -DWasPassword=password
2. At this point you should be able to open a browser and sign into Portal 8.5 CF08.