Wed, May
2 New Articles

Configuring the HTTP Server (Powered by Apache)

  • Smaller Small Medium Big Bigger
  • Default Helvetica Segoe Georgia Times

Deciphering how to configure a Web server to meet your needs can seem like a daunting task. And, when faced with a new HTTP server that provides a rich set of highly configurable features, knowing where to start can be quite a challenge. To make that challenge more manageable, IBM’s latest incarnation of the HTTP Server (powered by Apache) for iSeries simplifies the approach to Web server configuration. A new wizard guides you through the common steps for configuring a new Web server in an understandable and repeatable manner! Let me take you on a guided tour that shows you how to create, configure, and use your first Apache server.

The HTTP Server (powered by Apache) requires special software and authorities. In OS/400 Version 4 Release 5, the HTTP Server (product ID 5769-DG1) must be installed on your system. You must also order a new group PTF and make sure the Java Virtual Machine (JVM) 1.2 and the Java Developer Kit (JDK) are installed on the system. The IBM HTTP Server Documentation Center (www.iseries.ibm.com/products/http/docs/v4r5) provides you with all the information you need to get started. In the documentation center, click on the HTTP Server (powered by Apache) section to view the set of articles specifically for Apache. Read and follow the instructions in these articles: “Installing the server,” “Testing the installation,” and “Configuring a new server.” The “Configuring a new server” article will tell you to start two administration servers. In V4R5, the Web pages for configuring Apache require a second administration server called ADMINA. The article concludes by guiding you to the administration Web page, where new Apache servers can be created (see Figure 1). This is where our journey will begin.


Configuring Your First Apache Server


If you have experience creating original HTTP servers, you’ll find creating Apache servers much easier. To begin, click on Create HTTP Servers to start a wizard that will walk you through a series of Web pages. Each page in the series will provide brief information and will ask you to answer a question. The objective of the wizard is to prompt you for the necessary information required to easily get a basic Apache server configured with common server functions. Your path through the wizard will vary depending on how you answer the questions. The questions are straightforward, but I’ll walk you through them while you




create your first Apache server. (Note: Click Next to advance to the next question. No server is created until you arrive at the last question and click Finish. Until then, you can use the Back button to go back to previous questions and answer them differently, if desired.)

1. The first Web page asks which type of HTTP server you want to create. Although the recommended type is Apache, you can use the wizard to create original servers as well. Select HTTP Server (powered by Apache).

2. You are asked for the name you would like to give your HTTP server. Choose a name that uniquely identifies the server and that reflects what the server will be used for. In the future, you will use the name to identify the server you want to configure. Customers of your Web site will not know or use this name. For this example, type TRYAPACHE as the name for your Apache server.

3. The next question asks whether you want your new Apache server configured just like an existing server. This is a handy feature of the wizard, because it can save you time if you require more than one server configured in a similar way (such as a test versus production server). If you answer No, the remaining questions will step you through the basic configuration setup. If you answer Yes, you have the chance to migrate the configuration of an existing original HTTP server and have that equivalent configuration used by the new Apache server. Converting or migrating original HTTP server configurations to Apache is an advanced task that requires its own separate discussion. Answer No to continue.

4. You will need to specify a parent directory where you want your server’s configuration and logging information stored. This is referred to as your server root. A default of /www/tryapache is displayed for your consideration. Use the default directory shown.

5. A document root needs to be specified next. The document root is the directory that contains or will contain the documents or Web pages to be served by your Apache server. A default directory of /www/tryapache/htdocs is provided. Use the default directory shown and continue to the next page.

6. The HTTP server must be told which of the IP addresses on the iSeries system to look for HTTP requests on. For this server, pick all IP addresses. A unique port number must be used by each server application that runs concurrently on the system. The port tells the system which server application handles the requests coming in on that port. If you don’t already have an HTTP server running on port 80, use 80, which is the preselected default. Otherwise, pick a unique port that is not being used on your system. To see the ports currently in use on your system, enter the command NETSTAT OPTION(*CNN) and press F14 to display the port numbers. Browse the numbers in the Local Port column to verify that the number you want to use is not already taken.

7. Most Web sites keep an audit trail of what their HTTP server is doing. Configuring your Apache server to log every request made to the server allows you to know which Web pages are being accessed via your server and which users are accessing those pages. To answer the question on the Web page, select Combined log file, which will enable both access and error logging.

8. After clicking Next, you will be presented with a summary of the initial configuration for your Apache server (see Figure 2). At this point, you must click the Finish button in order to actually create the Apache server. That’s all there is to creating and configuring your first Apache server.


