ClearPath Forward ePortal Software Edition Getting Started Guide
Introduction
Naming Convention
Audience
Documentation
Documentation Updates
Prerequisites
What’s New
Definitions of Terms used in ClearPath Forward ePortal Software Edition
Preparing your Site for ePortal SE
Overview
ClearPath Forward ePortal
ePortal Developer
ePortal Runtime Environment
ePortal Manager Partition
ePortal Management Website
ePortal Web Partition
ePortal Web Cluster
ePortal Back-End Server
Capabilities of ClearPath ePortal
Advantages
Networking
ClearPath Forward ePortal Software Edition
ePortal SE Licensing and Activation
Core Based Licensing
Server Connect Licensing
Requirements
Host Environment Requirements
VMware Host Environment
VMware Software Requirements
Hyper-V Host Environment
Hyper-V Software Requirements
Guest Virtual Machine Requirements
Operating System Requirements
Windows Virtual Machines Considerations
Manager Partition Virtual Machine Requirements
Web Partition Virtual Machine Requirements
Networking Requirements
Management Virtual Switch
Front-End Virtual Switch
Back-End Virtual Switch
Manager Partition Virtual Machine
Web Partition Virtual Machines
ClearPath Forward Back-End Server Requirements
Preparing Your Network Environment for ePortal Software Edition
Virtual Networking Background
ePortal SE Networks
Network Configuration
Management LAN
Public Front-End LAN
Back-End LAN
Private Back-End LAN
Integrated Back-End LAN
ePortal SE Configuration Examples
ePortal SE for a Single User Development or Demonstration Environment
ePortal SE for a Production Environment
Enabling DHCP Networks
Considerations
Enabling DHCP for Back-End Network
Back-End Host in the Same Subnet
Back-End Host in Different Subnet
Enabling DHCP for Management Network
Enabling DHCP for Front-End Network
ePortal Software Edition Installation Process Overview
Downloading ePortal SE Installation Package from UDC
High-level Steps to Set up and Install ePortal SE
Naming Conventions for Virtual Machines
Creating Templates Overview
High-level Steps for Installing the Manager Partition
High-level Steps for Installing Web Partitions
Installing Manager Partition and Web Partitions Remotely through RDP
Creating a Virtual Machine in Hyper-V Manager
Creating a Virtual Machine
Creating a Virtual Machine from a Windows ISO Image
Creating a Virtual Machine in VMware ESXi Server
Creating a Virtual Machine in Hyper-V Manager
Creating a Virtual Machine from a Template
Creating a Virtual Machine from a Template in VMware
Creating a Virtual Machine from a Template in Hyper-V
Creating a Template
Creating a Template for Manager Partition and Web Partition
Creating a Template in VMware
Creating a Template in Hyper-V
Installing and Configuring ePortal SE Software
Installing the ePortal Manager Partition Software
ePortal Manager Partition Software Configuration
Installing the ePortal Web Partition Software
ePortal Web Partition Configuration
Rebuilding the Manager Partition
Rebuilding the Manager Partition in VMware
Rebuilding the Manager Partition in Hyper-V
Rebuilding a Web Partition
Rebuilding a Web Partition in VMware
Rebuilding a Web Partition in Hyper-V
Troubleshooting ePortal SE
Troubleshooting ePortal SE Common Problems
ePortal SE Installation Program Stops During Windows Installation
All the Web Partitions are in Not Responding State
License Information on Web Partitions is Incorrect
Troubleshooting ePortal SE Problems in Hyper-V
Boot Error While Installing Windows in the Virtual Machine
Troubleshooting ePortal SE Problems in VMware
Unable to Start the Manager Website
Introduction
Naming Convention
Audience
Documentation
Documentation Updates
Prerequisites
What’s New
Definitions of Terms used in ClearPath Forward ePortal Software Edition
Preparing your Site for ePortal SE
Overview
ClearPath Forward ePortal
ePortal Developer
ePortal Runtime Environment
ePortal Manager Partition
ePortal Management Website
ePortal Web Partition
ePortal Web Cluster
ePortal Back-End Server
Capabilities of ClearPath ePortal
Advantages
Networking
ClearPath Forward ePortal Software Edition
ePortal SE Licensing and Activation
Core Based Licensing
Server Connect Licensing
Requirements
Host Environment Requirements
VMware Host Environment
VMware Software Requirements
Hyper-V Host Environment
Hyper-V Software Requirements
Guest Virtual Machine Requirements
Operating System Requirements
Windows Virtual Machines Considerations
Manager Partition Virtual Machine Requirements
Web Partition Virtual Machine Requirements
Networking Requirements
Management Virtual Switch
Front-End Virtual Switch
Back-End Virtual Switch
Manager Partition Virtual Machine
Web Partition Virtual Machines
ClearPath Forward Back-End Server Requirements
Preparing Your Network Environment for ePortal Software Edition
Virtual Networking Background
ePortal SE Networks
Network Configuration
Management LAN
Public Front-End LAN
Back-End LAN
Private Back-End LAN
Integrated Back-End LAN
ePortal SE Configuration Examples
ePortal SE for a Single User Development or Demonstration Environment
ePortal SE for a Production Environment
Enabling DHCP Networks
Considerations
Enabling DHCP for Back-End Network
Back-End Host in the Same Subnet
Back-End Host in Different Subnet
Enabling DHCP for Management Network
Enabling DHCP for Front-End Network
ePortal Software Edition Installation Process Overview
Downloading ePortal SE Installation Package from UDC
High-level Steps to Set up and Install ePortal SE
Naming Conventions for Virtual Machines
Creating Templates Overview
High-level Steps for Installing the Manager Partition
High-level Steps for Installing Web Partitions
Installing Manager Partition and Web Partitions Remotely through RDP
Creating a Virtual Machine in Hyper-V Manager
Creating a Virtual Machine
Creating a Virtual Machine from a Windows ISO Image
Creating a Virtual Machine in VMware ESXi Server
Creating a Virtual Machine in Hyper-V Manager
Creating a Virtual Machine from a Template
Creating a Virtual Machine from a Template in VMware
Creating a Virtual Machine from a Template in Hyper-V
Creating a Template
Creating a Template for Manager Partition and Web Partition
Creating a Template in VMware
Creating a Template in Hyper-V
Installing and Configuring ePortal SE Software
Installing the ePortal Manager Partition Software
ePortal Manager Partition Software Configuration
Installing the ePortal Web Partition Software
ePortal Web Partition Configuration
Rebuilding the Manager Partition
Rebuilding the Manager Partition in VMware
Rebuilding the Manager Partition in Hyper-V
Rebuilding a Web Partition
Rebuilding a Web Partition in VMware
Rebuilding a Web Partition in Hyper-V
Troubleshooting ePortal SE
Troubleshooting ePortal SE Common Problems
ePortal SE Installation Program Stops During Windows Installation
All the Web Partitions are in Not Responding State
License Information on Web Partitions is Incorrect
Troubleshooting ePortal SE Problems in Hyper-V
Boot Error While Installing Windows in the Virtual Machine
Troubleshooting ePortal SE Problems in VMware
Unable to Start the Manager Website
ClearPath Forward ePortal Software Edition Implementation and Operations Guide
Introduction
Purpose
Audience
Documentation
Conventions
Documentation Updates
What’s New
Definitions of Terms used in ePortal Software Edition
Preparing the MCP for ePortal Software Edition
Collecting MCP Information
Creating MCP Usercodes for ePortal Use
Creating a Usercode with the GROUPCODE Attribute EPORTALCONTROLLER
Setting MCP System Options
Ensuring Necessary MCP Disk Space
Reconfiguring the MCP APPLIANCES Share
Installing the ClearPath Forward EPORTAL- MCPAGENT Interim Correction
ePortal Agent Program
SDFXMLEXTRACTOR Program
MCP HTTP Client Interface API Library
ePortal Setup Program
Downloading and Installing EPORTAL-MCPAGENT IC Software
Downloading and Installing ePortal Runtime and Developer Interim Corrections for MCP
Configuring MCP Network Connection
MCP Network Port Requirement for ePortal
Setting up ePortal Network Connections as Private Connections
Changing the IP Address of the Primary Back-End MCP Server
Example: Configuration Files for Redundant Connections
Example: Configuration Files for a Non-Redundant Connection
Verifying the ClearPath ePortal Port that Custom Connect Facility (CCF) Creates
Configuring Separate CCF Ports for Different Applications
Validating the Connector Protocol-Specific Handler (Connector PSH) Installation and Configuration
Configuring MCP E-mail Utility
Understanding the AB Suite/EAE Remote Access Server for MCP
Installing ePortal Server Connect License Key
Log Forwarding Considerations
Console Forwarding Considerations
Preparing the OS 2200 for ePortal Software Edition
Collecting OS 2200 Information
Creating OS 2200 User ID for ePortal Use
Creating the EPORTAL User ID
Using the EPORTAL User ID
Changing the User ID Before the Password Expires
Setting OS 2200 System Options
Ensuring Necessary OS 2200 Disk Space
Enabling Large File Transfers
Installing the ClearPath Forward EPORTAL-2200 Agent
Installing Prerequisite Software
Verifying the Minimum IC Levels of OS 2200 Software
Installing ClearPath EPORTAL-2200 Agent
Including OS 2200 HTTP Client Interface API Library
Downloading and Installing EPORTAL 2200 Agent IC
Downloading and Installing ePortal Runtime and Developer Interim Corrections for OS 2200
Creating ACRs to Protect ClearPath ePortal Files
Create the Full Access EPCACR ACR
Create the Partial Access EPDACR ACR
Creating OS 2200 APPLIANCES Share for ePortal Use
Creating the OS 2200 CIFS APPLIANCES Share
Securing the OS 2200 APPLIANCES Share
Relocating the OS 2200 APPLIANCES Share
Determining OS 2200 Ports and Connections to Use
Configuring a Network Connection
OS 2200 Network Port Requirement for ePortal SE
Configuring the Communications Platform
Configuring Communications Platform for Open Systems (CPCommOS) on OS 2200
Configuring Redundant Network Connections on the Dorado Systems for ePortal Enterprise System
Configuring a Network Connection for Non-Redundant Connection on the Dorado Systems
Configuring the ClearPath ePortal TCP/IP Utility
EPTCP Background Run Console Key-Ins
Configuring the OS 2200 E-mail Utility
Enabling ClearPath ePortal Alert Notifications
Feeding E-Mail Configuration Values
Installing Messaging Integration Services
Configuring Messaging Integration Services
Open DTP Configuration Considerations
Installing the Required Version of OSI-TP on the OS 2200 Server
The OSI-TP Configuration on the OS 2200 Server
TIP Configuration Considerations
Sample CITA Configuration
TIP Session Control
Understanding the /EAE Remote Access Server for OS 2200
Installing OS 2200 Server Connect License Key from SOLAR Processor
Log Forwarding Considerations
Console Forwarding Considerations
Performance Statistics Forwarding Considerations
Preparing the AB Suite Runtime Server for ePortal Software Edition
Collecting AB Suite Runtime Server Information
Installing the EPORTAL-WIN-ABS Agent on the AB Suite Runtime Server for the First Time
Downloading and Installing the EPORTAL-WIN-ABS Agent IC on the AB Suite Runtime Server
Configuring the AB Suite Runtime Server for ClearPath ePortal
Creating the ePortal Runtime Fileshare (APPLIANCES Share)
Configuring Users
Network Port Requirement for ePortal SE
Configuring Network Settings for ePortal SE
Verifying the Appliances Share Mapping
Downloading and Installing the ePortal Runtime and Developer Interim Corrections for AB Suite
Configuring the AB Suite Runtime Server to Support Sending Email from ClearPath ePortal
Understanding the AB Suite Remote Access Server
Log Forwarding Considerations
Configuring the AB Suite Runtime Server as Non-Primary Back-End Server
Network Port Requirement for ePortal SE
Configuring Network Settings for ePortal SE
Setting Up and Operating ePortal Software Edition
Starting ePortal Management Website
Initial Configuration Tasks on the ePortal Management Website
Performing Additional Tasks Using the ePortal Management Website
Updating ePortal Software
Installing ClearPath ePortal Interim Corrections on the Primary Back-End Server
Upgrading ePortal Manager Partition and Web Clusters
Performing Fallback Operation
Installing or Updating ePortal Agent on Optional Non-primary Back-End Server
Achieving High Availability for ePortal SE
Manager Resiliency
Manager Resiliency by using VMware vSphere Replication
Manager Resiliency using System Center Data Protection Manager
ePortal SE System Restore Point
System Restore Point in VMware Environment
System Restore Point in Microsoft Hyper-V Environment
Automated High Availability Operations
ePortal Software Edition System Migration
Using Operations Sentinel Monitoring for ePortal Manager
Windows Services and Resources Monitored by Operations Sentinel Server
Operations Sentinel Policy File
Configuring Operations Sentinel Monitoring
Sending Test Message to Operations Sentinel Server Consoles
Stopping Operations Sentinel Monitoring
Downloading Operations Sentinel Policy File
Importing Operations Sentinel Policy File
Upgrading from Previous Versions to ePortal 10.0
Upgrading from ePortal 9.0 to ePortal 10.0
Upgrading from ePortal 8.0 to ePortal 10.0
Developing a ClearPath ePortal Application
Preparing the ClearPath ePortal Developer
ClearPath ePortal Developer Help
Designing and Implementing an Application
Staging an Application
Deploying an Application
Updating an Application
Troubleshooting and Recovery
Gathering ePortal Diagnostics Information
Restarting and Shutting Down the Manager Partition
Restarting and Shutting Down the Web Partition
Troubleshooting ePortal Problems
Cannot Access the ePortal Management Website
Primary Back-End Server is Unavailable or Not Responding
Cannot Access a Deployed Application
Web Partitions Status is Not Responding or Booting
Gateway Router Not Responding to Pings
Recovering a Web Partition
Recovering a Manager Partition
Configuring the Initial Setup Page of ePortal Manager
Failed to Synchronize Manager Partition System Software
Troubleshooting Operations Sentinel Monitoring Problems
CPU Utilization Exceeds Maximum Limit
Memory Utilization Exceeds Maximum Limit
Free Disk Space is below the Minimum Limit
Monitoring Services are Down
Connection is Down
Operations Sentinel Monitoring is Stopped
Operations Sentinel Policy File Mismatch
Default IP Addresses and Configuration Data
Default IP Addresses and Other Data for Libra, Dorado, and AB Suite Runtime Servers
Default IP Addresses for Libra, Dorado, and AB Suite Runtime Servers
Obtaining the Data for ePortal SE
Introduction
Purpose
Audience
Documentation
Conventions
Documentation Updates
What’s New
Definitions of Terms used in ePortal Software Edition
Preparing the MCP for ePortal Software Edition
Collecting MCP Information
Creating MCP Usercodes for ePortal Use
Creating a Usercode with the GROUPCODE Attribute EPORTALCONTROLLER
Setting MCP System Options
Ensuring Necessary MCP Disk Space
Reconfiguring the MCP APPLIANCES Share
Installing the ClearPath Forward EPORTAL- MCPAGENT Interim Correction
ePortal Agent Program
SDFXMLEXTRACTOR Program
MCP HTTP Client Interface API Library
ePortal Setup Program
Downloading and Installing EPORTAL-MCPAGENT IC Software
Downloading and Installing ePortal Runtime and Developer Interim Corrections for MCP
Configuring MCP Network Connection
MCP Network Port Requirement for ePortal
Setting up ePortal Network Connections as Private Connections
Changing the IP Address of the Primary Back-End MCP Server
Example: Configuration Files for Redundant Connections
Example: Configuration Files for a Non-Redundant Connection
Verifying the ClearPath ePortal Port that Custom Connect Facility (CCF) Creates
Configuring Separate CCF Ports for Different Applications
Validating the Connector Protocol-Specific Handler (Connector PSH) Installation and Configuration
Configuring MCP E-mail Utility
Understanding the AB Suite/EAE Remote Access Server for MCP
Installing ePortal Server Connect License Key
Log Forwarding Considerations
Console Forwarding Considerations
Preparing the OS 2200 for ePortal Software Edition
Collecting OS 2200 Information
Creating OS 2200 User ID for ePortal Use
Creating the EPORTAL User ID
Using the EPORTAL User ID
Changing the User ID Before the Password Expires
Setting OS 2200 System Options
Ensuring Necessary OS 2200 Disk Space
Enabling Large File Transfers
Installing the ClearPath Forward EPORTAL-2200 Agent
Installing Prerequisite Software
Verifying the Minimum IC Levels of OS 2200 Software
Installing ClearPath EPORTAL-2200 Agent
Including OS 2200 HTTP Client Interface API Library
Downloading and Installing EPORTAL 2200 Agent IC
Downloading and Installing ePortal Runtime and Developer Interim Corrections for OS 2200
Creating ACRs to Protect ClearPath ePortal Files
Create the Full Access EPCACR ACR
Create the Partial Access EPDACR ACR
Creating OS 2200 APPLIANCES Share for ePortal Use
Creating the OS 2200 CIFS APPLIANCES Share
Securing the OS 2200 APPLIANCES Share
Relocating the OS 2200 APPLIANCES Share
Determining OS 2200 Ports and Connections to Use
Configuring a Network Connection
OS 2200 Network Port Requirement for ePortal SE
Configuring the Communications Platform
Configuring Communications Platform for Open Systems (CPCommOS) on OS 2200
Configuring Redundant Network Connections on the Dorado Systems for ePortal Enterprise System
Configuring a Network Connection for Non-Redundant Connection on the Dorado Systems
Configuring the ClearPath ePortal TCP/IP Utility
EPTCP Background Run Console Key-Ins
Configuring the OS 2200 E-mail Utility
Enabling ClearPath ePortal Alert Notifications
Feeding E-Mail Configuration Values
Installing Messaging Integration Services
Configuring Messaging Integration Services
Open DTP Configuration Considerations
Installing the Required Version of OSI-TP on the OS 2200 Server
The OSI-TP Configuration on the OS 2200 Server
TIP Configuration Considerations
Sample CITA Configuration
TIP Session Control
Understanding the /EAE Remote Access Server for OS 2200
Installing OS 2200 Server Connect License Key from SOLAR Processor
Log Forwarding Considerations
Console Forwarding Considerations
Performance Statistics Forwarding Considerations
Preparing the AB Suite Runtime Server for ePortal Software Edition
Collecting AB Suite Runtime Server Information
Installing the EPORTAL-WIN-ABS Agent on the AB Suite Runtime Server for the First Time
Downloading and Installing the EPORTAL-WIN-ABS Agent IC on the AB Suite Runtime Server
Configuring the AB Suite Runtime Server for ClearPath ePortal
Creating the ePortal Runtime Fileshare (APPLIANCES Share)
Configuring Users
Network Port Requirement for ePortal SE
Configuring Network Settings for ePortal SE
Verifying the Appliances Share Mapping
Downloading and Installing the ePortal Runtime and Developer Interim Corrections for AB Suite
Configuring the AB Suite Runtime Server to Support Sending Email from ClearPath ePortal
Understanding the AB Suite Remote Access Server
Log Forwarding Considerations
Configuring the AB Suite Runtime Server as Non-Primary Back-End Server
Network Port Requirement for ePortal SE
Configuring Network Settings for ePortal SE
Setting Up and Operating ePortal Software Edition
Starting ePortal Management Website
Initial Configuration Tasks on the ePortal Management Website
Performing Additional Tasks Using the ePortal Management Website
Updating ePortal Software
Installing ClearPath ePortal Interim Corrections on the Primary Back-End Server
Upgrading ePortal Manager Partition and Web Clusters
Performing Fallback Operation
Installing or Updating ePortal Agent on Optional Non-primary Back-End Server
Achieving High Availability for ePortal SE
Manager Resiliency
Manager Resiliency by using VMware vSphere Replication
Manager Resiliency using System Center Data Protection Manager
ePortal SE System Restore Point
System Restore Point in VMware Environment
System Restore Point in Microsoft Hyper-V Environment
Automated High Availability Operations
ePortal Software Edition System Migration
Using Operations Sentinel Monitoring for ePortal Manager
Windows Services and Resources Monitored by Operations Sentinel Server
Operations Sentinel Policy File
Configuring Operations Sentinel Monitoring
Sending Test Message to Operations Sentinel Server Consoles
Stopping Operations Sentinel Monitoring
Downloading Operations Sentinel Policy File
Importing Operations Sentinel Policy File
Upgrading from Previous Versions to ePortal 10.0
Upgrading from ePortal 9.0 to ePortal 10.0
Upgrading from ePortal 8.0 to ePortal 10.0
Developing a ClearPath ePortal Application
Preparing the ClearPath ePortal Developer
ClearPath ePortal Developer Help
Designing and Implementing an Application
Staging an Application
Deploying an Application
Updating an Application
Troubleshooting and Recovery
Gathering ePortal Diagnostics Information
Restarting and Shutting Down the Manager Partition
Restarting and Shutting Down the Web Partition
Troubleshooting ePortal Problems
Cannot Access the ePortal Management Website
Primary Back-End Server is Unavailable or Not Responding
Cannot Access a Deployed Application
Web Partitions Status is Not Responding or Booting
Gateway Router Not Responding to Pings
Recovering a Web Partition
Recovering a Manager Partition
Configuring the Initial Setup Page of ePortal Manager
Failed to Synchronize Manager Partition System Software
Troubleshooting Operations Sentinel Monitoring Problems
CPU Utilization Exceeds Maximum Limit
Memory Utilization Exceeds Maximum Limit
Free Disk Space is below the Minimum Limit
Monitoring Services are Down
Connection is Down
Operations Sentinel Monitoring is Stopped
Operations Sentinel Policy File Mismatch
Default IP Addresses and Configuration Data
Default IP Addresses and Other Data for Libra, Dorado, and AB Suite Runtime Servers
Default IP Addresses for Libra, Dorado, and AB Suite Runtime Servers
Obtaining the Data for ePortal SE
ePortal Platform Generation 5 Planning and Implementation Guide
Introduction
Documentation Updates
What’s New
Terminology Conventions
Outline for Implementing ClearPath ePortal
Overview of the System
Overview
ePortal Business System
ePortal Enterprise System
Base Hardware Configuration
Expanded Hardware Configuration
Network Switches
ePortal Management Computer
Managing the ePortal System
ePortal Management Website
Platform Management Card
ePortal Platform Console
Manager Partition Replication
Enabling Manager Partition Replication
Monitoring Manager Partition Replication Status and Reporting Replication Alert
Planned Failover Operation
Unplanned Failover Operation
Comparing Planned and Unplanned Failover
Recovery from a Planned or Unplanned Failover
System Restore Point
Usage Considerations
Creating a System Restore Point
Deleting a System Restore Point
Applying a System Restore Point
Recovering from System Restore Point Errors
Comparing Backup and System Restore Point
Operations Sentinel Monitoring for ePortal Manager
Windows Services and Resources Monitored by Operations Sentinel Server
Operations Sentinel Policy File
ePortal Licensing and Activation
Core Based Licensing
Server Connect Licensing
Preparing Your Site for ePortal Business System
What to Consider
Resiliency and Fault Tolerance
Network Consideration
Management Network Considerations
Back-End Network Considerations
Front-End Public Network Consideration
Connecting Network Cables
Connecting to the Management Network
Site Requirements
Hardware Specifications
Power Specifications
Preparing Your Site for ePortal Enterprise System
What to Consider
Resiliency and Fault Tolerance
Network Consideration
Management Network Considerations
Back-End Network Considerations
Front-End Public Network Consideration
Connecting Network Cables
M5300-28G and M4300-28G Switch Port Mapping or Usage
M4300-52G Switch Port Mapping or Usage
Connecting to the Management Network
Site Requirements
Hardware Specifications
Power Specifications
Verifying Your Shipment
Downloading ePortal Installation Package from UDC
Verify Windows Media and Hardware Styles for ClearPath ePortal Business System
Windows Media for RMW24-LCM, RMW24-LCO, and RMW24-LCW Styles
Hardware for RMW24-LCM, RMW24-LCO, and RMW24-LCW Styles
Verify Windows Media and Hardware Styles for ClearPath ePortal Enterprise System
Windows Media for RMW85-SVM and RMW85-SVO Styles
Hardware for RMW85-SVM and RMW85-SVO Styles
Verify Hardware Styles for ClearPath ePortal Enterprise Add-on System
Windows Media for RMW85-ADM and RMW85-ADO Styles
Hardware for RMW85-ADM and RMW85-ADO Styles
Preparing the MCP for ClearPath ePortal
Collecting MCP Information
Creating MCP Usercodes for ePortal Use
Creating a Usercode with the GROUPCODE Attribute EPORTALCONTROLLER
Setting MCP System Options
Ensuring Necessary MCP Disk Space
Reconfiguring the MCP APPLIANCES Share
Installing the ClearPath Forward EPORTAL-MCPAGENT Interim Correction
ePortal Agent Program
SDFXMLEXTRACTOR Program
MCP HTTP Client Interface API Library
ePortal Setup Program
Downloading and Installing EPORTAL-MCPAGENT Interim Correction
Downloading and Installing ePortal Runtime and Developer Interim Corrections for MCP
Determining MCP Ports and Connections to Use
Configuring MCP Network Connection
MCP Network Port Requirement for ePortal Business System
MCP Network Port Requirement for ePortal Enterprise system
Setting up ePortal Network Connections as Private Connections
Changing the IP Address of the Primary Back-End MCP Server
Example: Configuration Files for Redundant Connections
Example: Configuration Files for a Non-Redundant Connection
Verifying the ClearPath ePortal Port That Custom Connect Facility (CCF) Creates
Configuring Separate CCF Ports for Different Applications
Validating the Connector Protocol-Specific Handler (Connector PSH) Installation and Configuration
Configuring the ClearPath ePortal Named Pipe
Configuring MCP E-mail Utility
Understanding the AB Suite/EAE Remote Access Server for MCP
Installing ePortal Server Connect License Key
Log Forwarding Considerations
Console Forwarding Considerations
Next Steps
Preparing the OS 2200 for ClearPath ePortal
Collecting OS 2200 Information
Creating OS 2200 User ID for ePortal Use
Creating the EPORTAL User ID
Using the EPORTAL User ID
Changing the User ID Before the Password Expires
Setting OS 2200 System Options
Ensuring Necessary OS 2200 Disk Space
Enabling Large File Transfers
Installing the ClearPath Forward EPORTAL-2200 Agent
Installing Prerequisite Software
Verifying the Minimum IC Levels of OS 2200 Software
Installing EPORTAL-2200 Agent
Including OS 2200 HTTP Client Interface API Library
Downloading and Installing ePortal Runtime and Developer Interim Corrections for OS 2200
Creating ACRs to Protect ClearPath ePortal Files
Create the Full Access EPCACR ACR
Create the Partial Access EPDACR ACR
Creating OS 2200 APPLIANCES Share for ePortal Use
Creating the OS 2200 CIFS APPLIANCES Share
Securing the OS 2200 APPLIANCES Share
Relocating the OS 2200 APPLIANCES Share
Determining OS 2200 Ports and Connections to Use
Configuring a Network Connection
OS 2200 Network Port Requirement for ePortal Business System
OS 2200 Network Port Requirement for ePortal Enterprise System
Configuring the Communications Platform
Configuring Communications Platform for Open Systems (CPCommOS) on OS 2200
Configuring Redundant Network Connections on the Dorado Systems for ePortal Enterprise System
Configuring a Network Connection for Non-Redundant Connection on the Dorado Systems
Configuring the ClearPath ePortal TCP/IP Utility
EPTCP Background Run Console Key-Ins
Configuring Multiple EPORTAL-2200 Agents in Various CPCommOS Modes
Configuring the OS 2200 E-mail Utility
Enabling ClearPath ePortal Alert Notifications
Feeding E-Mail Configuration Values
Installing Messaging Integration Services
Configuring Messaging Integration Services
Open DTP Configuration Considerations
Installing the Required Version of OSI-TP on the OS 2200 Server
The OSI-TP Configuration on the OS 2200 Server
TIP Configuration Considerations
Sample CITA Configuration
TIP Session Control
Understanding the AB Suite/EAE Remote Access Server for OS 2200
Installing OS 2200 Server Connect License Key from SOLAR Processor
Log Forwarding Considerations
Console Forwarding Considerations
Performance Statistics Forwarding Considerations
Next Steps
Preparing the AB Suite Runtime Server for ClearPath ePortal
Collecting AB Suite Runtime Server Information
Installing the EPORTAL-WIN-ABS Agent on the AB Suite Runtime Server for the First Time
Downloading and Installing EPORTAL-WIN-ABS Agent IC on the AB Suite Runtime Server
Configuring the AB Suite Runtime Server for ClearPath ePortal
Creating the ePortal Runtime Fileshare (APPLIANCES Share)
Configuring Users
Configuring Network Settings for ePortal
Verifying the Appliances Share Mapping
Downloading and Installing the ePortal Runtime and Developer Interim Corrections for AB Suite
Configuring the AB Suite Runtime Server to Support Sending EMAIL from ClearPath ePortal
Understanding the AB Suite Remote Access Server
Log Forwarding Considerations
Next Steps
Setting Up and Operating ClearPath ePortal
Starting ePortal Management Website
Starting ePortal Management Website using ePortal Management Computer Desktop
Starting ePortal Management Website Using Operations Sentinel ePortal Managed Object
Initial Configuration Tasks on the ePortal Management Website
Performing Additional Tasks Using the ePortal Management Website
Updating ePortal Software
Installing ClearPath ePortal Interim Corrections ICs on Back-End Server
Upgrading ePortal Manager Partition, Web Clusters and Platforms
Starting the Platform Management Card User Interface
Starting ePortal Platform Console
Performing Tasks Using the ePortal Platform Console
Performing Platform and System Operations
Performing Manager Partition Operations
Performing Manager Partition Replication Operations
Using Operations Sentinel Monitoring for ePortal Manager
Configuring Operations Sentinel Monitoring
Sending Test Message to Operations Sentinel Server Consoles
Stopping Operations Sentinel Monitoring
Downloading Operations Sentinel Policy File
Importing Operations Sentinel Policy File
Performing Fallback Operation
Performing Fallback Operation for ePortal Generation 5 Systems
Upgrading from Previous Versions to ePortal 10.0
Upgrading from ePortal 9.0 to ePortal 10.0
Upgrading from ePortal 8.0 to ePortal 10.0
Migrating to New ePortal System
Developing a ClearPath ePortal Application
Preparing the ClearPath ePortal Developer
ClearPath ePortal Developer Help
Designing and Implementing an Application
Staging an Application
Deploying an Application
Updating an Application
Troubleshooting and Recovery
Gathering ePortal Diagnostics Information
Gathering Dell Diagnostics Information
Gathering ePortal Switch Diagnostics Information
Restarting and Shutting down a Platform
Restarting and Shutting down the Manager Partition
Troubleshooting Platform Hardware Problems
Troubleshooting ePortal Problems
Cannot Access the ePortal Management Website
Recovering a Manager Partition
Unable to Perform Tasks in ePortal Management Website
Primary Back-End Server Is Unavailable or Not Responding
Unable to Perform Replication Operations
Replication State is "Not Enabled" when the Enable Replication Operation is Initiated
Replication State is “Resynchronizing” for Long Duration after Enabling Replication
Creation of System Restore Point Takes More Time Than Expected
Apply System Restore Operation Failed
Cannot Access a Deployed Application
Web Partitions Status is Not Responding or Booting
Gateway Router Not Responding to Pings
Restarting an ePortal Switch
Recovering a Web Partition
Configuring the Welcome Page of ePortal Manager
Recovering a Platform
Recovering a Failed ePortal Switch
Manager Partition Replication Health Status is Warning or Critical
Cannot Log In to the Platform Management Card User Interface
Platform Management Card Virtual Console Does Not Start
Unable to Access Deployed Applications Using HTTP Protocol
Failed to Synchronize Manager Partition System Software
Unable to Access Dashboard Page after the Restore Operation
Unable to Synchronize System Software on a Web Cluster Even Though it is Present on the Manager Partition
Troubleshooting ePortal Licensing Problems
ePortal Runtime License is in the Enabled/Pending Activation State
Back-End Server is in the Enabled/Pending Server Connect License State
Unable to Add Web Partitions to a Web Cluster
Unable to Add New License because the COD File is not Found
Troubleshooting Operations Sentinel Monitoring Problems
CPU Utilization Exceeds Maximum Limit
Memory Utilization Exceeds Maximum Limit
Free Disk Space is below the Minimum Limit
Monitoring Services are Down
Connection is Down
Operations Sentinel Monitoring is Stopped
Operations Sentinel Policy File Mismatch
Default IP Addresses and Customer Supplied Data
Default IP Addresses and Customer Supplied Data for Libra, Dorado, and AB Suite Runtime Servers
Default IP Addresses for Libra, Dorado Servers, and AB Suite Runtime Servers
Obtaining Customer-Supplied Data for ePortal System
Introduction
Documentation Updates
What’s New
Terminology Conventions
Outline for Implementing ClearPath ePortal
Overview of the System
Overview
ePortal Business System
ePortal Enterprise System
Base Hardware Configuration
Expanded Hardware Configuration
Network Switches
ePortal Management Computer
Managing the ePortal System
ePortal Management Website
Platform Management Card
ePortal Platform Console
Manager Partition Replication
Enabling Manager Partition Replication
Monitoring Manager Partition Replication Status and Reporting Replication Alert
Planned Failover Operation
Unplanned Failover Operation
Comparing Planned and Unplanned Failover
Recovery from a Planned or Unplanned Failover
System Restore Point
Usage Considerations
Creating a System Restore Point
Deleting a System Restore Point
Applying a System Restore Point
Recovering from System Restore Point Errors
Comparing Backup and System Restore Point
Operations Sentinel Monitoring for ePortal Manager
Windows Services and Resources Monitored by Operations Sentinel Server
Operations Sentinel Policy File
ePortal Licensing and Activation
Core Based Licensing
Server Connect Licensing
Preparing Your Site for ePortal Business System
What to Consider
Resiliency and Fault Tolerance
Network Consideration
Management Network Considerations
Back-End Network Considerations
Front-End Public Network Consideration
Connecting Network Cables
Connecting to the Management Network
Site Requirements
Hardware Specifications
Power Specifications
Preparing Your Site for ePortal Enterprise System
What to Consider
Resiliency and Fault Tolerance
Network Consideration
Management Network Considerations
Back-End Network Considerations
Front-End Public Network Consideration
Connecting Network Cables
M5300-28G and M4300-28G Switch Port Mapping or Usage
M4300-52G Switch Port Mapping or Usage
Connecting to the Management Network
Site Requirements
Hardware Specifications
Power Specifications
Verifying Your Shipment
Downloading ePortal Installation Package from UDC
Verify Windows Media and Hardware Styles for ClearPath ePortal Business System
Windows Media for RMW24-LCM, RMW24-LCO, and RMW24-LCW Styles
Hardware for RMW24-LCM, RMW24-LCO, and RMW24-LCW Styles
Verify Windows Media and Hardware Styles for ClearPath ePortal Enterprise System
Windows Media for RMW85-SVM and RMW85-SVO Styles
Hardware for RMW85-SVM and RMW85-SVO Styles
Verify Hardware Styles for ClearPath ePortal Enterprise Add-on System
Windows Media for RMW85-ADM and RMW85-ADO Styles
Hardware for RMW85-ADM and RMW85-ADO Styles
Preparing the MCP for ClearPath ePortal
Collecting MCP Information
Creating MCP Usercodes for ePortal Use
Creating a Usercode with the GROUPCODE Attribute EPORTALCONTROLLER
Setting MCP System Options
Ensuring Necessary MCP Disk Space
Reconfiguring the MCP APPLIANCES Share
Installing the ClearPath Forward EPORTAL-MCPAGENT Interim Correction
ePortal Agent Program
SDFXMLEXTRACTOR Program
MCP HTTP Client Interface API Library
ePortal Setup Program
Downloading and Installing EPORTAL-MCPAGENT Interim Correction
Downloading and Installing ePortal Runtime and Developer Interim Corrections for MCP
Determining MCP Ports and Connections to Use
Configuring MCP Network Connection
MCP Network Port Requirement for ePortal Business System
MCP Network Port Requirement for ePortal Enterprise system
Setting up ePortal Network Connections as Private Connections
Changing the IP Address of the Primary Back-End MCP Server
Example: Configuration Files for Redundant Connections
Example: Configuration Files for a Non-Redundant Connection
Verifying the ClearPath ePortal Port That Custom Connect Facility (CCF) Creates
Configuring Separate CCF Ports for Different Applications
Validating the Connector Protocol-Specific Handler (Connector PSH) Installation and Configuration
Configuring the ClearPath ePortal Named Pipe
Configuring MCP E-mail Utility
Understanding the AB Suite/EAE Remote Access Server for MCP
Installing ePortal Server Connect License Key
Log Forwarding Considerations
Console Forwarding Considerations
Next Steps
Preparing the OS 2200 for ClearPath ePortal
Collecting OS 2200 Information
Creating OS 2200 User ID for ePortal Use
Creating the EPORTAL User ID
Using the EPORTAL User ID
Changing the User ID Before the Password Expires
Setting OS 2200 System Options
Ensuring Necessary OS 2200 Disk Space
Enabling Large File Transfers
Installing the ClearPath Forward EPORTAL-2200 Agent
Installing Prerequisite Software
Verifying the Minimum IC Levels of OS 2200 Software
Installing EPORTAL-2200 Agent
Including OS 2200 HTTP Client Interface API Library
Downloading and Installing ePortal Runtime and Developer Interim Corrections for OS 2200
Creating ACRs to Protect ClearPath ePortal Files
Create the Full Access EPCACR ACR
Create the Partial Access EPDACR ACR
Creating OS 2200 APPLIANCES Share for ePortal Use
Creating the OS 2200 CIFS APPLIANCES Share
Securing the OS 2200 APPLIANCES Share
Relocating the OS 2200 APPLIANCES Share
Determining OS 2200 Ports and Connections to Use
Configuring a Network Connection
OS 2200 Network Port Requirement for ePortal Business System
OS 2200 Network Port Requirement for ePortal Enterprise System
Configuring the Communications Platform
Configuring Communications Platform for Open Systems (CPCommOS) on OS 2200
Configuring Redundant Network Connections on the Dorado Systems for ePortal Enterprise System
Configuring a Network Connection for Non-Redundant Connection on the Dorado Systems
Configuring the ClearPath ePortal TCP/IP Utility
EPTCP Background Run Console Key-Ins
Configuring Multiple EPORTAL-2200 Agents in Various CPCommOS Modes
Configuring the OS 2200 E-mail Utility
Enabling ClearPath ePortal Alert Notifications
Feeding E-Mail Configuration Values
Installing Messaging Integration Services
Configuring Messaging Integration Services
Open DTP Configuration Considerations
Installing the Required Version of OSI-TP on the OS 2200 Server
The OSI-TP Configuration on the OS 2200 Server
TIP Configuration Considerations
Sample CITA Configuration
TIP Session Control
Understanding the AB Suite/EAE Remote Access Server for OS 2200
Installing OS 2200 Server Connect License Key from SOLAR Processor
Log Forwarding Considerations
Console Forwarding Considerations
Performance Statistics Forwarding Considerations
Next Steps
Preparing the AB Suite Runtime Server for ClearPath ePortal
Collecting AB Suite Runtime Server Information
Installing the EPORTAL-WIN-ABS Agent on the AB Suite Runtime Server for the First Time
Downloading and Installing EPORTAL-WIN-ABS Agent IC on the AB Suite Runtime Server
Configuring the AB Suite Runtime Server for ClearPath ePortal
Creating the ePortal Runtime Fileshare (APPLIANCES Share)
Configuring Users
Configuring Network Settings for ePortal
Verifying the Appliances Share Mapping
Downloading and Installing the ePortal Runtime and Developer Interim Corrections for AB Suite
Configuring the AB Suite Runtime Server to Support Sending EMAIL from ClearPath ePortal
Understanding the AB Suite Remote Access Server
Log Forwarding Considerations
Next Steps
Setting Up and Operating ClearPath ePortal
Starting ePortal Management Website
Starting ePortal Management Website using ePortal Management Computer Desktop
Starting ePortal Management Website Using Operations Sentinel ePortal Managed Object
Initial Configuration Tasks on the ePortal Management Website
Performing Additional Tasks Using the ePortal Management Website
Updating ePortal Software
Installing ClearPath ePortal Interim Corrections ICs on Back-End Server
Upgrading ePortal Manager Partition, Web Clusters and Platforms
Starting the Platform Management Card User Interface
Starting ePortal Platform Console
Performing Tasks Using the ePortal Platform Console
Performing Platform and System Operations
Performing Manager Partition Operations
Performing Manager Partition Replication Operations
Using Operations Sentinel Monitoring for ePortal Manager
Configuring Operations Sentinel Monitoring
Sending Test Message to Operations Sentinel Server Consoles
Stopping Operations Sentinel Monitoring
Downloading Operations Sentinel Policy File
Importing Operations Sentinel Policy File
Performing Fallback Operation
Performing Fallback Operation for ePortal Generation 5 Systems
Upgrading from Previous Versions to ePortal 10.0
Upgrading from ePortal 9.0 to ePortal 10.0
Upgrading from ePortal 8.0 to ePortal 10.0
Migrating to New ePortal System
Developing a ClearPath ePortal Application
Preparing the ClearPath ePortal Developer
ClearPath ePortal Developer Help
Designing and Implementing an Application
Staging an Application
Deploying an Application
Updating an Application
Troubleshooting and Recovery
Gathering ePortal Diagnostics Information
Gathering Dell Diagnostics Information
Gathering ePortal Switch Diagnostics Information
Restarting and Shutting down a Platform
Restarting and Shutting down the Manager Partition
Troubleshooting Platform Hardware Problems
Troubleshooting ePortal Problems
Cannot Access the ePortal Management Website
Recovering a Manager Partition
Unable to Perform Tasks in ePortal Management Website
Primary Back-End Server Is Unavailable or Not Responding
Unable to Perform Replication Operations
Replication State is "Not Enabled" when the Enable Replication Operation is Initiated
Replication State is “Resynchronizing” for Long Duration after Enabling Replication
Creation of System Restore Point Takes More Time Than Expected
Apply System Restore Operation Failed
Cannot Access a Deployed Application
Web Partitions Status is Not Responding or Booting
Gateway Router Not Responding to Pings
Restarting an ePortal Switch
Recovering a Web Partition
Configuring the Welcome Page of ePortal Manager
Recovering a Platform
Recovering a Failed ePortal Switch
Manager Partition Replication Health Status is Warning or Critical
Cannot Log In to the Platform Management Card User Interface
Platform Management Card Virtual Console Does Not Start
Unable to Access Deployed Applications Using HTTP Protocol
Failed to Synchronize Manager Partition System Software
Unable to Access Dashboard Page after the Restore Operation
Unable to Synchronize System Software on a Web Cluster Even Though it is Present on the Manager Partition
Troubleshooting ePortal Licensing Problems
ePortal Runtime License is in the Enabled/Pending Activation State
Back-End Server is in the Enabled/Pending Server Connect License State
Unable to Add Web Partitions to a Web Cluster
Unable to Add New License because the COD File is not Found
Troubleshooting Operations Sentinel Monitoring Problems
CPU Utilization Exceeds Maximum Limit
Memory Utilization Exceeds Maximum Limit
Free Disk Space is below the Minimum Limit
Monitoring Services are Down
Connection is Down
Operations Sentinel Monitoring is Stopped
Operations Sentinel Policy File Mismatch
Default IP Addresses and Customer Supplied Data
Default IP Addresses and Customer Supplied Data for Libra, Dorado, and AB Suite Runtime Servers
Default IP Addresses for Libra, Dorado Servers, and AB Suite Runtime Servers
Obtaining Customer-Supplied Data for ePortal System
ClearPath ePortal Manager Help
Getting Started with ePortal Manager
What's New
Documentation Updates
Terminology
ePortal Manager Overview
Understanding the ePortal Manager User Interface
Getting Started Tasks
Working with ePortal Manager
Understanding the ePortal Manager User Interface
How to Enable and Access a Web, Mobile, or Web Service Based Application
Step 1 - Prepare a Back-End Server to Run the Application
Step 2 - Prepare a Web Cluster to Host the Application
Step 3 - Deploy the Application to the Web Cluster
Step 4 - Make the Application Available to Clients
Step 5 - Access the Application
Securing ClearPath ePortal Manager
Updating ePortal System
Monitoring ePortal System Health
Backing Up Current System Configuration
Restoring a Backup
Maintaining your Applications
Planning for Security
Monitoring System Status and Performance
Updating Your Applications
Making Applications Unavailable
Assigning More Resources to an Application
Running an Application in a Test Environment
Licensing and Activation
Understanding ePortal Licensing and Activation
Managing ePortal Licenses
Adding a New License
Managing and Activating a License
Configuring ePortal Manager Settings
Setting Up Data Refresh Interval, Language, and Getting Started Tasks
Setting Up Users
Creating a New User
Modifying User Details
Setting Up System Time Zone
Setting Up Event and Alert E-mail Notifications
Monitoring ePortal System
Monitoring ePortal System Health
Monitoring Performance Counters Using Charts
Managing System Software Updates
Understanding System Software
Software Versions and Software Synchronization
Synchronization Methods
Application Synchronization Methods
Windows Update Support
Updating ePortal System
Managing Manager Partition System Software
Managing System Software on all Web Clusters
Managing Web Cluster System Software
Managing System Software on all Platforms
Managing Web Partition System Software
Managing System Software Updates on all Web Partitions
Managing Platform System Software
Managing Manager Partition
Managing and Configuring Manager Partition Settings
Modifying Manager Partition Settings
Managing Manager Partition System Software
Managing Manager Partition Server Certificates
Installing a Self-Signed TLS Certificate
Generating Manager Partition Trusted Certificate Request
Downloading Manager Partition Trusted Certificate Request
Installing Manager Partition Trusted Certificate
Importing and Installing Manager Partition Trusted Certificate
Exporting Manager Partition TLS Certificate
Modifying or Renewing an Installed TLS Certificate
Installing a New Trusted Certificate
Installing Manager Partition Root and Intermediate Certificates
Server Certificate Details
Manager Partition Root and Intermediate Certificate Details
TLS Certificate Requirement
Enabling or Disabling Security Settings for Manager Partition
Managing Manager Partition Alerts
Managing Manager Partition Events
Gathering Diagnostics Information for ePortal System
Managing System Restore Point
Managing Web Clusters
Managing all Web Clusters
Creating a Web Cluster
Managing and Configuring Web Cluster Settings
Modifying Web Cluster Settings
Managing all Deployed Applications on a Web Cluster
Managing Members of a Web Cluster
Adding One or More Web Partitions to a Specific Web Cluster
Managing Web Cluster System Software
Managing Web Cluster Certificates
Installing Web Cluster Self-Signed TLS Certificate
Generating Web Cluster Trusted Certificate Request
Downloading Web Cluster Trusted Certificate Request
Installing Web Cluster Trusted Certificate
Importing and Installing Web Cluster Trusted Certificate
Exporting Web Cluster TLS Certificate
Modifying or Renewing an Installed TLS Certificate
Installing a New Web Cluster Trusted Certificate
Installing Web Cluster Root and Intermediate Certificates
Web Cluster Server Certificate Details
Web Cluster Root and Intermediate Certificate Details
Installing Web Cluster Client Certificate
Viewing Client Certificate Details and Granting Application Permission
TLS Certificate Requirement
Viewing Performance Statistics of a Web Cluster
Enabling or Disabling Security Settings for a Web Cluster
Gathering IIS Logs for a Web Cluster
Configuring IIS Logging for a Web Cluster
Managing Web Cluster Alerts
Managing Web Cluster Events
Gathering Historical Performance Statistics of a Web Cluster
Managing Web Partitions
Managing all Web Partitions
Adding One or More Web Partitions to a Web Cluster
Managing and Configuring Web Partition Settings
Modifying Web Partition Settings
Viewing Performance Statistics of a Web Partition
Managing Web Partition System Software
Gathering Diagnostics Information for Web Partition
Managing Web Partition Alerts
Managing Web Partition Events
Managing Staged and Deployed Applications
What is an Application?
Managing all Deployed Applications on the ePortal System
Managing all Deployed Applications on a Web Cluster
Managing Deployed Application Settings
Managing all Staged Applications
Managing Staged Application Settings
Deploying an Application Using the Deploy Application Wizard
Deploying an Application
Viewing Performance Statistics of a Deployed Application
Gathering Application Logs of a Deployed Application
Maintaining your Applications
Planning for Security
Monitoring System Status and Performance
Updating Your Applications
Making Applications Unavailable
Assigning More Resources to an Application
Running an Application in a Test Environment
How to Enable and Access a Web, Mobile, or Web Service Based Application
Step 1 - Prepare a Back-End Server to Run the Application
Step 2 - Prepare a Web Cluster to Host the Application
Step 3 - Deploy the Application to the Web Cluster
Step 4 - Make the Application Available to Clients
Step 5 - Access the Application
Managing Back-End Servers
Managing all Back-End Servers
Adding a Back-End Server
Managing and Configuring Back-End Server Settings
Modifying Back-End Server Settings
Changing User Name and Password of a Back-End Server
Managing Events and Alerts Notifications
Managing ePortal System Alerts
Managing ePortal System Events
Managing Manager Partition Alerts
Managing Manager Partition Events
Managing Web Cluster Alerts
Managing Web Cluster Events
Managing Web Partition Alerts
Managing Web Partition Events
Managing Platform Alerts
Viewing Alert Details
Viewing Event Details
Managing Platforms
Managing all Platforms
Managing and Configuring Platform Settings
Modifying Platform Settings
Viewing Members of a Platform
Managing Platform System Software
Managing Platform Alerts
Platform Web API
Managing Backups and Restore
Managing Backup Configurations
Backing Up Current System Configuration
Configuring Backup Location
Restoring a Backup
Troubleshooting
Responding to Alerts
Back-End Server Unavailable
Cannot Access a Deployed Application
Application Deployment Failed Because of Host Name Mismatch
Web Partition Not Responding
Cannot Access the HTTPS Version of the ePortal Management Website
Web Partition Cannot Obtain the Gateway IP Address for a Web Cluster
Restarting the Web Partition
Troubleshooting Windows Alerts
Reporting a Problem to Unisys
Collecting Diagnostic Information
Restarting the Manager Partition
Redirecting to Manager Does Not Work
Troubleshooting Restore Operation
Unable to Download Alerts and Events Log Files
Application Deployment Failed Because of TLS Required Mismatch
Unable to Access Deployed Applications Using HTTP Protocol
Getting Started with ePortal Manager
What's New
Documentation Updates
Terminology
ePortal Manager Overview
Understanding the ePortal Manager User Interface
Getting Started Tasks
Working with ePortal Manager
Understanding the ePortal Manager User Interface
How to Enable and Access a Web, Mobile, or Web Service Based Application
Step 1 - Prepare a Back-End Server to Run the Application
Step 2 - Prepare a Web Cluster to Host the Application
Step 3 - Deploy the Application to the Web Cluster
Step 4 - Make the Application Available to Clients
Step 5 - Access the Application
Securing ClearPath ePortal Manager
Updating ePortal System
Monitoring ePortal System Health
Backing Up Current System Configuration
Restoring a Backup
Maintaining your Applications
Planning for Security
Monitoring System Status and Performance
Updating Your Applications
Making Applications Unavailable
Assigning More Resources to an Application
Running an Application in a Test Environment
Licensing and Activation
Understanding ePortal Licensing and Activation
Managing ePortal Licenses
Adding a New License
Managing and Activating a License
Configuring ePortal Manager Settings
Setting Up Data Refresh Interval, Language, and Getting Started Tasks
Setting Up Users
Creating a New User
Modifying User Details
Setting Up System Time Zone
Setting Up Event and Alert E-mail Notifications
Monitoring ePortal System
Monitoring ePortal System Health
Monitoring Performance Counters Using Charts
Managing System Software Updates
Understanding System Software
Software Versions and Software Synchronization
Synchronization Methods
Application Synchronization Methods
Windows Update Support
Updating ePortal System
Managing Manager Partition System Software
Managing System Software on all Web Clusters
Managing Web Cluster System Software
Managing System Software on all Platforms
Managing Web Partition System Software
Managing System Software Updates on all Web Partitions
Managing Platform System Software
Managing Manager Partition
Managing and Configuring Manager Partition Settings
Modifying Manager Partition Settings
Managing Manager Partition System Software
Managing Manager Partition Server Certificates
Installing a Self-Signed TLS Certificate
Generating Manager Partition Trusted Certificate Request
Downloading Manager Partition Trusted Certificate Request
Installing Manager Partition Trusted Certificate
Importing and Installing Manager Partition Trusted Certificate
Exporting Manager Partition TLS Certificate
Modifying or Renewing an Installed TLS Certificate
Installing a New Trusted Certificate
Installing Manager Partition Root and Intermediate Certificates
Server Certificate Details
Manager Partition Root and Intermediate Certificate Details
TLS Certificate Requirement
Enabling or Disabling Security Settings for Manager Partition
Managing Manager Partition Alerts
Managing Manager Partition Events
Gathering Diagnostics Information for ePortal System
Managing System Restore Point
Managing Web Clusters
Managing all Web Clusters
Creating a Web Cluster
Managing and Configuring Web Cluster Settings
Modifying Web Cluster Settings
Managing all Deployed Applications on a Web Cluster
Managing Members of a Web Cluster
Adding One or More Web Partitions to a Specific Web Cluster
Managing Web Cluster System Software
Managing Web Cluster Certificates
Installing Web Cluster Self-Signed TLS Certificate
Generating Web Cluster Trusted Certificate Request
Downloading Web Cluster Trusted Certificate Request
Installing Web Cluster Trusted Certificate
Importing and Installing Web Cluster Trusted Certificate
Exporting Web Cluster TLS Certificate
Modifying or Renewing an Installed TLS Certificate
Installing a New Web Cluster Trusted Certificate
Installing Web Cluster Root and Intermediate Certificates
Web Cluster Server Certificate Details
Web Cluster Root and Intermediate Certificate Details
Installing Web Cluster Client Certificate
Viewing Client Certificate Details and Granting Application Permission
TLS Certificate Requirement
Viewing Performance Statistics of a Web Cluster
Enabling or Disabling Security Settings for a Web Cluster
Gathering IIS Logs for a Web Cluster
Configuring IIS Logging for a Web Cluster
Managing Web Cluster Alerts
Managing Web Cluster Events
Gathering Historical Performance Statistics of a Web Cluster
Managing Web Partitions
Managing all Web Partitions
Adding One or More Web Partitions to a Web Cluster
Managing and Configuring Web Partition Settings
Modifying Web Partition Settings
Viewing Performance Statistics of a Web Partition
Managing Web Partition System Software
Gathering Diagnostics Information for Web Partition
Managing Web Partition Alerts
Managing Web Partition Events
Managing Staged and Deployed Applications
What is an Application?
Managing all Deployed Applications on the ePortal System
Managing all Deployed Applications on a Web Cluster
Managing Deployed Application Settings
Managing all Staged Applications
Managing Staged Application Settings
Deploying an Application Using the Deploy Application Wizard
Deploying an Application
Viewing Performance Statistics of a Deployed Application
Gathering Application Logs of a Deployed Application
Maintaining your Applications
Planning for Security
Monitoring System Status and Performance
Updating Your Applications
Making Applications Unavailable
Assigning More Resources to an Application
Running an Application in a Test Environment
How to Enable and Access a Web, Mobile, or Web Service Based Application
Step 1 - Prepare a Back-End Server to Run the Application
Step 2 - Prepare a Web Cluster to Host the Application
Step 3 - Deploy the Application to the Web Cluster
Step 4 - Make the Application Available to Clients
Step 5 - Access the Application
Managing Back-End Servers
Managing all Back-End Servers
Adding a Back-End Server
Managing and Configuring Back-End Server Settings
Modifying Back-End Server Settings
Changing User Name and Password of a Back-End Server
Managing Events and Alerts Notifications
Managing ePortal System Alerts
Managing ePortal System Events
Managing Manager Partition Alerts
Managing Manager Partition Events
Managing Web Cluster Alerts
Managing Web Cluster Events
Managing Web Partition Alerts
Managing Web Partition Events
Managing Platform Alerts
Viewing Alert Details
Viewing Event Details
Managing Platforms
Managing all Platforms
Managing and Configuring Platform Settings
Modifying Platform Settings
Viewing Members of a Platform
Managing Platform System Software
Managing Platform Alerts
Platform Web API
Managing Backups and Restore
Managing Backup Configurations
Backing Up Current System Configuration
Configuring Backup Location
Restoring a Backup
Troubleshooting
Responding to Alerts
Back-End Server Unavailable
Cannot Access a Deployed Application
Application Deployment Failed Because of Host Name Mismatch
Web Partition Not Responding
Cannot Access the HTTPS Version of the ePortal Management Website
Web Partition Cannot Obtain the Gateway IP Address for a Web Cluster
Restarting the Web Partition
Troubleshooting Windows Alerts
Reporting a Problem to Unisys
Collecting Diagnostic Information
Restarting the Manager Partition
Redirecting to Manager Does Not Work
Troubleshooting Restore Operation
Unable to Download Alerts and Events Log Files
Application Deployment Failed Because of TLS Required Mismatch
Unable to Access Deployed Applications Using HTTP Protocol
ClearPath ePortal Developer Help
Getting Started
What's New?
Documentation Updates
ClearPath ePortal Overview
Upgrading Projects
Upgrading Projects to the Supported ePortal Developer Versions
Upgrading a Web Site to a Web Application
Upgrading Themes for Web Forms Mobile Projects
Updating NuGet Packages
Removing the MessageType Field from an Upgraded .NET Framework Web API Project
Upgrading Presentation Projects to .NET 6.0
Multi-Targeting Issues
Preparing to Use ClearPath ePortal Developer
Creating and Modifying Client Messages
Understanding Client Messages
Creating Client Messages
Modifying Client Messages
Deleting a Client Message
Runtime Error Checking for Message Fields
Modernizing Your Application
Modernizing a T27 Application
Preparing to Capture the Screens of T27 Applications
Creating a Web Presentation for a T27 Application with Minimal Work
Creating a T27 Data Source Project
Modernizing an MCP COBOL Application
Preparing To Use the MCP COBOL Data Source Wizard
Creating an MCP COBOL Data Source Project
Modernizing an OS 2200 Open DTP Application
Preparing to Use the OS 2200 Open DTP Data Source Wizards
Translation Considerations
Metadata Fields
Open DTP Configuration Considerations
Creating an OS 2200 Open DTP Data Source Project
Modernizing an OS 2200 TIP Application
Preparing to Create ePortal Messages from Your TIP Application
Preparing to Use the DPS Import Form Library Dialog
Using the FLMU Utility
DPS Form to Server Message Mapping
Preparing to Use the OS 2200 COBOL Data Source Wizard
Translation Considerations
Metadata Fields
Creating an OS 2200 TIP Data Source Project
Modernizing an OS 2200 UTS Application
Preparing to Capture the Screens of a UTS Application
Creating a Web Presentation for a UTS Application with Minimal Work
Creating an OS 2200 UTS Data Source Project
Integrating an AB Suite Application with ePortal
Preparing to Use the AB Suite/EAE Ispec Import Dialog
Support for Multiple AB Suite/EAE Applications
Support for AB Suite/EAE Features
Creating an AB Suite/EAE Data Source Project
Controlling the Flow of Data
Creating a Simple Orchestration
Using Map and Forward to Simplify Orchestration
Using Orchestration to Identify an Output Server Message
Creating Loops and Branches
Creating Reusable Code with an Orchestration Process
Using External Code with an Orchestration Process
Using External Code with an Orchestration Message Filter
Using the OrchExtensions Class
Logging from your Orchestration
Consolidating Multiple Server Messages into One Client Message
Orchestration Tasks for MCP COBOL Projects
Orchestration Tasks for OS 2200 Open DTP Projects
Orchestration Tasks for OS 2200 TIP Projects
Orchestration Tasks for OS 2200 UTS Projects
Orchestration Tasks for AB Suite/EAE Projects
Determining the Type of a Received Message
Handling Exceptional or Abnormal Conditions
Security Settings for an Application
Configuring .NET Core Web API Applications
Setting .NET Core Web API Properties
Implementing Security in the Startup.cs File
Debugging an Orchestration
Understanding Orchestration
Preparing to Build Your Presentation Project
Getting Ready to Build a New Presentation Project
Choosing Web Forms or MVC
Creating an MVC Web Application
Creating Web Forms Application Projects
Creating an ASP .Net Web Application
Creating an ASP.Net Web Application (Terminal Screen Appearance)
Creating an ASP.Net AB Suite Web Application
Creating Web Forms Mobile Application Projects
Creating an ASP.Net WebApp for Use with Smartphone Devices
Creating an ASP.Net AB Suite/EAE WebApp for Use with Smartphone Devices
Creating Web Service Application Projects
Choosing WCF or Web API
Creating a RESTful Web Service Application
Creating a .NET Core Web API RESTful Application
Creating a WCF Service Application using Scaffolding
Creating a WCF Service Application
Creating a WCF ASP.Net Compatibility Service Application
Creating a WCF RESTful Service Application
Modifying the Web.config File
Controlling the Look and Feel of Your Presentation
Modifying the Styles for T27 and UTS Projects
Modifying the Master Page
Modifying the Layout Page
Modifying the Web Form Template
Controlling the Look and Feel in a T27 Data Source Project
Controlling the Look and Feel in a UTS Data Source Project
Controlling the Look and Feel in All Data Source Projects
Controlling the Look and Feel using Visual Studio Web Editors
Editing .cshtml Files
Editing .aspx Files
Bootstrap Themes for MVC Projects
The Default Bootstrap Theme
The Unisys Modern Bootstrap Theme
Other Bootstrap Themes
Changing the Selected Bootstrap Theme
Controlling the Theme Selection for a Web Forms Mobile Project
About Themes
App_Themes Directory Structure
Included Themes
Designer Theme Selection
Runtime Theme Selection
Project Item Templates for Web Forms Mobile Presentation Projects
Creating a New Mobile Web Content Form
Configuring an Icon and Startup Image for an iOS Application
Using the Polymer Icons NuGet Package
Controlling the Runtime Behavior of Your Presentation
Controlling the Runtime Behavior for MVC Web
Generated MVC Files
Programming in the Controller for MVC Web
Validating MVC Web Pages
Controlling the Runtime Behavior for Web API
Generated Web API File
Programming in the Controller for Web API
Controlling the Runtime Behavior for WCF Services Using Scaffolding
Generated WCF Service Files for WCF Services Using Scaffolding
Programming in the Service Implementation for WCF Services Using Scaffolding
Programming in the Custom Validators for WCF Services Using Scaffolding
Controlling the Runtime Behavior for WCF and WCF ASP.Net Services
Generated WCF Service Files for WCF and WCF ASP.Net Services
Programming in the Service Implementation for WCF and WCF ASP.Net Services
Programming in the Custom Validators for WCF Services (Without Scaffolding)
Controlling the Runtime Behavior for Web Forms
Generated Web Forms Files
Opening the Generated Web Forms Files
Programming in the Code-Behind File
Validating Web Forms Pages
Validation Performed by HTML5-Compatible Browsers
Validation Performed by ePortal
Adding Validation to Your Web Forms Page
Controlling the Runtime Behavior for AB Suite and EAE
Logging Messages from your Code
Configuring Redundant Application Connections
Preparing Your Project for Use
Testing a Presentation Project
Testing an MVC Web Application
Testing a Web Forms Application
Testing a Web Forms Mobile Application
Testing a Web API RESTful Web Service Application
Using the Web API RESTful Test Client
Testing a .NET Core Web API RESTful Web Service Application
Testing a WCF RESTful Web Service Application
Using the WCF RESTful Test Client
Testing Other Web Service Applications
Publishing to IIS
Defining Additional Performance Counters
Staging a Presentation Project
Staging a .NET Framework Presentation Project
Staging a .NET Core Application
Configuring an Application with the Deployment Values
Publishing an Application to a Web Deploy Package
Staging the Published Application Using the ePortal Stage Option
Restaging a Presentation Project
Outbound Web Service Communication
Preparing the Outbound Web Service Communication
Creating an Outbound Web Service API Project
Importing an OpenAPI Specification
Outbound Web Service Artifacts
Configuring an Outbound Service
Generating COBOL Copy Books
COBOL OpenAPI Extensions
Default Outbound Response
Reimporting an OpenAPI Specification
Calling a RESTful API with Security Schemes
Calling a RESTful API Secured with HTTP Authentication
Calling a RESTful API Secured with API key Authentication
Calling a RESTful API Secured with OAuth 2.0
Calling a RESTful API Secured with Multiple Authentication Types
Setting Security Parameters from COBOL Applications
Testing the Outbound Web Service Communication using Visual Studio
HTTP Client Interface for MCP COBOL Applications
Interface Methods and Sequence of Calls
Details of the Interface Methods
Sample COBOL85 Program Illustration for MCP
HTTP Client Interface for OS 2200 COBOL Applications
Interface Methods and Sequence of Calls
Details of the Interface Methods
Sample UCS COBOL Program Illustration for OS 2200
Staging your Outbound Service Project
Deploying your Outbound Web Service API Project
Modifying Your Project
Modifying T27 Projects
Modifying the Connection Properties
Connecting to and Disconnecting from the T27 Application
Restarting a Screen Capture
Modifying Existing Server Messages
Recapturing a Screen
Deleting Server Messages
Modifying UTS Projects
Modifying the Connection Properties
Connecting to and Disconnecting from the UTS Application
Restarting a Screen Capture
Modifying Existing Server Messages
Recapturing a Screen
Deleting Server Messages
Modifying MCP COBOL Projects
Handling Updates to the MCP Application Code
Changing the COBOL Data Identifier
Deleting Server Messages
Modifying OS 2200 Open DTP Projects
Handling Updates to the OS 2200 Open DTP Application Data Definitions
Handling Updates to the OS 2200 Open DTP Service Name
Changing String to Binary or Binary to String
Changing String Field Properties
Changing the COBOL Data Identifier
Deleting Server Messages
Modifying OS 2200 TIP Projects
Handling Updates to DPS Forms
Handling Updates to the OS 2200 TIP Application Data Definitions
Handling Updates to the OS 2200 TIP Transaction Code
Changing the COBOL Data Identifier for OS 2200 TIP Projects
Deleting Server Messages for OS 2200 TIP Projects
Modifying AB Suite/EAE Projects
Handling Updates to the AB Suite/EAE Ispecs
Changing Table Generation for Copy Ispecs
Changing Automatic Control Label Generation
Modifying Presentation Projects
Changing to a Master Page
Changing Presentation Generation Options
Removing a Dynamic Region from an .aspx File
Viewing or Changing ePortal Application Configuration Properties
Controlling Source Files
Using Source Control
Working with Controlled Files
Building Your ePortal Solution
Build Configurations
Building the Solution
Cleaning the Solution
Rebuilding the Solution
Using an SDF Formlibrary
Using an SDF Formlibrary with ePortal
Using the SDFXMLEXTRACTOR Utility
Modernizing an SDF COBOL Application using a T27 Data Source Project
Migrating an SDF COBOL Application into an MCP COBOL Data Source Project
MCP COBOL Data Source Project Considerations
Consuming the Web Service Methods by a Web Service Client
Consuming RESTful Web Services
Consuming Other Web Services
ePortal Command-line Tools
Building the Solution from the Command Line
Updating the Configuration Files (Optional)
Staging the Presentation Project from the Command Line
Configuring File Transforms
Publishing and Staging Projects from the Command Line
Deploying an Application from the Command Line
UnDeploying an Application from the Command Line
Importing an AB Suite/EAE Ispec Using Command Line Utility
Troubleshooting
Logging Errors and Tracing
Gathering Diagnostic Information
Blank Lines are Missing in the Presentation Project
Cannot Connect to Host
ePortal Developer Controls Are Missing
ePortal Toolbox Item Is Missing
Deleted Dynamic Regions Reappear after a Build
No Generators Found for Target Project
No matching record identifier found
No Valid Connection found for this Session
Presentation Pages Do Not Reflect Master Page Content
Presentation Pages Do Not Reflect Web Form Template Contents
Screen Columns Do Not Line Up
Search for ClearPath ePortal Help Does Not Work
Presentation Application Did Not Launch
Connection Errors and Timeouts When Using Web Services
Unexpected Errors When Submitting Large Web Pages
Unable to Load Unisys.MCPT27.WebEnablerRuntime
Unrecognized Attribute targetFramework Occurs When Running a Published Web Application
Unable to Access MVC Web Application from a Multi-Device Hybrid App
Unable to Build Solution after Upgrading from Previous Versions
Application Deployment Failed Because of Host Name Mismatch
Examples
Sample Applications
T27 Project SDFXMLEXTRACTOR Utility Example
COBOL Project SDFXMLEXTRACTOR Utility Example
Using a CustomValidator with Message Field Runtime Error Checking
MVC Scaffolding and Templating Examples
Accessing Multiple Host Applications based on different Data Source Projects Using Single Sign On
Reference Information
Alternate Methods of Initiating Tasks
Data Source Project Property Pages Dialog
MCP COBOL Data Source Project Property Pages Dialog
OS 2200 Open DTP Data Source Project Property Pages Dialog
OS 2200 TIP Data Source Project Property Pages Dialog
AB Suite/EAE Data Source Project Property Pages Dialog
Reference Information for MCP T27 Projects
T27 Editor and Dialog Boxes
Dynamic Region Array Dialog
T27 Emulator
T27 Screen Editor
T27 Connection Properties Dialog
T27 Property Descriptions
T27 Dynamic Field Property Descriptions
T27 Emulator Property Descriptions
T27 Field Property Descriptions
T27 Page Identification Region Property Descriptions
T27 Page Property Descriptions
Reference Information for MCP COBOL Projects
MCP COBOL Data Source Wizard
MCP COBOL Select Source File
MCP COBOL Record Selection
MCP COBOL Set Discriminator
MCP COBOL Configuration Dialog Box
COBOL Record Editor
Reference Information for OS 2200 Open DTP Projects
Add Open DTP Server Message Dialog
OS 2200 Open DTP View Data Source Wizard
OS 2200 Open DTP X OCTET Data Source Wizard
OS 2200 Open DTP COBOL Data Source Wizard
OS 2200 Open DTP Select Source File
OS 2200 Open DTP Record Selection
OS 2200 Open DTP Set Discriminator
OS 2200 Open DTP Record Editor
OS 2200 Open DTP Configuration Dialog
Reference Information for OS 2200 TIP Projects
DPS Import Form Library Dialog
Configure Discriminator Field Dialog
OS 2200 COBOL Data Source Wizard
OS 2200 TIP Select Source File
OS 2200 TIP Record Selection
OS 2200 TIP Set Discriminator
OS 2200 TIP Configuration Dialog
Reference Information for OS 2200 UTS Projects
UTS Editor and Dialog Boxes
UTS Emulator
UTS Screen Editor
UTS Connection Properties Dialog
Dynamic Region Array Dialog
UTS Property Descriptions
UTS Dynamic Field Property Descriptions
UTS Emulator Property Descriptions
UTS Field Property Descriptions
UTS Page Identification Region Property Descriptions
UTS Page Property Descriptions
UTS Emulator Keyboard Map
Reference Information for AB Suite/EAE Projects
AB Suite/EAE Ispec Import Dialog
Reference Information for Scaffolded Projects
Using Multiple Data Source Projects
Choosing a Traditional or Single Page Application
Adding Unisys ePortal Data Source Reference
Scaffolding
Overview of Scaffolding
Scaffold Templates
Creating Custom Scaffold Templates
Editor Templates
Invoking Scaffolders
Scaffold Unisys WCF Service for ePortal Data Source Dialog
Scaffold Unisys Web API Controller for ePortal Data Source Dialog
Scaffold Web API Core Controller for ePortal Data Source Dialog
Scaffold Unisys Controller for ePortal Data Source with Views Dialog
Scaffold Unisys Controller for ePortal Data Source Dialog
Scaffold Unisys View Dialog
Terminal Options Dialog
AB Suite/EAE Options Dialog to Preserve Screen Layouts and Styles
AB Suite/EAE Options Dialog to Order Controls by Tab Index
Best Practices for Scaffolded Presentation Projects
Reconciling Client Message Changes to Scaffolded Presentation Projects
Localization Support for MVC
Configuring a Data Source Project for Localization
Manage Languages Dialog
Reference Information for Orchestration
Orchestration Property Descriptions
Orchestration Properties
Throw Activity Property Descriptions
Authorize Properties
Orchestration Editor and Dialog Boxes
Orchestration Editor
Assign Data for Message Dialog Box
Edit Condition Dialog Box
Orchestration Exceptions
Orchestration Exception Properties
Orchestration Toolbox Selections
Orchestration Web API Properties
Web API Controller Level Annotations
Web API Action Level Annotations
Programming Keystrokes for T27 and UTS Applications
Key Sequence Editor Dialog
Theme Management Dialog
ePortal Developer Controls
ePortal Developer Controls for Web Forms Mobile Projects
ePortal Developer Controls for Web Forms Projects
ePortal Associated Controls
ePortal Labeled Controls
ARIA Labeled Controls
Other ePortal Controls
ePortal Developer Controls for MVC Web Projects
ePortal Message View
Open Presentation Files
Reconcile Presentation Files
Delete Presentation Files
Generate Presentation Files
Message Editor
Message Editor Root Node Properties
REST Route Collection Editor
Response Type Collection Editor
Message Editor Field Properties
Message Editor Toolbox Selections
Preserving Client Message Changes
Save Message Dialog
ListItem Collection Editor Dialog
Property Descriptions
ePortal Application Configuration Property Values
MCP T27 Application Configuration Properties
MCP COBOL Application Configuration Properties
OS 2200 Open DTP Application Configuration Properties
OS 2200 TIP Application Configuration Properties
OS 2200 UTS Application Configuration Properties
AB Suite/EAE Application Configuration Properties
WebServer Properties
Web Properties for a Web Forms Application Project
Web Properties for a Web Forms Mobile Project
Web Properties for a Web Service
Presentation Generation Properties
Presentation Generation Properties for a WCF Service Application
Presentation Generation Properties for a WCF ASP.Net Compatibility Service Application
Presentation Generation Properties for a WCF RESTful Service Application
Presentation Generation Properties for an ASP.Net Web Service Application
Presentation Generation Properties for a Web Browser Project
Presentation Generation Properties for a Web Forms Mobile Project
Markup Template Editor
Dynamic Character Mapping
Web Content Accessibility Guidelines
General Guidelines
Specify the Human Language for Each Web Page
Specify a Title and Description for Each Web Page
Specify Alternate Text for Images
Provide Explicit Labels for Inputs
Use Tables with Correct Headers
Allow Keyboard Access for All Controls
Provide Enough Contrast
Getting Started
What's New?
Documentation Updates
ClearPath ePortal Overview
Upgrading Projects
Upgrading Projects to the Supported ePortal Developer Versions
Upgrading a Web Site to a Web Application
Upgrading Themes for Web Forms Mobile Projects
Updating NuGet Packages
Removing the MessageType Field from an Upgraded .NET Framework Web API Project
Upgrading Presentation Projects to .NET 6.0
Multi-Targeting Issues
Preparing to Use ClearPath ePortal Developer
Creating and Modifying Client Messages
Understanding Client Messages
Creating Client Messages
Modifying Client Messages
Deleting a Client Message
Runtime Error Checking for Message Fields
Modernizing Your Application
Modernizing a T27 Application
Preparing to Capture the Screens of T27 Applications
Creating a Web Presentation for a T27 Application with Minimal Work
Creating a T27 Data Source Project
Modernizing an MCP COBOL Application
Preparing To Use the MCP COBOL Data Source Wizard
Creating an MCP COBOL Data Source Project
Modernizing an OS 2200 Open DTP Application
Preparing to Use the OS 2200 Open DTP Data Source Wizards
Translation Considerations
Metadata Fields
Open DTP Configuration Considerations
Creating an OS 2200 Open DTP Data Source Project
Modernizing an OS 2200 TIP Application
Preparing to Create ePortal Messages from Your TIP Application
Preparing to Use the DPS Import Form Library Dialog
Using the FLMU Utility
DPS Form to Server Message Mapping
Preparing to Use the OS 2200 COBOL Data Source Wizard
Translation Considerations
Metadata Fields
Creating an OS 2200 TIP Data Source Project
Modernizing an OS 2200 UTS Application
Preparing to Capture the Screens of a UTS Application
Creating a Web Presentation for a UTS Application with Minimal Work
Creating an OS 2200 UTS Data Source Project
Integrating an AB Suite Application with ePortal
Preparing to Use the AB Suite/EAE Ispec Import Dialog
Support for Multiple AB Suite/EAE Applications
Support for AB Suite/EAE Features
Creating an AB Suite/EAE Data Source Project
Controlling the Flow of Data
Creating a Simple Orchestration
Using Map and Forward to Simplify Orchestration
Using Orchestration to Identify an Output Server Message
Creating Loops and Branches
Creating Reusable Code with an Orchestration Process
Using External Code with an Orchestration Process
Using External Code with an Orchestration Message Filter
Using the OrchExtensions Class
Logging from your Orchestration
Consolidating Multiple Server Messages into One Client Message
Orchestration Tasks for MCP COBOL Projects
Orchestration Tasks for OS 2200 Open DTP Projects
Orchestration Tasks for OS 2200 TIP Projects
Orchestration Tasks for OS 2200 UTS Projects
Orchestration Tasks for AB Suite/EAE Projects
Determining the Type of a Received Message
Handling Exceptional or Abnormal Conditions
Security Settings for an Application
Configuring .NET Core Web API Applications
Setting .NET Core Web API Properties
Implementing Security in the Startup.cs File
Debugging an Orchestration
Understanding Orchestration
Preparing to Build Your Presentation Project
Getting Ready to Build a New Presentation Project
Choosing Web Forms or MVC
Creating an MVC Web Application
Creating Web Forms Application Projects
Creating an ASP .Net Web Application
Creating an ASP.Net Web Application (Terminal Screen Appearance)
Creating an ASP.Net AB Suite Web Application
Creating Web Forms Mobile Application Projects
Creating an ASP.Net WebApp for Use with Smartphone Devices
Creating an ASP.Net AB Suite/EAE WebApp for Use with Smartphone Devices
Creating Web Service Application Projects
Choosing WCF or Web API
Creating a RESTful Web Service Application
Creating a .NET Core Web API RESTful Application
Creating a WCF Service Application using Scaffolding
Creating a WCF Service Application
Creating a WCF ASP.Net Compatibility Service Application
Creating a WCF RESTful Service Application
Modifying the Web.config File
Controlling the Look and Feel of Your Presentation
Modifying the Styles for T27 and UTS Projects
Modifying the Master Page
Modifying the Layout Page
Modifying the Web Form Template
Controlling the Look and Feel in a T27 Data Source Project
Controlling the Look and Feel in a UTS Data Source Project
Controlling the Look and Feel in All Data Source Projects
Controlling the Look and Feel using Visual Studio Web Editors
Editing .cshtml Files
Editing .aspx Files
Bootstrap Themes for MVC Projects
The Default Bootstrap Theme
The Unisys Modern Bootstrap Theme
Other Bootstrap Themes
Changing the Selected Bootstrap Theme
Controlling the Theme Selection for a Web Forms Mobile Project
About Themes
App_Themes Directory Structure
Included Themes
Designer Theme Selection
Runtime Theme Selection
Project Item Templates for Web Forms Mobile Presentation Projects
Creating a New Mobile Web Content Form
Configuring an Icon and Startup Image for an iOS Application
Using the Polymer Icons NuGet Package
Controlling the Runtime Behavior of Your Presentation
Controlling the Runtime Behavior for MVC Web
Generated MVC Files
Programming in the Controller for MVC Web
Validating MVC Web Pages
Controlling the Runtime Behavior for Web API
Generated Web API File
Programming in the Controller for Web API
Controlling the Runtime Behavior for WCF Services Using Scaffolding
Generated WCF Service Files for WCF Services Using Scaffolding
Programming in the Service Implementation for WCF Services Using Scaffolding
Programming in the Custom Validators for WCF Services Using Scaffolding
Controlling the Runtime Behavior for WCF and WCF ASP.Net Services
Generated WCF Service Files for WCF and WCF ASP.Net Services
Programming in the Service Implementation for WCF and WCF ASP.Net Services
Programming in the Custom Validators for WCF Services (Without Scaffolding)
Controlling the Runtime Behavior for Web Forms
Generated Web Forms Files
Opening the Generated Web Forms Files
Programming in the Code-Behind File
Validating Web Forms Pages
Validation Performed by HTML5-Compatible Browsers
Validation Performed by ePortal
Adding Validation to Your Web Forms Page
Controlling the Runtime Behavior for AB Suite and EAE
Logging Messages from your Code
Configuring Redundant Application Connections
Preparing Your Project for Use
Testing a Presentation Project
Testing an MVC Web Application
Testing a Web Forms Application
Testing a Web Forms Mobile Application
Testing a Web API RESTful Web Service Application
Using the Web API RESTful Test Client
Testing a .NET Core Web API RESTful Web Service Application
Testing a WCF RESTful Web Service Application
Using the WCF RESTful Test Client
Testing Other Web Service Applications
Publishing to IIS
Defining Additional Performance Counters
Staging a Presentation Project
Staging a .NET Framework Presentation Project
Staging a .NET Core Application
Configuring an Application with the Deployment Values
Publishing an Application to a Web Deploy Package
Staging the Published Application Using the ePortal Stage Option
Restaging a Presentation Project
Outbound Web Service Communication
Preparing the Outbound Web Service Communication
Creating an Outbound Web Service API Project
Importing an OpenAPI Specification
Outbound Web Service Artifacts
Configuring an Outbound Service
Generating COBOL Copy Books
COBOL OpenAPI Extensions
Default Outbound Response
Reimporting an OpenAPI Specification
Calling a RESTful API with Security Schemes
Calling a RESTful API Secured with HTTP Authentication
Calling a RESTful API Secured with API key Authentication
Calling a RESTful API Secured with OAuth 2.0
Calling a RESTful API Secured with Multiple Authentication Types
Setting Security Parameters from COBOL Applications
Testing the Outbound Web Service Communication using Visual Studio
HTTP Client Interface for MCP COBOL Applications
Interface Methods and Sequence of Calls
Details of the Interface Methods
Sample COBOL85 Program Illustration for MCP
HTTP Client Interface for OS 2200 COBOL Applications
Interface Methods and Sequence of Calls
Details of the Interface Methods
Sample UCS COBOL Program Illustration for OS 2200
Staging your Outbound Service Project
Deploying your Outbound Web Service API Project
Modifying Your Project
Modifying T27 Projects
Modifying the Connection Properties
Connecting to and Disconnecting from the T27 Application
Restarting a Screen Capture
Modifying Existing Server Messages
Recapturing a Screen
Deleting Server Messages
Modifying UTS Projects
Modifying the Connection Properties
Connecting to and Disconnecting from the UTS Application
Restarting a Screen Capture
Modifying Existing Server Messages
Recapturing a Screen
Deleting Server Messages
Modifying MCP COBOL Projects
Handling Updates to the MCP Application Code
Changing the COBOL Data Identifier
Deleting Server Messages
Modifying OS 2200 Open DTP Projects
Handling Updates to the OS 2200 Open DTP Application Data Definitions
Handling Updates to the OS 2200 Open DTP Service Name
Changing String to Binary or Binary to String
Changing String Field Properties
Changing the COBOL Data Identifier
Deleting Server Messages
Modifying OS 2200 TIP Projects
Handling Updates to DPS Forms
Handling Updates to the OS 2200 TIP Application Data Definitions
Handling Updates to the OS 2200 TIP Transaction Code
Changing the COBOL Data Identifier for OS 2200 TIP Projects
Deleting Server Messages for OS 2200 TIP Projects
Modifying AB Suite/EAE Projects
Handling Updates to the AB Suite/EAE Ispecs
Changing Table Generation for Copy Ispecs
Changing Automatic Control Label Generation
Modifying Presentation Projects
Changing to a Master Page
Changing Presentation Generation Options
Removing a Dynamic Region from an .aspx File
Viewing or Changing ePortal Application Configuration Properties
Controlling Source Files
Using Source Control
Working with Controlled Files
Building Your ePortal Solution
Build Configurations
Building the Solution
Cleaning the Solution
Rebuilding the Solution
Using an SDF Formlibrary
Using an SDF Formlibrary with ePortal
Using the SDFXMLEXTRACTOR Utility
Modernizing an SDF COBOL Application using a T27 Data Source Project
Migrating an SDF COBOL Application into an MCP COBOL Data Source Project
MCP COBOL Data Source Project Considerations
Consuming the Web Service Methods by a Web Service Client
Consuming RESTful Web Services
Consuming Other Web Services
ePortal Command-line Tools
Building the Solution from the Command Line
Updating the Configuration Files (Optional)
Staging the Presentation Project from the Command Line
Configuring File Transforms
Publishing and Staging Projects from the Command Line
Deploying an Application from the Command Line
UnDeploying an Application from the Command Line
Importing an AB Suite/EAE Ispec Using Command Line Utility
Troubleshooting
Logging Errors and Tracing
Gathering Diagnostic Information
Blank Lines are Missing in the Presentation Project
Cannot Connect to Host
ePortal Developer Controls Are Missing
ePortal Toolbox Item Is Missing
Deleted Dynamic Regions Reappear after a Build
No Generators Found for Target Project
No matching record identifier found
No Valid Connection found for this Session
Presentation Pages Do Not Reflect Master Page Content
Presentation Pages Do Not Reflect Web Form Template Contents
Screen Columns Do Not Line Up
Search for ClearPath ePortal Help Does Not Work
Presentation Application Did Not Launch
Connection Errors and Timeouts When Using Web Services
Unexpected Errors When Submitting Large Web Pages
Unable to Load Unisys.MCPT27.WebEnablerRuntime
Unrecognized Attribute targetFramework Occurs When Running a Published Web Application
Unable to Access MVC Web Application from a Multi-Device Hybrid App
Unable to Build Solution after Upgrading from Previous Versions
Application Deployment Failed Because of Host Name Mismatch
Examples
Sample Applications
T27 Project SDFXMLEXTRACTOR Utility Example
COBOL Project SDFXMLEXTRACTOR Utility Example
Using a CustomValidator with Message Field Runtime Error Checking
MVC Scaffolding and Templating Examples
Accessing Multiple Host Applications based on different Data Source Projects Using Single Sign On
Reference Information
Alternate Methods of Initiating Tasks
Data Source Project Property Pages Dialog
MCP COBOL Data Source Project Property Pages Dialog
OS 2200 Open DTP Data Source Project Property Pages Dialog
OS 2200 TIP Data Source Project Property Pages Dialog
AB Suite/EAE Data Source Project Property Pages Dialog
Reference Information for MCP T27 Projects
T27 Editor and Dialog Boxes
Dynamic Region Array Dialog
T27 Emulator
T27 Screen Editor
T27 Connection Properties Dialog
T27 Property Descriptions
T27 Dynamic Field Property Descriptions
T27 Emulator Property Descriptions
T27 Field Property Descriptions
T27 Page Identification Region Property Descriptions
T27 Page Property Descriptions
Reference Information for MCP COBOL Projects
MCP COBOL Data Source Wizard
MCP COBOL Select Source File
MCP COBOL Record Selection
MCP COBOL Set Discriminator
MCP COBOL Configuration Dialog Box
COBOL Record Editor
Reference Information for OS 2200 Open DTP Projects
Add Open DTP Server Message Dialog
OS 2200 Open DTP View Data Source Wizard
OS 2200 Open DTP X OCTET Data Source Wizard
OS 2200 Open DTP COBOL Data Source Wizard
OS 2200 Open DTP Select Source File
OS 2200 Open DTP Record Selection
OS 2200 Open DTP Set Discriminator
OS 2200 Open DTP Record Editor
OS 2200 Open DTP Configuration Dialog
Reference Information for OS 2200 TIP Projects
DPS Import Form Library Dialog
Configure Discriminator Field Dialog
OS 2200 COBOL Data Source Wizard
OS 2200 TIP Select Source File
OS 2200 TIP Record Selection
OS 2200 TIP Set Discriminator
OS 2200 TIP Configuration Dialog
Reference Information for OS 2200 UTS Projects
UTS Editor and Dialog Boxes
UTS Emulator
UTS Screen Editor
UTS Connection Properties Dialog
Dynamic Region Array Dialog
UTS Property Descriptions
UTS Dynamic Field Property Descriptions
UTS Emulator Property Descriptions
UTS Field Property Descriptions
UTS Page Identification Region Property Descriptions
UTS Page Property Descriptions
UTS Emulator Keyboard Map
Reference Information for AB Suite/EAE Projects
AB Suite/EAE Ispec Import Dialog
Reference Information for Scaffolded Projects
Using Multiple Data Source Projects
Choosing a Traditional or Single Page Application
Adding Unisys ePortal Data Source Reference
Scaffolding
Overview of Scaffolding
Scaffold Templates
Creating Custom Scaffold Templates
Editor Templates
Invoking Scaffolders
Scaffold Unisys WCF Service for ePortal Data Source Dialog
Scaffold Unisys Web API Controller for ePortal Data Source Dialog
Scaffold Web API Core Controller for ePortal Data Source Dialog
Scaffold Unisys Controller for ePortal Data Source with Views Dialog
Scaffold Unisys Controller for ePortal Data Source Dialog
Scaffold Unisys View Dialog
Terminal Options Dialog
AB Suite/EAE Options Dialog to Preserve Screen Layouts and Styles
AB Suite/EAE Options Dialog to Order Controls by Tab Index
Best Practices for Scaffolded Presentation Projects
Reconciling Client Message Changes to Scaffolded Presentation Projects
Localization Support for MVC
Configuring a Data Source Project for Localization
Manage Languages Dialog
Reference Information for Orchestration
Orchestration Property Descriptions
Orchestration Properties
Throw Activity Property Descriptions
Authorize Properties
Orchestration Editor and Dialog Boxes
Orchestration Editor
Assign Data for Message Dialog Box
Edit Condition Dialog Box
Orchestration Exceptions
Orchestration Exception Properties
Orchestration Toolbox Selections
Orchestration Web API Properties
Web API Controller Level Annotations
Web API Action Level Annotations
Programming Keystrokes for T27 and UTS Applications
Key Sequence Editor Dialog
Theme Management Dialog
ePortal Developer Controls
ePortal Developer Controls for Web Forms Mobile Projects
ePortal Developer Controls for Web Forms Projects
ePortal Associated Controls
ePortal Labeled Controls
ARIA Labeled Controls
Other ePortal Controls
ePortal Developer Controls for MVC Web Projects
ePortal Message View
Open Presentation Files
Reconcile Presentation Files
Delete Presentation Files
Generate Presentation Files
Message Editor
Message Editor Root Node Properties
REST Route Collection Editor
Response Type Collection Editor
Message Editor Field Properties
Message Editor Toolbox Selections
Preserving Client Message Changes
Save Message Dialog
ListItem Collection Editor Dialog
Property Descriptions
ePortal Application Configuration Property Values
MCP T27 Application Configuration Properties
MCP COBOL Application Configuration Properties
OS 2200 Open DTP Application Configuration Properties
OS 2200 TIP Application Configuration Properties
OS 2200 UTS Application Configuration Properties
AB Suite/EAE Application Configuration Properties
WebServer Properties
Web Properties for a Web Forms Application Project
Web Properties for a Web Forms Mobile Project
Web Properties for a Web Service
Presentation Generation Properties
Presentation Generation Properties for a WCF Service Application
Presentation Generation Properties for a WCF ASP.Net Compatibility Service Application
Presentation Generation Properties for a WCF RESTful Service Application
Presentation Generation Properties for an ASP.Net Web Service Application
Presentation Generation Properties for a Web Browser Project
Presentation Generation Properties for a Web Forms Mobile Project
Markup Template Editor
Dynamic Character Mapping
Web Content Accessibility Guidelines
General Guidelines
Specify the Human Language for Each Web Page
Specify a Title and Description for Each Web Page
Specify Alternate Text for Images
Provide Explicit Labels for Inputs
Use Tables with Correct Headers
Allow Keyboard Access for All Controls
Provide Enough Contrast
Xamarin Cross-Platform App Developer Help
Introduction
What’s New
Documentation Updates
Architecture
Xamarin App Design Pattern
System Requirements
Operating Systems
Other Software Requirements
Disk Space
Visual Studio Requirements
Visual Studio for MAC System Requirements
iOS Developer Program Membership
Developing Xamarin Project
Installing AutoREST using Node Package Manager (npm)
Creating a Xamarin Forms Project using Visual Studio
Creating a Xamarin Forms Project using Visual Studio for Mac
NuGet Packages used for ePortal Xamarin Forms Projects
Updating NuGet Packages
Creating REST API Clients
Scaffolding XAML Views and View Models
Handling Modified Files during Scaffolding
Configuring Settings
Settings for Generating AutoREST
Configuring the appconfig.xml
Building and Testing Xamarin Forms Projects
Building Applications
Testing Xamarin Projects
Testing and Debugging your Android Xamarin App
Testing and Debugging your iOS Xamarin App
Customizing the Xamarin App
Modifying Views
Modifying ViewModels
Modifying the ConnectionHelper class in the Toolkit Folder
Publishing a Xamarin App to the App Store
Troubleshooting
Introduction
What’s New
Documentation Updates
Architecture
Xamarin App Design Pattern
System Requirements
Operating Systems
Other Software Requirements
Disk Space
Visual Studio Requirements
Visual Studio for MAC System Requirements
iOS Developer Program Membership
Developing Xamarin Project
Installing AutoREST using Node Package Manager (npm)
Creating a Xamarin Forms Project using Visual Studio
Creating a Xamarin Forms Project using Visual Studio for Mac
NuGet Packages used for ePortal Xamarin Forms Projects
Updating NuGet Packages
Creating REST API Clients
Scaffolding XAML Views and View Models
Handling Modified Files during Scaffolding
Configuring Settings
Settings for Generating AutoREST
Configuring the appconfig.xml
Building and Testing Xamarin Forms Projects
Building Applications
Testing Xamarin Projects
Testing and Debugging your Android Xamarin App
Testing and Debugging your iOS Xamarin App
Customizing the Xamarin App
Modifying Views
Modifying ViewModels
Modifying the ConnectionHelper class in the Toolkit Folder
Publishing a Xamarin App to the App Store
Troubleshooting
Multi-Device App Developer Help
Introduction
Documentation Updates
Supported Operating Systems
Planning and Requirements
Operating System
Other Software Requirements
Disk Space
Visual Studio Code Requirements
iOS Developer Program Membership
Developing Your Multi-Device App Solution
Developing a Cordova WebView Application
Creating a New Cordova Project
Creating a Cordova Project Using Visual Studio Code
Configuring Application Settings
iOS Development Certificate
Generating a Certificate on Apple Mac System
Debugging and Testing Your Project
Debugging a Cordova Project Using Visual Studio Code
Migrating from Previous Versions
Migrating to Visual Studio Code Cordova Project
Using a Project Already Migrated to Visual Studio 2017
Migrating ePortal MDA Project Directly to a Visual Studio Code Cordova Project
Packaging your Cordova Hybrid App for Publishing to the App Store
iOS App ID
iOS Provisioning Profile
Submitting your App to the App Store
Build Your App for Release
iOS Distribution Certificate
Creating an App ID
Creating an iOS Provisioning Profile
Creating an App in iTunes Connect
Building and Packaging the Project in XCode
Submitting Your App to the App Store
Finalizing your Submission in iTunes Connect
Submitting your App to the Google Play Store
Code Signing for Android Applications
Google Play Developer Console
Creating an APK File
Troubleshooting
Cannot Load the MVC Single Page in the Browser Window while Debugging using Visual Studio Code
Cordova Application Fails to Build the iOS App Package Using Visual Studio Code
Unable to Access MVC Web Application from a Multi-Device Hybrid App
Unable to Debug on Android Platform
Unable to Launch the Application
Unable to Load a Standard Website in a WebView for iOS Platform
Unable to Load and Execute the Cordova Application on an iOS Simulator Using Visual Studio Code
Introduction
Documentation Updates
Supported Operating Systems
Planning and Requirements
Operating System
Other Software Requirements
Disk Space
Visual Studio Code Requirements
iOS Developer Program Membership
Developing Your Multi-Device App Solution
Developing a Cordova WebView Application
Creating a New Cordova Project
Creating a Cordova Project Using Visual Studio Code
Configuring Application Settings
iOS Development Certificate
Generating a Certificate on Apple Mac System
Debugging and Testing Your Project
Debugging a Cordova Project Using Visual Studio Code
Migrating from Previous Versions
Migrating to Visual Studio Code Cordova Project
Using a Project Already Migrated to Visual Studio 2017
Migrating ePortal MDA Project Directly to a Visual Studio Code Cordova Project
Packaging your Cordova Hybrid App for Publishing to the App Store
iOS App ID
iOS Provisioning Profile
Submitting your App to the App Store
Build Your App for Release
iOS Distribution Certificate
Creating an App ID
Creating an iOS Provisioning Profile
Creating an App in iTunes Connect
Building and Packaging the Project in XCode
Submitting Your App to the App Store
Finalizing your Submission in iTunes Connect
Submitting your App to the Google Play Store
Code Signing for Android Applications
Google Play Developer Console
Creating an APK File
Troubleshooting
Cannot Load the MVC Single Page in the Browser Window while Debugging using Visual Studio Code
Cordova Application Fails to Build the iOS App Package Using Visual Studio Code
Unable to Access MVC Web Application from a Multi-Device Hybrid App
Unable to Debug on Android Platform
Unable to Launch the Application
Unable to Load a Standard Website in a WebView for iOS Platform
Unable to Load and Execute the Cordova Application on an iOS Simulator Using Visual Studio Code
Using the Information Center
Navigating through the Information Center
Searching for Information
Providing Feedback
Printing Information Center Topics
Navigating through the Information Center
Searching for Information
Providing Feedback
Printing Information Center Topics