Amol Gade (amolgade@in.ibm.com) Deploy Plugins Developer 29 October 2013 IBM UrbanCode Deploy v6.0 Support Enablement Training Deployment for WebSphere Portal Plugin 1

Agenda Overview Installation and configuration Migration and/or Upgrade Process Troubleshooting procedures Known Issues Source: If applicable, describe source origin (date, author, publication) 2 2

UC Deploy v6.0 Portal Plugin - Overview Add capabilities to the IBM Urban Code Deploy (UCD) product that allow for deployment of WebSphere Portal artifacts Used to automate deployments of themes, skins, PAAs and WARs on to a Portal server Also adds the capability to execute generic ConfigEngine commands and XMLAccess scripts Source: If applicable, describe source origin (date, author, publication) 3 3

UC Deploy v6.0 Portal Plugin – Supported Portal versions WebSphere Portal 6.1, 6.1.5, 7.0 and 8.0 Both ND and Standalone topology are supported Supports all Platforms and Hardware supported by WebSphere Portal and Deploy Agent 4 4

UC Deploy v6.0 Portal Plugin – High level flow Execute the auto-discover and configure step provided by the Application Deployment for WebSphere Plugin for the Portal cell This creates all cell resources like, Cell, Clusters and Nodes in the Resources view This is an optional step, the required resources can be created manually if desired Define the following properties for Portal Cluster, Portal Primary Node and Portal Secondary Node resources. For Standalone topology, the only Portal Node resource is valid portal.home [The Portal installation directory] portal.profile.home [The Portal profile directory] portal.admin.user [The Portal administrator user name] portal.admin.password [The Portal administrator password] portal.config.port [The Portal configuration port] websphere.password [The WAS administrator password] The desired deployment can now be automated by defining required Components, Applications and Environments corresponding to these resources. 5 5

UC Deploy v6.0 Portal Plugin

UC Deploy v6.0 Portal Plugin – Resources Topology will be auto-discovered on systems with a UC Deploy agent and represented as Resources. 7 7

UC Deploy v6.0 Portal Plugin – Resource Properties Define following properties for the top level resource 8 8

UC Deploy v6.0 Portal Plugin – Deploy Theme Process All Plugin steps requires the artifact to be deployed present in the CodeStation Thus, Download Artifacts is a mandatory step to be executed prior to the plugin step 9

UC Deploy v6.0 Portal Plugin – Components And Applications The Deployment for WebSphere Portal plugin does not create any Component and/or Application by itself All Components and/or Applications need to be created by the Deployment Automation Engineer 10 10

UC Deploy v6.0 Portal Plugin - Installation and Configuration The WebSphere Portal plug-in is imported into the Deploy server using the following procedure: In the Deploy UI navigate to the Settings->Automation Plugins page Click on the Load Plugin button, which will open a dialog box. In the dialog box click the Choose File button and select the WebSpherePortal.zip file Click the Submit button The plug-in doesn’t require any explicit configuration other then to ensure your WAS cells have been modeled as Resources and all resource level properties have beed defined as described. Source: If applicable, describe source origin (date, author, publication) 11 11

Migration or Upgrade Process This is the first release of the WebSphere Portal plug-in so there is no upgrade process Source: If applicable, describe source origin (date, author, publication) 12 12

Known Issues & Gotchas WAS auto discovery – if WAS is installed into a directory other then the default then you must set a property on the agent prior to adding it to your top level resource group. On the Resources/Agents/<agent_name>/Configuration/Agent Properties page add a property named wsadmin.path and set the value to the fully qualified path of the wsadmin script including wsadmin.sh|bin After auto discovery you must manually initiate the “Auto Configure” step… some of the information is automatically detected but some must be manually entered and the process must be explicitly initiated Source: If applicable, describe source origin (date, author, publication) 13 13

Frequently Asked Questions Q: Is this Plugin capable of Portal Configuration as well? A: No! The Plugin can only be used to deploy the mentioned artifacts to the WebSphere Portal server. Thus, we do not claim support for Portal configuration. However, since WebSphere Portal runs on the underlying WebSphere Application Server, the MCWAS plugin can be used to configure WAS specific data. 14

Author Note: Mandatory Rational closing slide (includes appropriate legal disclaimer). Graphic is available in English only. www.ibm.com/software/rational © Copyright IBM Corporation 2013. All rights reserved. The information contained in these materials is provided for informational purposes only, and is provided AS IS without warranty of any kind, express or implied. IBM shall not be responsible for any damages arising out of the use of, or otherwise related to, these materials. Nothing contained in these materials is intended to, nor shall have the effect of, creating any warranties or representations from IBM or its suppliers or licensors, or altering the terms and conditions of the applicable license agreement governing the use of IBM software. References in these materials to IBM products, programs, or services do not imply that they will be available in all countries in which IBM operates. Product release dates and/or capabilities referenced in these materials may change at any time at IBM’s sole discretion based on market opportunities or other factors, and are not intended to be a commitment to future product or feature availability in any way. IBM, the IBM logo, Rational, the Rational logo, and other IBM products and services are trademarks of the International Business Machines Corporation, in the United States, other countries or both. Other company, product, or service names may be trademarks or service marks of others. 15 15

www.ibm.com/software/rational Keep this as the last chart in the deck 16 16