Starting Your Apache Server


You are now ready to use your new Apache server! The final information shown by the wizard directs you to your next step. You can start your server and use it to view your documents in your Web browser, or you can continue to configure your Apache server by using the configuration forms to enable more advanced features. Continue by choosing the Manage button. Find your server in the list (it should already be preselected), then click Start. After the list of servers refreshes, it will show that your server has a status of running. To test that your new Apache server is functioning, enter http://myhostname:port/ in your Web browser where myhostname is the name that identifies your iSeries system (not your Apache server name), and port is the port number you selected for your Apache server. A default welcome page is displayed (this page was copied to your document root directory when your server was created by the wizard).


Continuing Your Journey


We’ve just touched the surface of what is possible for HTTP server configuration for Apache. The Configuration page has all the forms you’ll need to continue configuring your TRYAPACHE server, such as enabling features like directory browsing, document caching, or running CGI programs. Wizards are available for configuring more complex or advanced features. Because the Apache server is more highly configurable than the original HTTP server, focus on learning and configuring one feature at a time. I recommend you enable other features and then test the server to ensure it is working as you expect it to.


Finding More Information


If you have difficulties or see unexpected results when using your Apache server, read the IBM HTTP Server for iSeries home page (www.iseries.ibm.com/products/http/ httpindex.htm) for information on the latest fixes, known problems, and workarounds. I would also suggest browsing the Concepts section in the HTTP Server Documentation Center to learn Apache-specific terminology and the Configuring section to learn more details about the features of the Apache server on iSeries.

If you want to learn more about the technical details behind an Apache server configuration, you may be interested in looking at the raw configuration. To view the entire configuration you have just created, click Display Configuration File on the Configuration page. Each line contains a directive name and one or more values. At the beginning, don’t worry about knowing and understanding the directives themselves. Use the Web-based forms to manage and configure your servers. Knowing the directives is not necessary for successfully configuring and managing basic Apache servers. Once you are ready for a more in-depth view of directives, the Reference section in the HTTP Server Documentation Center shows the list of supported directives, along with detailed descriptions and examples for HTTP servers powered by Apache on iSeries.


What Next?


Once you are comfortable with creating, configuring, and using Apache servers on iSeries, the next step for many of you will be to migrate your existing original HTTP servers to Apache. The knowledge you gain from practicing will be of great use when configuring an Apache HTTP server on iSeries for real production use.




• IBM HTTP Server Documentation Center: www.iseries.ibm.com/products/http/docs/v4r5
• IBM HTTP Server for iSeries home page: www.iseries.ibm.com/products/http/ httpindex.htm


Configuring_the_HTTP_Server_(_Powered_by_Apache)04-00.png 494x401


Figure 1: This is the new interface for configuring both original and Apache servers.

Figure 2: Here’s a summary of your initial Apache server configuration.


Configuring_the_HTTP_Server_(_Powered_by_Apache)04-01.png 494x405




Support MC Press Online

$0.00 Raised:

Book Reviews

