WA1937 WebSphere Portal 7.0 Programming. Classroom Setup Guide. Web Age Solutions Inc. Copyright 2012 Web Age Solutions Inc. 1

Table of Contents Part 1 - Minimum Hardware Requirements...3 Part 2 - Minimum Software Requirements...3 Part 3 - Software Provided...4 Part 4 - Important Ghosting or Imaging Information...4 Part 5 - Preparation...5 Part 6 - Installing Java SE 6 JRE Update 26...6 Part 7 - Installing AnyClient File Transfer Application...7 Part 8 - Installing Rational Application Developer v8.0 Trial (RAD 8.0.4) with WebSphere Portal 7.0...10 Part 9 - Verification of WebSphere Portal 7.0 installation...14 Part 10 - Installing Rational Application Developer v8.0 Trial (RAD 8.0.4)...15 Part 11 - Verification of Rational Application Developer v8.0 Trial (RAD 8.0.4) installation...22 Part 12 - Modify File Permissions...23 Copyright 2012 Web Age Solutions Inc. 2

Part 1 - Minimum Hardware Requirements Pentium 4-1.4GHz or higher 2.25 GB RAM minimum, 4 GB recommended. 30GB free hard disk space (preferably in C: drive). Network connectivity to the internet. Note: Some of the lab exercises require functioning Internet access. Part 2 - Minimum Software Requirements One of the following Windows platforms: Windows 7 Professional, Enterprise, or Ultimate editions Windows Vista Professional, Enterprise, or Ultimate editions Windows Server 2008 Standard Edition or Enterprise Edition Windows XP Pro (SP3) Adobe Acrobat Reader Zip extraction utility A Web Browser compatible with WebSphere Portal 7.0 Internet Explorer 8 or 9 (with latest fixes applied) Firefox 4 AnyClient File Transfer client * IBM Rational Application Developer v8.0.4 Trial* IBM WebSphere Portal Server 7.0 * * - indicates software provided as part of the courseware. Copyright 2012 Web Age Solutions Inc. 3

Part 3 - Software Provided You will receive the following files: WA1937_1.ZIP WA1937_2.ZIP WA1937_3.ZIP All other software listed under Minimum Software Requirements is either commercially licensed software that you must provide or software that is freely available off the Internet. Part 4 - Important Ghosting or Imaging Information Some of the software installed for this course will not function after changing the computer hostname. As such, cloning or imaging should not be used on a fully installed system. You can save time by extracting the contents of the USB memory stick to C:\ on a clean OS install (no other software installed) and then imaging that hard drive. After restoring the image to the other computers and changing the hostnames, you can then install the software on each computer individually by following the instructions that are detailed later in this document. Copyright 2012 Web Age Solutions Inc. 4

Part 5 - Preparation 1. Login as an account that has administrative privileges. 2. If possible, disable all firewall notifications to speed up installation. 3. Extract ALL the ZIP files directly to C:\ 4. Review that the following folders were created: C:\LabFiles C:\Software\AnyClient C:\Software\RAD C:\Software\RAD_SETUP C:\Software\WebSpherePortal7.0 5. Review that the following files were created: C:\Software\jre-6u26-windows-i586.exe Copyright 2012 Web Age Solutions Inc. 5

Part 6 - Installing Java SE 6 JRE Update 26 1. From the C:\Software directory run the following file: jre-6u26-windows-i586.exe Note: If using prompted by a security prompt allow the installation to continue. 2. After a few moments the installation screen will appear. Press the Install button to begin the installation. 3. Wait while the software installs. 4. Make sure you get a success message and click the Close button. Copyright 2012 Web Age Solutions Inc. 6

Part 7 - Installing AnyClient File Transfer Application 1. Login as an administrative user if not already. 2. Make sure that a Java environment has previously been installed as part of the class setup. 3. From the C:\Software\AnyClient directory run the following file: install.exe Note: If using prompted by a security prompt allow the installation to continue. 4. On the welcome page click the Next button. 5. After a few moments the license agreement will appear. Accept the license and click the Next button. 6. Leave the defaults for installation location and options, and press the Next button. Your destination directory may be slightly different depending in the version of Windows being used. Copyright 2012 Web Age Solutions Inc. 7

