Setting up WebSphere Application Server for publishing

The server tools feature allows you to publish projects on a separate local or remote installation of WebSphere Application Server.

To set up WebSphere Application Server locally or remotely, follow these steps:

1. Install WebSphere Application Server on the local or remote machine where you want to publish your project.
   Important: It is recommended that you install WebSphere Application Server before you install Agent Controller.

2. Install Agent Controller on the same machine as WebSphere Application Server. Agent Controller is included with most configurations of this product. Follow the instructions in the installation guide for this product. Agent Controller is covered elsewhere in the documentation

3. If you installed Agent Controller before installing WebSphere Application Server, the WebSphere Application Server installation directory may need to be defined in the Agent Controller configuration file.
   1. Open the pluginconfig.xml file, under the directory x:\plugins\com.ibm.etools.websphere.tools\config, where x is the directory where Agent Controller is installed.

   2. Find the following section:

      <AgentControllerEnvironment configuration="default"> 
      
      <Variable name="WAS_HOME_V4" value="%WAS_HOME_V4%" position="replace"/> 
      
      <Variable name="WAS_HOME_V5" value="%WAS_HOME_V5%" position="replace"/>
      
      <Variable name="WAS_HOME_V51" value="%WAS_HOME_V51%" position="replace"/>
      
       </AgentControllerEnvironment>

   3. If the target server is WebSphere Application Server v4 (used for backward compatibility purposes only), check the value of the system environment variable WAS_HOME_V4 to determine whether it is set to the directory where the application server is installed, for example C:\Program Files\WebSphere\AppServer. If the system environment variable is not set, then change the value of the WAS_HOME_V4 variable in this pluginconfig.xml file from %WAS_HOME_V4% to the name of the directory where the application server is installed.

   4. If the target server is WebSphere Application Server v5.0, change the value of the WAS_HOME_V5 variable in this file from %WAS_HOME_V5% to the name of the directory where the application server is installed. After WebSphere Application Server is reinstalled on a different location, the above variables must be updated with the correct path.

   5. If the target server is WebSphere Application Server v5.1, change the value of the WAS_HOME_V51 variable in this file from %WAS_HOME_V51% to the name of the directory where the application server is installed. After WebSphere Application Server is reinstalled on a different location, the above variables must be updated with the correct path.

   6. Save your changes and restart Agent Controller.

      Note: If you reinstall WebSphere Application Server in a different location later, remember to update the pluginconfig.xml file and restart Agent Controller for the changes to take place.

4. Start Agent Controller on the remote machine. For more information on how to start and stop the Agent Controller, refer to the Agent Controller online documentation.

5. If you are using an FTP server, then ensure that it is started.

 

Parent topic

Publishing projects to a WebSphere Application Server v5.x