Resource Center

  • SB Profound WC 5536 Have you been wondering about Node.js? Our free Node.js Webinar Series takes you from total beginner to creating a fully-functional IBM i Node.js business application. You can find Part 1 here. In Part 2 of our free Node.js Webinar Series, Brian May teaches you the different tooling options available for writing code, debugging, and using Git for version control. Brian will briefly discuss the different tools available, and demonstrate his preferred setup for Node development on IBM i or any platform. Attend this webinar to learn:

  • SB Profound WP 5539More than ever, there is a demand for IT to deliver innovation. Your IBM i has been an essential part of your business operations for years. However, your organization may struggle to maintain the current system and implement new projects. The thousands of customers we've worked with and surveyed state that expectations regarding the digital footprint and vision of the company are not aligned with the current IT environment.

  • SB HelpSystems ROBOT Generic IBM announced the E1080 servers using the latest Power10 processor in September 2021. The most powerful processor from IBM to date, Power10 is designed to handle the demands of doing business in today’s high-tech atmosphere, including running cloud applications, supporting big data, and managing AI workloads. But what does Power10 mean for your data center? In this recorded webinar, IBMers Dan Sundt and Dylan Boday join IBM Power Champion Tom Huntington for a discussion on why Power10 technology is the right strategic investment if you run IBM i, AIX, or Linux. In this action-packed hour, Tom will share trends from the IBM i and AIX user communities while Dan and Dylan dive into the tech specs for key hardware, including:

  • Magic MarkTRY the one package that solves all your document design and printing challenges on all your platforms. Produce bar code labels, electronic forms, ad hoc reports, and RFID tags – without programming! MarkMagic is the only document design and print solution that combines report writing, WYSIWYG label and forms design, and conditional printing in one integrated product. Make sure your data survives when catastrophe hits. Request your trial now!  Request Now.

  • SB HelpSystems ROBOT GenericForms of ransomware has been around for over 30 years, and with more and more organizations suffering attacks each year, it continues to endure. What has made ransomware such a durable threat and what is the best way to combat it? In order to prevent ransomware, organizations must first understand how it works.

  • SB HelpSystems ROBOT GenericIT security is a top priority for businesses around the world, but most IBM i pros don’t know where to begin—and most cybersecurity experts don’t know IBM i. In this session, Robin Tatam explores the business impact of lax IBM i security, the top vulnerabilities putting IBM i at risk, and the steps you can take to protect your organization. If you’re looking to avoid unexpected downtime or corrupted data, you don’t want to miss this session.

  • SB HelpSystems ROBOT GenericCan you trust all of your users all of the time? A typical end user receives 16 malicious emails each month, but only 17 percent of these phishing campaigns are reported to IT. Once an attack is underway, most organizations won’t discover the breach until six months later. A staggering amount of damage can occur in that time. Despite these risks, 93 percent of organizations are leaving their IBM i systems vulnerable to cybercrime. In this on-demand webinar, IBM i security experts Robin Tatam and Sandi Moore will reveal:

  • FORTRA Disaster protection is vital to every business. Yet, it often consists of patched together procedures that are prone to error. From automatic backups to data encryption to media management, Robot automates the routine (yet often complex) tasks of iSeries backup and recovery, saving you time and money and making the process safer and more reliable. Automate your backups with the Robot Backup and Recovery Solution. Key features include:

  • FORTRAManaging messages on your IBM i can be more than a full-time job if you have to do it manually. Messages need a response and resources must be monitored—often over multiple systems and across platforms. How can you be sure you won’t miss important system events? Automate your message center with the Robot Message Management Solution. Key features include:

  • FORTRAThe thought of printing, distributing, and storing iSeries reports manually may reduce you to tears. Paper and labor costs associated with report generation can spiral out of control. Mountains of paper threaten to swamp your files. Robot automates report bursting, distribution, bundling, and archiving, and offers secure, selective online report viewing. Manage your reports with the Robot Report Management Solution. Key features include:

  • FORTRAFor over 30 years, Robot has been a leader in systems management for IBM i. With batch job creation and scheduling at its core, the Robot Job Scheduling Solution reduces the opportunity for human error and helps you maintain service levels, automating even the biggest, most complex runbooks. Manage your job schedule with the Robot Job Scheduling Solution. Key features include:

  • LANSA Business users want new applications now. Market and regulatory pressures require faster application updates and delivery into production. Your IBM i developers may be approaching retirement, and you see no sure way to fill their positions with experienced developers. In addition, you may be caught between maintaining your existing applications and the uncertainty of moving to something new.

  • LANSAWhen it comes to creating your business applications, there are hundreds of coding platforms and programming languages to choose from. These options range from very complex traditional programming languages to Low-Code platforms where sometimes no traditional coding experience is needed. Download our whitepaper, The Power of Writing Code in a Low-Code Solution, and:

  • LANSASupply Chain is becoming increasingly complex and unpredictable. From raw materials for manufacturing to food supply chains, the journey from source to production to delivery to consumers is marred with inefficiencies, manual processes, shortages, recalls, counterfeits, and scandals. In this webinar, we discuss how:

  • The MC Resource Centers bring you the widest selection of white papers, trial software, and on-demand webcasts for you to choose from. >> Review the list of White Papers, Trial Software or On-Demand Webcast at the MC Press Resource Center. >> Add the items to yru Cart and complet he checkout process and submit

  • Profound Logic Have you been wondering about Node.js? Our free Node.js Webinar Series takes you from total beginner to creating a fully-functional IBM i Node.js business application.

  • SB Profound WC 5536Join us for this hour-long webcast that will explore:

  • Fortra IT managers hoping to find new IBM i talent are discovering that the pool of experienced RPG programmers and operators or administrators with intimate knowledge of the operating system and the applications that run on it is small. This begs the question: How will you manage the platform that supports such a big part of your business? This guide offers strategies and software suggestions to help you plan IT staffing and resources and smooth the transition after your AS/400 talent retires. Read on to learn: