documentation
.HELP!
Installing LANSA on IBM i Documentation
Do I need a license for Open System Utilities
Installing LANSA on IBM i
previous page
next page
Do I need a license for Open System Utilities?
You do not require a license to use the Open System Utilities.
previous page
start
next page
Menu
Homepage
Table of contents
Installing LANSA on IBM i
About this Guide
Who should use this Guide
How to use this Guide
Additional Information
1. Start Here
1.1 Overview of Install Process
1.1.1 Upgrade LANSA on IBMi
1.1.2 Upgrade Web Server Only
1.1.3 Typical LANSA for i Installation
1.1.4 LANSA for i Only Installation
1.1.5 Single-tier LANSA for the Web Installation
1.1.6 Single-tier LANSA for the Web Installation (LANSA for i Installed)
1.1.7 Multi-tier LANSA for the Web Installation
1.1.8 Multi-tier LANSA for the Web Installation (LANSA for i Installed)
1.1.9 LANSA Integrator Installation
1.1.10 Open System Utilities Installation
1.1.11 Set up LANSA Open on IBM i
1.1.12 Set up LANSA Client on IBM i
2. Planning a New Installation on IBM i
2.1 Summary of LANSA IBM i Software Options
2.1.1 LANSA IBM i Software DVD
2.1.2 Typical LANSA for IBM i Installation
2.1.3 Custom LANSA for i Installations
2.1.4 LANSA Integrator Installation
2.1.5 Upgrade LANSA for i Installations
2.1.6 LANSA for the Web on IBM i
Web Single-tier model Considerations
Web Multi-tier Model Considerations
2.2 Requirements Checklist
2.2.1 Skills Requirements
2.2.2 IBM i System Requirements
2.2.3 General Installation/Upgrade Requirements Checklist
2.2.4 LANSA for the Web Requirements
2.2.5 LANSA Integrator IBM i Requirements
2.2.6 Open System Utilities IBM i Requirements
2.3 Frequently Asked Questions
2.3.1 General Questions
Should I Use the Typical or Custom Installation?
Do I have to install all products at the same time?
Do I have to use Partition Initialization?
How long will the installation or upgrade take?
When is a good time to install LANSA software?
Can developers or users be using the system during the upgrade?
Where can I find more information about installation and configuration?
Is this version compatible with previous versions?
2.3.2 LANSA for i Questions
How can I determine the name of the IBM i LANSA program library?
Can I install more than one LANSA System on the same IBM i?
2.3.3 LANSA for the Web Questions
What IBM i Web Server should I use?
How much Web security do I need?
2.3.4 LANSA Integrator Questions
Can I have multiple LANSA Integrator systems installed?
What license do I need?
Do I need LANSA for i installed to use LANSA Integrator?
2.3.5 Open System Utilities Questions
Should I install the Open System Utilities?
Do I need a license for Open System Utilities?
3. Install LANSA on IBM i
3.1 Task: Typical Installation
3.1.1 Before You Begin Checklist
3.1.2 Call the Installation Program
3.1.3 Typical Installation Summary
3.1.4 Verify Typical Installation
3.2 Task: Custom Installation
3.2.1 Before You Begin Checklist
3.2.2 Call the Installation Program
3.2.3 Select Software Components
The IBM i Parameters (1)
The IBM i Parameters (2)
Partition Initialization
Create New Partition
LANSA for the Web - Parameters
The Web - CGI, Host & Client CCSID library parameters
LANSA Integrator Parameters
Open System Utilities Installation Library
The Web Server Only - Parameters
CGI, Host & Client CCSID parameters - Web Server Only
3.2.4 Check the Custom Installation Summary
3.2.5 Verify the Custom Installation
4. Upgrade LANSA on IBM i
4.1 Task: Upgrade an Existing LANSA for i System
4.1.1 Before You Begin Checklist
4.1.2 Special Warnings
4.1.3 LANSA Integrator Special Warnings
4.1.4 Start the Upgrade process
4.1.5 Select the LANSA system to be upgraded
4.1.6 Partition Initialization
Select Options to be upgraded
4.1.7 Confirm your Selected Options
4.1.8 Verify the Upgrade
Verify Integrator Upgrade
4.2 Task: Upgrade an Existing LANSA for the Web - Web Server ONLY on IBM i
4.2.1 Before You Begin Checklist
4.2.2 Start the Web Server upgrade
4.2.3 Select the Web Server to be upgraded
4.2.4 Start the Upgrade Process
4.2.5 Verify the Upgrade
4.3 Upgrade LANSA Windows Software
4.4 LANSA Communications Library
4.4.1 Change from QGPL to a LANSA Communications Library
4.4.2 Remove old Loader Objects from QGPL
4.5 Initialization Imports
4.5.1 Imports with the LANSA IBM i Software
4.5.2 Multilingual Imports into Non-Multilingual Partitions
5. LANSA IBM i License
5.1 LANSA License Categories
5.2 General Licensing Considerations
5.3 Task: Enter the LANSA License Code
5.3.1 Before You Begin Checklist
5.3.2 Step 1. Sign on and Execute LANSA License Program
5.3.3 Step 2. Apply Permanent License Codes
5.4 Request a LANSA Product License
5.5 License Code List
5.6 Maintenance Contract
6. LANSA for the Web Configuration and Set Up on IBM i
6.1 Task: Install LANSA for the Web Administrator
6.2 Task: Configure IBM i Web Server (powered by Apache)
6.3 Task: Configure Multi-tier IBM i LANSA for the Web Installation
6.3.1 Configure LANSA for the Web on a Multi-tier IBM i Web Server
Before You Begin Checklist
Step 1. Execute W3@P2901
Step 2. Work with Communication Routing on IBM i
Step 3. Add Routing Record on IBM i
Step 4. Configure IBM i Web Server
Step 5. Maintain System Information on IBM i Web Server
Step 6. Add New System Information on IBM i Web Server
Other Considerations for Multi-tier Installations
6.3.2 Configure IBM i Web Server for Communications with IBM i Data/Application Server
Before You Begin Checklist
Step 1. Sign On to IBM i Web Server
Step 2. Create LANSAWORK Job Queue
Step 3. Create LANSAWORK Subsystem Description
Step 4. Create LANSAWORK Job Description
Step 5. Add a LANSAWORK Job Queue Entry
Step 6. Add a LANSAWORK Auto Start Job Entry
Step 7. Create the LANSAWORK Class
Step 8. Add a LANSAWORK Routing Entry
Step 9. Add a Second LANSAWORK Routing Entry
Step 10. Start the LANSAWORK Subsystem
Step 11. Verify LANSAWORK Subsystem is Active
6.4 Task: Upgrade from a Single-tier to a Multi-tier IBM i Web Model
6.4.1 Before You Begin Checklist
6.4.2 Steps for Installing Programs on the IBM i Web Server
6.4.3 Other Considerations When Changing to Multi-tier
6.5 Task: Configure LANSA for the Web Security
6.5.1 Introduction to LANSA for the Web Security
Overview of the LANSA for the Web Security Models
Understanding the Web Server and IBM i User Profiles
LANSA for the Web and IBM i User Profiles
6.5.2 No User Authentication - Anonymous User Access
Before You Begin Checklist
Steps for Anonymous User Access
6.5.3 Full User Authentication
Before You Begin Checklist
Step 1. Create IBM i Validation List & Add Users
Step 2. Define the Scope for Protection
Step 3. Set Security
Step 4. Register User in LANSA for Web
6.5.4 Partial User Authentication - Process Level Security
Before You Begin Checklist
Step 1. IBM i Validation Lists & Add Users
Step 2. Update IBM i Web Server Configuration
Step 3. Execute Administrator to Define Process Authentication
Step 4. Register Web Users
6.5.5 Modifying Multi-tier IBM i LANSA for the Web User Information
Add a New User Profile
Modify Existing User Information
Delete an Existing User Profile
6.5.6 Modifying IBM i Validation Lists
Add a New Validation List User
Modify an Existing Validation List User
Delete An Existing Validation List User
6.6 Task: Set up IBM i Partition for Web Development
6.6.1 Before You Begin Checklist
6.6.2 IBM i Import of LWEBSF & WEBLETS
6.6.3 Web Enable IBM i Partition using LANSA for the Web Administrator
6.6.4 Optional: Default User for the IBM i Partition
7. LANSA Integrator Configuration and Set Up on IBM i
7.1 Task: Configure the Java Service Manager on IBM i
7.2 Task: Configure JSMDirect on an IBM i
7.3 Task: Install LANSA Integrator Software on Windows PC
8. Other Configuration and Setup Tasks on IBM i
8.1 Task: LANSA Open Setup on IBM i
8.1.1 Preparing LANSA for i for LANSA Open
8.1.2 Adjusting the DC@A1O Buffer/Data Area
8.1.3 TCP/IP and LANSA Listeners
8.2 Task: LANSA Client Setup on IBM i
8.3 Task: LANSA Email Setup on IBM i
8.3.1 Step 1. Configure TCP/IP
8.3.2 Step 2. Configure Simple Mail Transfer Protocol (SMTP)
8.3.3 Step 3. Setup the Mail Server Framework (MSF)
8.3.4 Step 4. Set System Value QUTCOFFSET
8.3.5 Step 5. Grant object authorities to the LANSA Product Owner
8.3.6 Step 6. Test your Configuration
8.3.7 Sample LANSA Email Function
8.4 Task: Test LANSA for i on IBM i
8.4.1 Before You Begin Checklist
8.4.2 Step 1. Log on to LANSA
8.4.3 Step 2. Create a Test Process and Function
8.4.4 Step 3. Compile the Test Function
8.4.5 Step 4. Execute the Test Function
8.5 Testing using the Personnel System
8.5.1 Personnel System Demonstration Files
8.6 LANSA for i - What's Next?
8.6.1 Learning About LANSA
8.6.2 Getting Started with LANSA for i
8.6.3 System Settings
8.6.4 Installing Other Products and IBM i Tasks
9. Using Independent Auxiliary Storage Pool (IASP)
9.1 Upgrade in an IASP
9.2 Install in an IASP
9.2.1 IFS objects
9.2.2 Limitations
9.3 How we installed a LANSA System on IASP
10. Troubleshooting
10.1 Troubleshooting Checklist
10.2 Troubleshooting LANSA Listener on IBM i
10.2.1 What should I see if the IBM i Listener is running?
10.2.2 How do I know if the IBM i Listener port is active?
10.2.3 How do I know if the port is accessible from the Internet?
10.2.4 The Listener IBM i sub-system starts but there are no jobs
10.2.5 The Listener IBM i sub-system starts and a job starts and then stops. There are no jobs running.
10.3 Troubleshooting Email Setup
10.3.1 Finding the Email Problem
10.3.2 LANSA Email Tracing
10.4 Web Troubleshooting
10.4.1 How can I test if I have a problem with my Web Server configuration?
10.4.2 Where do I look for details about problems using IBM i?
10.4.3 Is there a simple WAM I can use to test my web configuration?
10.4.4 How do I restart the LANSA for the Web monitors?
Appendix A. IBM i Objects & Parameters
Summary of Installed Objects
Objects Created but not Deleted by LANSA_CLN
LANSA IBM i Install/Upgrade Data Areas
DCXLOADA01
DCXLOADA02
DCXLOADA04
DCXLOADA05
Appendix B. IBM i Operator Procedures
How to check for Active Users
Back up your Libraries
If not using QOTHPRDOWN as the Product Owner
Identify your IBM i Details
Check LANSA_CLN
Appendix C. Miscellaneous Tasks
Verify Listener is Active
Change the LANSA Communications Extensions on the IBM i
Before You Begin Checklist
Step 1. Work with Configuration Items
Step 2. Review Communication Definition
Step 3. Work with Listener Records
Change the HTTP Install Instance
Get in touch
Submit feedback about this site to:
[email protected]