7. Accept the defaults for creating a Start Menu shortcut and click the Next button. 8. Accept the default for creating a desktop icon and click the Next button. Wait until the software is completely installed. 9. Change to Never check for updates and click Next. 10. Click Finish. This should automatically start the AnyClient program. Accept any security prompts if they appear when starting the program. 11. Once you know the software starts select File Exit to exit the AnyClient program. Copyright 2012 Web Age Solutions Inc. 8

Part 8 - Installing Rational Application Developer v8.0 Trial (RAD 8.0.4) with WebSphere Portal 7.0 Installing RAD 8.0.2 with Portal 7.0 involves two basic steps: installing RAD 8.0.2 itself and then installing Portal 7.0. This document will outline all these steps. Average time for installation of RAD 8.0.4 Trial with WebSphere Portal 7.0: 2 hours. Note: If installing on Windows Vista, Windows 7, or Windows Server 2008 there will be several notes about special steps required on these platforms. Failure to include these additional steps will lead to an unusable installation. 1. Before you begin, shut down any running applications. The installation process is quite CPU/disk intensive. 2. Make sure you are logged in as an account with administrative privileges. It is also suggested to turn off all Windows Firewall notifications as this will help to speed up the installation. 3. Open a command prompt window. You can do this by selecting Start Programs Accessories Command Prompt. 4. Use the 'cd' command to change directories to C:\Software\WebSpherePortal7.0 > cd C:\Software\WebSpherePortal7.0 5. Run the following command to launch the installation wizard. > install -W nodehost.active="false" If you are running Windows 7 or Vista you will get messages to allow running the software. Always allow access. Copyright 2012 Web Age Solutions Inc. 10

6. The WebSphere Portal and Lotus Web Content Management Version 7 installation wizard window will open, Select IBM WebSphere Portal Enable and click Next. 7. Accept the license agreement and click Next. 8. Select Base install and click the Next button. 9. Leave the default the installation directory and click Next. Copyright 2012 Web Age Solutions Inc. 11

Note: At this point, if you get a screen prompting for the hostname of the machine you started the installation wizard with the wrong options. Cancel the wizard and double check the command used to start the installation. The reason we started the installation with the special option was to skip the configuration of the Portal hostname. If the installation prompts you for a hostname it will not accept anything less than a fully qualified domain name. Since this is not needed for a test environment and may cause other issues we are having the installation skip this step. The Portal install will still work even though the option skips this step. 10. Enter wpsadmin in all the fields for user ID and password. Copyright 2012 Web Age Solutions Inc. 12

Carefully enter the password as this password is expected by the labs. 11. Click the Next button. 12. Leave the option to run Portal as a service unchecked and click the Next button. 13. On the summary screen click the Next button to begin the installation. If prompted by any Windows security prompts unblock or allow the process. 14. Wait for a while as Portal installs. This will take some time. You maybe be prompted to allow permissions. Copyright 2012 Web Age Solutions Inc. 13

15. Once the installation completes uncheck all the boxes in the installation wizard and click the Finish button. Part 9 - Verification of WebSphere Portal 7.0 installation 1. Open a web browser to the following address: http://localhost:10039/wps/portal After a few moments the Portal login page should appear. 2. Fill in a user ID and password of 'wpsadmin' and press the Log in button. 3. Verify that you see the WebSphere Portal administrative interface. Copyright 2012 Web Age Solutions Inc. 14

4. If you get a Add-ons message using Firefox, leave disabled Java and restart Firefox. 5. Click the Logout link on the right and close the browser. 6. Close all windows. Part 10 - Installing Rational Application Developer v8.0 Trial (RAD 8.0.4) 1. Restart the computer. This will automatically stop the WebSphere Portal server. 2. Login as the administrative user that you used for the Portal installation. 3. From C:\Software\RAD_SETUP, run launchpad.exe. The installer will begin. Note: If installing on Vista/7/2008 right click the launchpad.exe program and select 'Run as Administrator' and accept any security prompts. 4. Click Install IBM Rational Application Developer for WebSphere. Copyright 2012 Web Age Solutions Inc. 15

