Verify available ports for Zend Server for IBM i

Follow

Issue

The Zend Server Apache instance on IBM i requires three ports.  They are 10080, 10081, and 10083.  These ports should not be in use by any other process during the installation and operation of Zend Server for IBM i.  This article tells how to check to see if these ports are in use.

Environment

Version 6 or higher of Zend Server for IBM i, running on any supported version of IBM i.

Resolution

Use the NETSTAT command to see which ports are in use.

Note: NETSTAT can only tell which ports are in use by active processes.
This procedure will only tell you if any of the required ports are in use while you are looking.  Some jobs that use these ports may run at other times.  It is a good idea to use NETSTAT just prior to installing Zend Server for IBM i to make sure the ports are available at install time.  It is also useful to check for problems with port conflicts in cases where, for instance, the ZENDSVR6 Apache instance will not start.

Please log in to a 5250 session using a *SECOFR class user profile.  From the command line:

NETSTAT *CNN

This will bring up the "Work with IPv4 Connection Status" display.  We are interested in looking at the Local Port.  Notice that on this display, some of the Local Ports are numbers, and some are text. 

Please use F14 so that all Local Ports are displayed as numbers.

Now, use F13 to set the sort order to Local Port.  F13 brings up the "Select Column to Sort" pop up window.  Find "Local Port"on the list of Column Titles (it is in the third row), and give it a '1'.  Press enter to save the selection.

You should now be back in the "Work with IPv4 Connection Status" display, sorted by Local Port, with all ports displayed as a number.

Now, please Page Down until the Local ports displayed include the range 10080 to 10083.

If Zend Server is not installed, or the ZENDSVR6 Apache instance is not active, ports 10080, 10081, and 10083 should not be displayed.  In this example, nothing is displayed between Local Ports 8479 and 11279:

Remote           Remote  Local                        
Address           Port    Port  Idle Time  State      
*                     *   8474  +++++++++  Listen     
*                     *   8475  138:42:12  Listen     
*                     *   8476  138:42:29  Listen     
*                     *   8477  +++++++++  Listen     
*                     *   8478  +++++++++  Listen     
*                     *   8479  +++++++++  Listen     
*                     *  11279  +++++++++  Listen     
127.0.0.1         62271  12887  +++++++++  Closed     
127.0.0.1          8473  13959  000:30:37  Established
127.0.0.1         17463  24255  +++++++++  Closed     
127.0.0.1         38239  52598  +++++++++  Closed     
127.0.0.1         23919  54687  +++++++++  Closed    

This indicates ports 10080, 10081, and 10083 are available.  If Zend Server for IBM i is not installed, it should be safe to install it.  If Zend Server for IBM i is installed, this would indicate that the ZENDSVR6 Apache instance is not active.

This next example shows how the display might look if the ZENDSVR6 Apache instance is active:

Remote           Remote  Local                        
Address           Port    Port  Idle Time  State      
*                     *   8477  +++++++++  Listen     
*                     *   8478  +++++++++  Listen     
*                     *   8479  +++++++++  Listen     
*                     *  10080  000:01:02  Listen     
*                     *  10081  000:01:02  Listen     
*                     *  10083  000:00:11  Listen     
127.0.0.1         21253  10083  000:00:43  Time-wait  
127.0.0.1         30218  10083  000:00:43  Time-wait 
127.0.0.1         40637  10083  000:00:11  Time-wait
127.0.0.1         58862  10083  000:00:11  Time-wait
*                     *  11279  +++++++++  Listen   
127.0.0.1         62271  12887  +++++++++  Closed  

Notice the first three entries for the ports do not have a Remote Address specified, but just show an asterisk.  If you use option 8 on any of these three, you should see a bunch of ZENDSVR6 jobs on the "Display Jobs Using Connection" display.  The additional entries we see for Local Port 10083 showing a Remote Address of 127.0.0.1 are very temporary, and it is often not possible to enter an option 8 for them before the job is finished.  If you do get into the "Display Jobs Using Connection" display for one of these, it will likely show "(No jobs)", which is normal when this port is used by Zend Server.  This indicates the process using the port is not associated with a job.

Note: Some customers will change one or more of the default Zend Server ports.
We do not recommend this, but sometimes a customer will change a port.  In this case, we expect the customer will know which ports should be active when the ZENDSVR6 instance is active.  For new or clean installations, the default ports must be available, as they are used during the installation.  Port changes can only be done after the software is successfully installed.

 

Have more questions? Submit a request

Comments

Powered by Zendesk