Network Deployment (Distributed operating systems), v8.0 > Set up intermediary services > Implement a web server plug-in

Allow web servers to access the administrative console

This topic describes how to add the virtual host that servers the administrative console to the plug-in configuration file so that you can access the administrative console through a web server.

(AIX) (Solaris) Note: If a web server is in a configuration, its port must be higher than 1023 to use a nonroot node agent. Otherwise the node agent must be running as root in order for the administrative console of the dmgr to stop and start the web server process in that managed node.

Install your WAS product, a web server, the Web Server Plug-ins, and the WebSphere Customization Toolbox.

The Web Server Plug-ins Configuration Tool creates a web server definition on the application server system, either directly when they are on the same machine or by a script for remote scenarios.

After creating the web server definition, the plug-in configuration file exists within the web server definition.

The plugin-cfg.xml file can be overwritten by the dmgr synchronization operation, the GenPluginCfg script or any other method that regenerates the file. If you make changes to the plugin-cfg.xml file, and want to keep those changes, IBM recommends that you create a copy of the file in a separate location. Make your manual updates each time the file is automatically refreshed by another process.

This task gives you the option of configuring the admin_host so that web servers can access the administrative console. When the web server plug-in configuration file is generated, it does not include admin_host on the list of virtual hosts.

Procedure

1. Use the administrative console to change the admin_host virtual host group to include the web server port (80 by default).

   1. Click Environment > Virtual Host > admin_host > Host Aliases > New.

      The default port that displays is 80, unless you specify a different port during profile creation.

   2. Specify the IP address, or the name of the machine that is hosting the HTTP server.

      For example, if you installed a WAS product on a machine that is named waslwaj.rtp.ibm.com, specify the name in this field.

2. Click Apply > Save.

3. Stop and restart the application server.

   For example, to access the administrative console of a stand-alone application server, stop and restart the server1 process.

   To stop server1, open a command window and navigate to the PROFILE_ROOT/bin directory. Then issue the following command:

   ./stopServer.sh server1
   

   After receiving the following message, you can restart the application server:

   Server server1 stop completed.
   

   To start the application server, issue the following command:

   ./startServer.sh server1
   

   When you receive a message that is similar to the following message, the server1 process is running:

   Server server1 open for e-business; process id is 1719
   

4. Stop and restart a dmgr.

   For example, to access the administrative console of a dmgr, stop and restart the dmgr.

   To stop the dmgr, open a command window and navigate to the PROFILE_ROOT/bin directory. Then issue this command:

   ./stopManager.sh
   

   Then issue the following command to stop the dmgr:

   ./stopManager.sh
   

   After receiving the following message, you can restart the dmgr:

   Server dmgr stop completed.
   

   To start the dmgr, issue the following command:

   ./startManager.sh
   

   When you receive a message that is similar to the following message, the dmgr is running:

   Server dmgr open for e-business; process id is 1720
   

5. Edit the plugin-cfg.xml file to include the following entries:

   <VirtualHostGroup Name="admin_host">  
   <VirtualHost Name="*:9060"/>  
   <VirtualHost Name="*:80"/>  
   <VirtualHost Name="*:9043"/>
   </VirtualHostGroup>     ...
       ...
       ...
   
   <ServerCluster Name="server1_SERVER1HOSTserver1_Cluster">  
   <Server LoadBalanceWeight="1" Name="SERVER1HOSTserver1_dmgr">      
   <Transport Hostname="SERVER1HOST" Port="9060" Protocol="//publib.boulder.ibm.com/infocenter/wasinfo/v8r0/index.jsp?topic=/  "/>  
   </Server>  
    
   <PrimaryServers>      
   <Server Name="SERVER1HOSTserver1_dmgr"/>  
   </PrimaryServers>
   </ServerCluster>     ...
       ...
       ...
   
   <UriGroup Name="admin_host_server1_SERVER1HOSTserver1_Cluster_URIs">  
   <Uri AffinityCookie="JSESSIONID"
               AffinityURLIdentifier="jsessionid" Name="/ibm/console/*"/>
   </UriGroup>
   <Route ServerCluster="server1_SERVER1HOSTserver1_Cluster"
           UriGroup="admin_host_server1_SERVER1HOSTserver1_Cluster_URIs" VirtualHostGroup="admin_host"/>  
   

   If your HTTP server has an HTTP port other than 80, add an entry to the VirtualHostGroup:

   <VirtualHost Name="*:port"/>
   
   

   The port variable is your HTTP server port.

Results

You can configure your supported web servers to access the administrative console application of a dmgr or a stand-alone application server.

+

Search Tips   |   Advanced Search