5. From the Install Packages screen Uncheck the following software so it will not be installed: IBM WebSphere Application Server IBM Rational Desktop Connection Toolkit for Cloud Environments IBM WebSphere Application Server Version 6.1 Test Environment (both for 32-bit and 64-bit) IBM WebSphere Application Server Version 7.0 Test Environment (both for 32-bit and 64-bit) 6. Make sure only IBM Installation Manager and IBM Rational Application Developer for WebSphere Software Version 8.0.4 are selected as shown below and click Next. The Validation Results page will appear. Copyright 2012 Web Age Solutions Inc. 17

7. Check that you don't have any validation errors except the warning about stopping running programs including anti-virus software and click the Next button. The License Agreement screen will appear. 8. At the bottom of the screen, select I accept the terms in the license agreements and click Next. You will be asked to select a location for the Installation Manager. 9. Change the Shared Resources Directory and Installation Manager Directory to the values below: Shared Resources Directory: C:\IBM\SDPShared Installation Manager Directory: C:\IBM\Installation Manager\eclipse Copyright 2012 Web Age Solutions Inc. 18

10. Click Next when your screen looks like shown below. 11. Change the IBM Software Delivery Platform to C:\IBM\SDP 12. Verify the installation locations as shown below and click the Next button. 13. Leave the option to extend an existing Eclipse installation unselected and click the Next button. 14. Leave the default language selection and click the Next button. Copyright 2012 Web Age Solutions Inc. 19

15. In the feature selection page expand IBM Rational Application Developer for WebSphere Software 8.0.4 Portlet and Portal development tools. 16. Scroll down and check the option for WebSphere Portal Server, version 7.0. 17. Once your features are set as shown above click the Next button. 18. For the option for the Help System leave Access help from the Web selected and click the Next button. Copyright 2012 Web Age Solutions Inc. 20

You will be asked to review summary information. 19. After checking that WebSphere Portal Server, version 7.0 is selected to be installed click Install. RAD 8.0.4 installation will start, this will take some time. Eventually, it will complete. 20. Select None and click the Finish button. Copyright 2012 Web Age Solutions Inc. 21

21. Close all open windows. Part 11 - Verification of Rational Application Developer v8.0 Trial (RAD 8.0.4) installation 1. From the Start menu, select All Programs >IBM Software Delivery Platform > IBM Rational Application Developer 8.0 > Rational Application Developer. 2. The workspace Launcher window will open, accept the default workspace location and click OK. Rational Application Developer v8.0 Trial (RAD 8.0.4) will start. 3. The Features with Trial Licenses dialog will open. Click Ignore. Copyright 2012 Web Age Solutions Inc. 22

4. The Initializing Help dialog may open showing a progress bar, wait until finishes. This may take a some minutes. 5. The Welcome page will open. 6. From the menu, select File->Exit to close Rational Application Developer. 7. Close all open windows Part 12 - Modify File Permissions Note: These steps allow full access to the directories used by the Portal install. This is required so that students can start the Portal server from within RAD and will allow the Portal server to write to the log files. Without these steps the students won't be able to start the Portal server and won't be able to do the labs. Copyright 2012 Web Age Solutions Inc. 23

The steps to accomplish this may vary by Windows version but the goal is the same, granting access to all users to the Portal install. If you have questions about how to accomplish this contact the setup support person for the class. 1. Right click C:\IBM and select Properties. 2. Click the Security tab. 3. Click Advanced. 4. Click Change Permissions. Copyright 2012 Web Age Solutions Inc. 24

8. Select the check box for "Replace all child permissions with inheritable permissions from this objects" and then click OK. 9. Click OK to continue. 10. A Windows security dialog will open, click Yes. Copyright 2012 Web Age Solutions Inc. 26

11. Wait until finishes updating security, and close all windows when is done by clicking OK. 12. Give full privileges to C:\LabFiles to all users as you just did it. 13. Restart the computer and login with the user that the student will use to do the Labs. 14. Make sure the user has full access to C:\LabFiles as well as C:\IBM folders. Congratulations, WebSphere Portal v7.0 and Rational Application Developer v8.0.4 have been installed. Copyright 2012 Web Age Solutions Inc. 27