This guided activity assists you in configuring the Web server plug-in to route requests for dynamic content, such as servlets, to an application server. It is assumed that the Web server is "remote" from the application server in that the Web server and the application server are on different machines. It is also assumed that the Web server software is installed. To continue, click Start. <A HREF="javascript:showHideList('othersWeb')"> <IMG SRC="/ibm/console/images/arrow_collapsed.gif" ALT="" ID="othersWebImg" ALIGN="left" BORDER="0" style="margin-left:-0.25em"/> </A> Distributed and zOS <TABLE id="othersWebList" style="font-size:100%;margin-left:1em;display:none"> <TR> <TD> Install the binary plug-in module using the Plug-ins installation wizard. The Plug-ins installation wizard installs the plug-in module and configures the Web server to communicate with the application server. Complete the following steps: <ol> <li> Stop the Web server while you are configuring the plug-in to work with it. </li> <li> On the machine where the Web server is installed, select the Plug-ins installation wizard from the launchpad or change directories to the plugin directory on the product disc. You can also issue the install command using the downloaded installation image. </li> <li> Follow the instructions on the Plug-ins installation wizard and select the Web server machine (remote) option. </li> </ol> </TD> </TR> </TABLE> <A HREF="javascript:showHideList('OS/400Web')"> <IMG SRC="/ibm/console/images/arrow_collapsed.gif" ALT="" ID="OS/400WebImg" ALIGN="left" BORDER="0" style="margin-left:-0.25em"/> </A> i5/OS <TABLE id="OS/400WebList" style="font-size:100%;margin-left:1em;display:none"> <TR> <TD> Install the Web Server Plugins feature. The WebSphere Application Server V6.1 for i5/OS installation CD allows you to install just the Web Server Plugins. Follow the steps below to install only the Web Server Plugins feature: Remote install from Windows workstation <ol> <li> Ensure that the host servers are started on your i5 server: STRHOSTSVR *ALL </li> <li> Stop the Web server or Domino server while you are configuring the plug-in to work with it. For IHS Web servers use: ENDTCPSVR SERVER(*HTTP) HTTPSVR(Web_server_name). For DOMINO servers use: ENDDOMSVR SERVER(Domino_server_name). The user may use the i5 WebAdmin GUI to accomplish the above. </li> <li> Insert the install CD into the CD-ROM drive of the Windows workstation. Note: If autorun is not enabled, change directory to cd_drive:\plugin and execute install.exe. </li> <li> The login screen is displayed. Enter a valid userid and password for the i5 server where you want to install. The userid must have *ALLOBJ and *SECADM special authorities </li> <li> Follow the instructions in the installation wizard. </li> </ol> </ol> Local install from Qshell <ol> <li> Ensure that the host servers are started on your i5 server: STRHOSTSVR *ALL </li> <li> Stop the Web server or Domino server while you are configuring the plug-in to work with it. For IHS Web servers use: ENDTCPSVR SERVER(*HTTP) HTTPSVR(Web_server_name). For DOMINO servers use: ENDDOMSVR SERVER(Domino_server_name). The user may use the i5 WebAdmin GUI to accomplish the above. </li> <li> Insert the Plug-ins install CD into the CD-ROM drive of your i5 server. </li> <li> Copy the RESPONSEFILE located under the /QOPT/WEBSPHERE/PLUGIN directory to an IFS directory. For example, CPY OBJ('/QOPT/WEBSPHERE/PLUGIN/RESPONSEFILE.TXT') TODIR('/tmp') </li> <li> Edit the copy of the RESPONSEFILE.TXT (for example, using the EDTF command) and make the following changes: <ol> <li> Change the value of the -OPT silentInstallLicenseAcceptance.value property to true. </li> <li> Change other optional parameters as appropriate. </li> </ol> <li> Start a Qshell session: STRQSH </li> <li> Change directory to /QOPT/WEBSPHERE/PLUGIN cd /QOPT/WEBSPHERE/PLUGIN </li> <li> Invoke the "install" command as follows: INSTALL -options path/RESPONSEFILE.TXT For example, INSTALL -options /tmp/RESPONSEFILE.TXT </li> </ol> </li> </ol> For more information, see <a target="help" href="http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-express-iseries&topic=tins_webplugins">Install of Web server plug-in for i5/OS</a> </TD> </TR> </TABLE> To continue, click Next step. <A HREF="javascript:showHideList('distWeb')"> <IMG SRC="/ibm/console/images/arrow_collapsed.gif" ALT="" ID="distWebImg" ALIGN="left" BORDER="0" style="margin-left:-0.25em"/> </A> Distributed <TABLE id="distWebList" style="font-size:100%;margin-left:1em;display:none"> <TR> <TD> The Plug-ins installation wizard creates a script file with a name of configureWeb_server_{web server name} (batch or shell depending upon operating system of the machine) in the plug-ins_installation_root/bin/ directory on the machine where the plug-in is installed. <ol> <li> Copy the configure{web server name} batch or shell script from the machine with the Web server to the was_install_root/bin directory on the machine with the application server. </li> <li> Start the application server. </li> <li> On the machine with the application server, run the batch or shell script to create the Web server definition in the configuration for the application server. </li> <li> On the machine with the Web server, start the Web server service by following the instructions that came with your Web server installation. </li> </ol> </TD> </TR> </TABLE> </li> <A HREF="javascript:showHideList('OS/4001Web')"> <IMG SRC="/ibm/console/images/arrow_collapsed.gif" ALT="" ID="OS/4001WebImg" ALIGN="left" BORDER="0" style="margin-left:-0.25em"/> </A> i5/OS <TABLE id="OS/4001WebList" style="font-size:100%;margin-left:1em;display:none"> <TR> <TD> In the information below, the following terms are used: plugins_install_root: This refers to the IFS directory in which the Web Server Plugins were installed. By default, this is /QIBM/ProdData/WebSphere/Plugins/V61/webserver. appserver_profile_root: This refers to the location of your WebSphere Application Server profile. For the default WebSphere Application Server install, the profile root of the profile myProfile is /QIBM/UserData/WebSphere/AppServer/V61/edition/profiles/myProfile where edition is Express, Base or ND. http_profile_root: This refers to the location of your http profile. For the default Web Server Plugins install, the default http_profile_root is /QIBM/UserData/WebSphere/Plugins/V61/webserver/profiles/http. product_lib: This refers to the product library which contains the service program objects for the web server plugins. For the default Web Server Plugins install, this is QWAS61A. If you install the Web Server Plugins, multiple times, the product_lib is QWAS61c where c is B, C, D, .... The plugins_install_root/properties/product.properties contains the value for the product library. <ol> <li> Create an HTTP profile on i5/OS: Please note, when the Web Server plugins feature is installed on i5/OS, a default http profile named http is created. If you choose to use the default http profile, proceed to step 2 now. Run the manageprofiles Qshell command to create an http profile. (Note: http profiles are the 6.1 equivalent of 5.0/5.1 remote instances.) For example, run this command from Qshell: plugins_install_root/bin/manageprofiles -create -profileName myHttpProfile -templatePath http where myHttpProfile is the name of the HTTP profile. </li> <li> Create a web server instance. Please refer to your web server's documentation or the WebSphere Application Server documentation for details. </li> <li> (IHS) <ol> <li> Point your browser to "http://hostName:2001" where hostName is the Web server machine, and click the "IBM Web Administration for iSeries link". </li> <li> Click the HTTP Servers tab, and in the dropdown box labelled "Server" select the web server instance from step 2. </li> <li> Click the "WebSphere Application Server" link in the left sidebar, then select the "WebSphere Application Server, V6.1" radio button. </li> <li> In the pulldown menu select the HTTP profile from step 1 and click OK. </li> </ol> (DOMINO) <ol> <li> Run the configureOs400WebServerDefinition script on the http profile from step 1, for example: configureOs400WebServerDefinition -profileName myHttpProfile -webserver.name DOMSRV01 -webserver.type DOMINO -webserver.port 80 </li> <li> Using the WRKDOMSVR command to update the notes.ini file of your Domino server, insert the following directive: WebSphereInit=http_profile_root/config/webServerName/plugin-cfg.xml </li> <li> From the Lotus Notes client connected to the Domino server, click the internet protocols tab and then click the HTTP tab. Under DSAPI filter names add the following: /QSYS.LIB/product_lib/LIBDOMINO.SRVPGM </li> <li> Save your changes and restart the Domino server. </li> </ol> </li> <li> Copy the script named http_profile_root/config/webServerName/configurewebServerName to the appserver_profile_root/bin directory on your application server machine using your favorite method, such as FTP or mapped drives. </li> <li> Start the application server and run the script you copied in the previous step. For example, run the following commands from Qshell: <ol> <li> appserver_profile_root/bin/startServer </li> <li> cd appserver_profile_root/bin </li> <li> ./configurewebServerName </li> </ol> </li> <li> (IHS) To enable automatic propagation of the plugin-cfg.xml file as well as other features, update the IHS Remote Administration Server's user ID and password in the Web server configuration: <ol> <li> Open the administrative console to your was profile on the application server machine. </li> <li> Expand Servers --> Web servers. </li> <li> Click on the Web server definition to view the details screen. </li> <li> Click the "Remote web server management" link. </li> <li> Enter the user ID and password to authenticate to the Web server machine. The authorities required by this profile are the same as that required to access the i5 WebAdmin GUI. </li> </ol> (DOMINO) Copy the plugin-cfg.xml from the application server machine to the http_profile_root/config/webServerName directory on the web server machine. The plugin-cfg.xml file is generated in the directory named appserver_profile_root/config/cells/cell_name/nodes/node_name/servers/webServerName on the application server machine. </li> </ol> </TD> </TR> </TABLE> <A HREF="javascript:showHideList('zOSWeb')"> <IMG SRC="/ibm/console/images/arrow_collapsed.gif" ALT="" ID="zOSWebImg" ALIGN="left" BORDER="0" style="margin-left:-0.25em"/> </A> zOS <TABLE id="zOSWebList" style="font-size:100%;margin-left:1em;display:none"> <TR> <TD> There is a Customization Dialog that queries for system information. After the information is collected, a series of jobs are generated along with a set of instructions. These instructions give information about each job and the order in which to run them. There is a job generated to configure the Web server plug-in that can be run at a specific time during the configuration process. <ol> <li> Perform the required customization steps in the article entitled, <a target="help" href="http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-nd-zos&topic=tins_configpostinstallz">Configuring the product after installation</a> within the information center. </li> <li> Submit the job to configure the Web server plug-in in the correct order based on the set of instructions that are generated. </li> </ol> </li> </TD> </TR> </TABLE> </li> To continue, click Next step. In WebSphere Application Server Administration Console, you can map an application or modules to the Web server after the application is installed or during application installation. <dl> <li> When the application is already installed, complete the following steps: <ol> <li>Click Click to perform to load the Applications collection panel</li>. <li>Click the name of the application to map to the Web server.</li> <li>On Modules, click Managed Modules. </li> <li>Select the appropriate Clusters and Servers from list, select the application module checkbox that you want targeted to those servers, and click on Apply.</li> <li>When you are finished targeting all of the application modules, click OK. <li>Click Click to perform to load the Applications collection panel</li>. <li>Click the name of the application that has been mapped to the Web server.</li> <li>On Detail Properties, click Target specific application status and you will see the Application server, cluster and Web server to which your application is targeted. </li> </ol> </li> <li>To map the application to the Web server during application installation, select the appropriate Cluster and Servers during the Manage Modules step. </li> select the application module checkbox that you want targeted to those servers,, and click on apply.</li> </dl> To continue, click Next step. Click Save in the message at the top of the console panel to update the configuration in the master repository. To continue, click Next step. The Web server plug-in configuration service monitors the changes to the product configuration and regenerates the plug-in file automatically when changes are made that affect the plug-in. This service is enabled by default so typically you can skip this step. <A HREF="javascript:showHideList('pluginserviceconditions')"> <IMG SRC="/ibm/console/images/arrow_collapsed.gif" ALT="" ID="pluginserviceconditionsImg" ALIGN="left" BORDER="0"/> </A> When does the plug-in configuration service regenerate the plugin? <TABLE id="pluginserviceconditionsList" style="font-size:100%;margin-left:1em;display:none"> <TR> <TD> When the Web server plug-in configuration service is enabled and any of the following conditions occur, the plug-in configuration file is automatically generated: <dl> <li>When the Web server is created or saved</li> <li>When an application is installed</li> <li>When an application is uninstalled </li> <li>When the virtual host definition is updated </li> </dl> </TD> </TR> </TABLE> <A HREF="javascript:showHideList('pluginserviceenabled')"> <IMG SRC="/ibm/console/images/arrow_collapsed.gif" ALT="" ID="pluginserviceenabledImg" ALIGN="left" BORDER="0"/> </A> Should I keep the plug-in configuration service enabled or should I disable it? <TABLE id="pluginserviceenabledList" style="font-size:100%;margin-left:1em;display:none"> <TR> <TD> Consider enabling this service if any of the following conditions apply: <dl> <li>You expect infrequent application installation or uninstallation. For example, this situation might apply in a production environment.</li> <li>You can tolerate the performance impact of generating and distributing the plug-in configuration file each time any of the previously mentioned conditions occur.</li> </dl> If you are making a series of simultaneous changes such as installing numerous applications, then you might want the configuration service disabled until you make the last change. To disable the service, click Application Servers > {server name} > Administration Services > Web server plug-in configuration service and uncheck the option Enable automated Web server configuration processing. </TD> </TR> </TABLE> To manually generate the plug-in file <ol> <li>Click Click to perform to load the Web servers collection panel.</li> <li>Select the Web server from the list. </li> <li>Click Generate Plug-in.</li> </ol> To continue, click Next step. The plug-in configuration file (<code>plugin-cfg.xml</code>) can be automatically propagated to the Web server when the Web server plug-in configuration service is enabled and if one of the following conditions is true: <dl> <li>You are using a local Web server, that is, there is an Application Server on the same computer as the Web server.</li> <li>You are using a remote IBM HTTP Server (IHS), Version 6 or higher, with a running IHS administrative server.</li> </dl> In this guided activity, the assumption is that the Web server is remote. Therefore, if the Web server is not an IBM HTTP Server (IHS), Version 6 or higher, you must manually copy the <code>plugin-cfg.xml</code> file to the install location for the remote Web server. To propagate the plug-in file <ol> <li>Create a user ID and password for IHS Admin Server. This user ID and password is used by Websphere Application Server to remotely administer the Web server. To create a user ID and password in the <code>IHS_HOME\conf\admin.passwd</code> file, run the following command: <code>IHS_HOME\bin\htpasswd -cb IHS_HOME\conf\admin.passwd adminUser adminPassword</code>, where adminUser is a system user ID and adminPassword is the adminUser password. </li> <li>Start the IHS Admin Server. On Windows start the 'IBM HTTP Administration 6.1' service on the IHS machine. On Linux or UNIX, run the following command: <code>IHS_HOME/bin/adminctl start</code>. </li> <li>Click Click to perform to load the Web servers collection panel.</li> <li>Select the name of your Web server and click the link Remote Web server management. </li> <li>Enter the Port as 8008, User ID as the adminUser from the previous instruction and Password as the adminPassword from the previous instruction.</li> <li>Click Apply and then save your changes.</li> <li>Set the correct read/write permissions for the httpd.conf file and the plugin-cfg.xml file on the web server machine.</li> <li>Click Click to perform to load the Web servers collection panel again.</li> <li>Check the box next to the Web server name and then click Propagate Plug-in.</li> To continue, click Next step. Open a browser and enter the URL for the snoop servlet (for example, http://Host_name_of_Web_server_machine/snoop) to verify the ability of the Web server to retrieve an application from the Application Server. If the above test is not successful, see the information center article entitled, <a target="help" href="http://www14.software.ibm.com/webapp/wsbroker/redirect?version=phil&product=was-nd-dist&topic=tins_webplugins">Troubleshooting Web server plug-ins installation and removal</a> for more information.