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.
Before you begin
Install
your WebSphere Application Server product, a web server, the Web Server
Plug-ins, and the WebSphere Customization Toolbox.
When you configure a web server plug-in, a Web
server definition is created 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 deployment manager 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, it is recommended 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.
About this task
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.
- Use the administrative console to change the admin_host
virtual host group to include the web server port (80 by default).
- 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.
- Specify the IP address, or the name of the machine that
is hosting the HTTP server.
For example, if you installed
a WebSphere Application Server product on a machine that is named
waslwaj.rtp.ibm.com, specify the name in this field.
- Click Apply > Save.
- 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.
Start a Qshell session and run the following command:
cd profile_root/bin
stopServer server1
Then issue the following command to
stop the application server:
stopServer -profileName myProfile 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:
When the application server is running, a message
is displayed that indicates that the process is running. This message
includes the iSeries job ID and the administrative console port.
- Stop
and restart a deployment manager.
For example, to access
the administrative console of a deployment manager, stop and restart
the deployment manager.
Start a Qshell session and run the following command:
cd profile_root/bin
Then issue the following command to stop the deployment
manager:
After
receiving the following message, you can restart the deployment manager:
Server dmgr stop completed.
To
start the deployment manager, issue the following command:
When the deployment manager is running, a message
is displayed that indicates that the process is running. This message
includes the iSeries job ID and the administrative console port.
- Edit the plugin-cfg.xml file to include
the following entries:
<VirtualHostGroup Name="admin_host">
<VirtualHost Name="*:13060"/>
</VirtualHostGroup>
...
...
...
<ServerCluster Name="my60Profile.dmgr_muiSeries_Cluster">
<Server LoadBalanceWeight="1" Name="myiSeries_my60Profile.dmgr">
<Transport Hostname="myiSeries" Port="11060" Protocol="http"/>
</Server>
<PrimaryServers>
<Server Name="myiSeries_my60Profile.dmgr"/>
</PrimaryServers>
</ServerCluster>
...
...
...
<UriGroup Name="admin_host_my60Profile.dmgr_myiSeries_Cluster_URIs">
<Uri AffinityCookie="JSESSIONID"
AffinityURLIdentifier="jsessionid" Name="/ibm/console/*"/>
</UriGroup>
<Route ServerCluster="my60Profile.dmgr_myiSeries_Cluster"
UriGroup="admin_host_my60Profile.dmgr_myiSeries_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.