The WebFacing server acts as a gateway between WebSphere® Application Server
and your original IBM® i application. The WebFacing server
will listen on a predefined TCP port to exchange data with WebFacing
applications (Web or portlet). All WebFacing applications connecting
to the server on the same IBM i need to be configured to connect to
the assigned TCP port. By default, the server listens on port 4004.
This value can be changed using the IBM i WKSRVTBLE command to
modify the TCP service as-WebFacing. If you have changed the port
WebFacing server listens to on your IBM i server (see Changing the port used by the WebFacing server), you will need to change the
port used by your WebFacing applications so your WebFacing applications
will work properly with the new port.
Changing the WebFacing
port number defined in your WebFacing projects
The port
number used by a WebFacing application to communicate with the WebFacing
server can be changed for the project as a whole or for individual
CL commands. Ports defined for CL commands take precedence over the
port defined for your project. Each CL command that your application
uses will have a separate link for it in the index.jsp file that is
created by the WebFacing conversion. If necessary, you can define
a different host and associated port for each link. One reason for
defining CL commands that use different hosts or ports is if you have
a WebFacing project that accesses applications on more than one server.
Port changes for your project or CL commands are stored in the deployment
descriptor file web.xml.
Note: If you are changing a port setting
used by a project that has already been deployed, generally, you must
re-deploy and then restart the application in the WebSphere Administrative Console. Alternatively,
you can search for the IFS location on your IBM i server where your WebFacing
Web application's web.xml file is installed and redeploy from the
workbench just that one file. This alternative method still requires
a restart of the application. However, it can be a convenient method
of changing the ID and password if your application is large.
Changing
the port for your project
- Open the IDE and select the WebFacing Projects tab.
- Access the properties page for your project. Select and right-click
the icon for the WebFacing project whose port you would like to change
and then select Properties. The Properties
page opens.
- Open the section of the properties
page.
- Click the Change button next to the Host
port field.
- Click Edit in the Host Selection dialog
to change the Host port. Click OK when finished.
Changes are saved to the web.xml file.
Changing the port for a CL command
- Open the IDE and select the WebFacing Projects tab.
- Access the properties page for your project. Select and right-click
the icon for the WebFacing project whose port you would like to change
and then select Properties. The Properties
page opens.
- Open the section of the properties
page.
- Click the label for the CL command that you want to work with.
- Select the check box for Override project
settings with this command.
- Click the Change button next to the Host
port field.
- Click Edit in the Host Selection dialog
to change the Host port. Click OK when finished.
Changes are saved to the web.xml file.