Troubleshooting
Problem
Once an Integrated Application Server has been created on the IBM i, the logical next step is to install a Java application to it. This guide will help any user get there.
Note: Integrated Application Servers on IBM i are designed to work with a .WAR file. Other Java web application file types are not compatible for this process.
Environment
IBM i 7.3 and later
Resolving The Problem
You are in: IBM i Technology Updates > Navigator for i > Documentation on Functional Areas > Install an Application
Open Navigator for i and from the side menu go to Network > Web Administration > Application Servers
👁 Screenshot of opening application servers table from side menu
From here, select the Application Server where the application should be installed, right click it and select Manage Applications.
Note: Applications should only be installed to servers created by users. They can't be installed to the IBM provided application servers. For help creating a new Application Server with Navigator for i, read Create an Application Server using Navigator for i.
👁 Screenshot of user selecting "Manage Applications" from right click menu on Application Servers table
This will bring you to the Applications table for the specified server. The title at the top serves as a reminder for what server was selected when opening the table.
From here, select Actions > Install new Application
👁 Screenshot of user selecting "Install New Application" from actions menu in Applications table
This action opens the Install Application wizard. On the first step, enter the path to the .WAR file through the IFS, the other fields will be filled out with default values relevant to the filename.
👁 Screenshot of first step of Install Application wizard - user filled out all fields by using the browse button
The second step is the summary. This step allows users to review their selections before submitting. Click Finish to complete the wizard and install the application
👁 Screenshot of summary page showing all info specified in last step
In the event that an error was made when installing the application, Navigator for i provides 2 options to rectify issues.
A) Application Properties - Right click the problematic application and click Properties. Navigator for i gives more options than Web Admin GUI did in the past for editing existing applications, most problems can be resolved through this dialog.
👁 Screenshot of properties dialog for applications
B) Uninstall Application - Right click the problematic application and click the Uninstall Application option
Related Information
[{"Type":"MASTER","Line of Business":{"code":"LOB68","label":"Power HW"},"Business Unit":{"code":"BU070","label":"IBM Infrastructure"},"Product":{"code":"SWG60","label":"IBM i"},"ARM Category":[{"code":"a8m0z0000000CH1AAM","label":"IBM Navigator for i"}],"ARM Case Number":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"All Versions"}]
Was this topic helpful?
Document Information
Modified date:
20 February 2026
UID
ibm17261339