Deploying iSeries Web applications

Deploying iSeries Web applications involves:
  1. Defining the run-time environment
  2. Exporting the enterprise archive (EAR) file to an iSeries host
  3. Installing the EAR file on the WebSphere Application Server
  4. Launching the application in a browser

Complete the steps as follows:

  1. Defining the run-time environment

    Run the iSeries Web Tools Run-time Configuration wizard to define the iSeries host and run-time libraries that your application will use in the production environment. See Configuring your iSeries run time for a description of the steps required to do this.

  2. Exporting the EAR file to an iSeries host

    The EAR file that is exported is the EAR file you specified when you created the Web project.

    Note: Item d in the following instructions assumes that you have mapped a network drive on your PC to an iSeries system. For information about mapping network drives, see Mapping a network drive to the iSeries system in the Prerequisites section in Product overview.
    1. In the Web perspective, expand the Enterprise Applications folder.
    2. Select the EAR file you want to export and select File > Export.
    3. In the Export window, select EAR file and click Next. The EAR file name appears in the EAR project field.
    4. For the field Destination, choose a temp directory within the IFS on the iSeries host. The temp directory is typically a temp folder in your instance name in the IFS.
    5. Click Finish to copy the EAR file to the destination on the iSeries host.
  3. Installing the EAR file on the WebSphere Application Server

    The following instructions pertain to installing the EAR file on the WebSphere Application Server V5 or later. For further information about the prerequisites for doing this, view the Prerequisites section in Product overview.

    1. Start the browser-based WebSphere Application Server Administration Console (the graphical interface to the WebSphere administrative environment). For example, use the following format for the URL:http://myhost:port/admin/ where myhost is the name of your iSeries host and port is the port number for the administration console. For WebSphere Application Server V6, the default port is 9060. For WebSphere Application Server V5, the default port is 9090.
    2. Click Applications > Install New Application in the navigation frame.
    3. Select Local path on the Preparing for the application installation page, browse to locate and select the EAR file in your temp directory.
    4. Click Next until you reach Install New Application, complete any of the fields that you require, and click Next.
    5. On the Map virtual hosts for web modules page, select the Web module that corresponds to your EAR file, click Select Virtual Host to open a list of available virtual hosts, select the virtual host that you want to use with your Web module, and click Next.
    6. On the Map modules to application servers page, select the Web module that corresponds to your EAR file.
    7. Click Next to view a summary of the installation specifications, and click Finish to install the EAR file.
    8. Follow the instructions on the page for saving changes to the master configuration.
    9. In the navigation frame, click Applications > Enterprise Applications to open the page where you can start your application.
    10. On the page that lists the enterprise applications, check the box for your application and click Start.
  4. Launching the application in a browser
    1. After you start your application, it can be accessed through a browser with an address in the form: http://host_name:<port>/<context_root>/ For example, if your server is PROD400, your port is 12055, and the Context root value that you entered while creating the Web project is myproj, then you would access the application with an address like: http://PROD400:12055/myproj/name.jsp.