WebSphere Application Server Network Deployment, Version 6.0.x     Operating Systems: AIX, HP-UX, Linux, Solaris, Windows

Configuring a Web server and a custom profile on the same machine

This procedure describes installing a Web server and its plug-in on a machine where the default profile is a custom profile.

Before you begin

This procedure configures the custom profile that is the default profile on the machine. This procedure assumes that you already have installed a deployment manger on Machine A.


Local distributed installation

The WebSphere Application Server node on Machine B is the custom node that you create in this procedure. This procedure starts the deployment manager and federates the custom node before installing the Web server plug-ins.

Start the deployment manager. The deployment manager must be running to successfully federate and configure the custom node.

Why and when to perform this task

Use the following procedure to install the Web server plug-in, configure the Web server, and create a Web server definition in the default custom profile (custom node).

Steps for this task

  1. Install the WebSphere Application Server Network Deployment product.

    See Installing the product and additional software.

  2. Create a custom profile as the first profile on the machine and federate the node as you create it. See Creating a custom profile.
  3. Optional: Use the administrative console of the deployment manager to create an Application Server on the custom node.

    Click Servers > Applications servers > New and follow the instructions to create a server. A server is not required for installing the plug-ins but it lets you verify the functionality of the Web server.

  4. Optional: Install the DefaultApplication on the new server while you are in the administrative console of the deployment manager.

    The DefaultApplication includes the snoop servlet. The verification step uses the snoop servlet.

  5. Stop the application server if it is running.

    Use the stopServer command or the administrative console of the deployment manager to stop the managed node.

  6. Select Application server machine (local) and click Next.
  7. Click Browse on the Application Server installation location panel to browse for the location of the managed node, if necessary. Click Next when the installation root directory is correct.

    The fully qualified path identifies the installation root directory for the Network Deployment product core files.

  8. Specify a nick name for the Web server and click Next.
  9. Accept the location for the plugin-cfg.xml file and click Next.

    See Plug-ins configuration for a description of the logic that determines what path is configured by default. The wizard determines the characteristics of the managed application server node to determine the best path for the file:

    A federated custom node has the following path:
    profile_root
       /config/cells/cell_name/nodes/
       node_name_of_custom_profile/servers/
       web_server_name/plugin-cfg.xml

    Accept the default value.

  10. Click Next after verifying the characteristics of the plug-ins installation or click Back to make changes.

    You can use the administrative console of the deployment manger to delete an existing Web server or to create new ones. Federated nodes can have more than one Web server definition.

  11. Click Next on the pre-installation summary panel to begin the installation or click Back to change any characteristics of the installation. The wizard begins installing the plug-ins and configuring the Web server and the managed custom node.

    The wizard shows an installation status panel as it installs the plug-ins. The wizard displays the Installation summary panel at the completion of the installation.

  12. If the deployment manager does not have the DefaultApplication installed, you can test the functionality of the Web server and the custom node using an application of your own.

    See Fast paths for WebSphere Application Server for help in deploying applications.

  13. To create multiple Web server definitions for the managed node, use the Plug-ins installation wizard to configure each Web server.

    Identify the same managed node each time. Give each Web server a different nick name.

Result

This procedure results in the installation of the Web server plug-ins for WebSphere Application Server on a Web server machine. The Plug-ins installation wizard creates a Web server definition within the managed node.

The Plug-ins installation wizard configures the Web server to use the plugin-cfg.xml file that is within the managed custom node.

The deployment manager regenerates the Web server plug-in configuration file, plugin-cfg.xml whenever an event occurs that affects the file. Such events include the addition or removal of an application, server, or virtual host.

The creation or removal of clusters and cluster members also causes file regeneration. Automatic propagation through node synchronization copies the file after each regeneration to the following location on the custom node machine:
profile_root
   /config/cells/cell_name/nodes/
   node_name_of_custom_profile/servers/
   web_server_name/plugin-cfg.xml

What to do next

After installing the binary plug-in for the local Web server, you can start the managed node and the Web server after running the configuration script that completes the installation.

See Plug-ins configuration for information about the location of the plug-in configuration file.

See Web server configuration for more information about the files involved in configuring a Web server.

See Editing Web server configuration files for information about how the Plug-ins installation wizard configures supported Web servers.

See Installing Web server plug-ins for information about other installation scenarios for installing Web server plug-ins.




Related concepts
Plug-ins configuration

Related tasks
Installing Web server plug-ins

Task topic    

Terms of Use | Feedback

Last updated: Dec 11, 2005 4:07:15 PM CST
http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.nd.doc/info/ae/ae/tins_webplugins_localr.html

© Copyright IBM Corporation 2004, 2005. All Rights Reserved.
This information center is powered by Eclipse technology. (http://www.eclipse.org)