Importing resources from WebSphere Portal

With the WebSphere® Portal plug-in, you can discover resources for a portal cell and use plug-in steps to deploy artifacts.

Before you begin

Procedure

  1. On the IBM UrbanCode Deploy server, go to the Resources tab.
  2. Next to a resource, click Actions and then click Add Agent.
  3. In the Create New Resource window, select the agent and then click Save. The new agent resource appears in the resource tree. In a short time, another resource appears under the agent resource. This resource is named WebSphereCell and represents the WebSphere Application Server cell. You might need to click Refresh to make the cell appear.
  4. Click the WebSphere Application Server cell resource and then click Configuration > Basic Settings. This resource has the WebSphereCell role, which includes several properties that are related to the cell.
  5. In the section that is labeled Role Properties for the WebSphereCell role, specify the connection information for the cell, including the locations of the profile and wsadmin file and the username and password for the WebSphere Application Server system, as in the following figure:
    Specifying the information for the cell resource
    Note: Leave the Cell Name property blank.
  6. Click Save.
  7. On the Resources tab, next to the cell resource, click Actions and then click Auto Configure.
  8. In the Auto Configure window, click the Steps field, select the check box next to the WebSphere Topology Discovery step, and then click OK.
    Specifying the information for the cell resource
  9. Click Save to close the Auto Configure window.
  10. Wait 30-60 seconds, then click Refresh. A twisty is now next to WebSphereCell. Expand it and make sure the resource tree matches your WebSphere Application Server topology. It will contain deployable artifacts for WebSphere Portal (theme, PAA, WAR, ConfigEngine command, XMLAccess script)
  11. On the WebSphereCell entry, click Edit and check that Cell Name was filled in and is correct.
  12. Define properties for resources. Click the resource, then the Configuration tab, then Resource Properties.
    • For ND topology, define the properties for Portal Cluster, Portal Primary Node, and Portal Secondary Node resources.
    • For stand-alone topology, define the properties for the Portal Node resource.

    Define the following properties:

    • portal.home: Portal installation directory
    • portal.profile.home: Portal profile directory
    • portal.admin.user: Portal administrator user name
    • portal.admin.password: Portal administrator password
    • portal.config.port: Portal configuration port
    • websphere.password: WebSphere administrator password
  13. Create components for the resources. You need one component for each resource to deploy.
  14. Add the components to the resources.
    1. Go to the resource.
    2. Choose Actions > Add Component
    3. Select the component to use.
  15. Create the application.
    1. Go to Applications.
    2. Click Create New Application (if one does not exist). You can also use an existing application that is attached to the cell to manage.
    3. Enter an application name, then click Save.
    4. Click the Components tab, then add the component that was created by the template generation procedure.
  16. Create an application environment.
    1. In the Resources tab, click Create New Environment.
    2. Enter an environment name, then click Save.
    3. Go to the environment editing page.
    4. Click on the environment name, then click Add Base Resource. Choose the group for your exemplar cell and environment.
    5. Edit the environment properties for the component. Click Configuration > Environment Properies. In the Component Environment Properties list, enter values for each property shown. Note that values are already filled in with default values if you provided them above.
  17. Create an application process of type Deployment for configuration and deployment.
    1. Click the Processes tab.
    2. Add a deploy step.
    3. Drag and drop the Install Component step onto the process editor.
      1. Select the component to use. You created this component for the resource. For example, you created a component to contain a Portal WAR file to be deployed.
      2. Choose the process for the component. For example, you would choose Deploy Portal WAR file for a Portal WAR file component.
    4. Click Save.
    5. Save the process.
  18. Run the process to test the newly created component.

Feedback