•  Preface
  • Purpose
  • Audience
  • Organization
  •  Using this manual
    • Installation planning and performing
    • Configuration concepts
    • References to ABL compiler and run-time features
    • References to ABL data types
  • Typographical conventions
  •  Examples of syntax descriptions
    • Long syntax descriptions split across lines
    • Complex syntax descriptions with both required and optional elements
  • Example procedures
  •  OpenEdge messages
    • Obtaining more information about OpenEdge messages
•  Installation
  •  Windows Installation Requirements
    •  System requirements
      • Ensuring you have the most up-to-date system requirements information
      • Java considerations
      • Windows system requirements
    •  Supported platforms
      • Supported products by platform
      • Disk space requirements
    •  Server compatibility
      • OpenEdge clients
      • General connectivity and compatibility rules
      • OpenEdge SQL
      • Deployment rules supported by a DataServer broker
      • Development rules related to schema holder compatibility
      • Apache Tomcat
    •  Required third-party applications
      • Microsoft .NET Framework
      • Infragistics NetAdvantage
      •  DataDirect ODBC branded drivers
        • DataDirect SQL ODBC drivers
        • Installing the DataDirect branded ODBC drivers
        • Additional DataServer information for ODBC-related components
    • Licensing
  •  UNIX Systems Installation Requirements
    •  UNIX system requirements
      •  Requirements for using Java
        • JDK component
        • Java versions
        • OpenEdge products that require the JRE
        • Supported platforms with Java components
        • Operating systems and JDK and JRE version details
        • Support for 64-bit JVM
      •  Requirements for running OpenEdge applications
        • Product and application dependencies
        • File descriptors
    •  Supported platforms
      • Supported products by platform
      • Disk space requirements
    • Licensing
  •  OpenEdge Installation Prerequisites
    • Tasks overview
    • Gathering information to plan your installation
    • Determining your installation method
    •  Determining the type of installation
      • How product selection can affect your installation tasks
    • Obtaining an Electronic License Addendum file
    • Shared Network Installation utility
    •  Windows-specific installation considerations
      • OpenEdge working directory reminder
      • Read-only .dll and .ocx files
      •  Required software to run OpenEdge products or components
        • Microsoft Internet Explorer
        • Open Client Toolkit component
        • OpenEdge SQL
        • OpenEdge SQL ODBC and JDBC Clients
      •  Saving an existing OpenEdge or Progress installation in Windows
        • Resources to help you plan and save your current installation
        • Saving an existing installation
        • Existing JavaSoft (InstallShield) JDK
        • OpenEdge automatic save of properties files
      •  Reviewing the Windows installation directory structure
        • References to the Windows installation directory in this guide
      • Reviewing the Eclipse installation directory structure
      •  Integrating OpenEdge with Windows Explorer
        • OpenEdge file types
        • Icons
        • Shortcut menus
        • Properties
    •  UNIX-specific installation considerations
      • JDK and JRE considerations
      • Upgrading an existing OpenEdge or Progress installation on UNIX platforms
      •  Reviewing the UNIX system installation directory structure
        • References to the UNIX or Linux installation directory
    •  OpenEdge Replication
      • Installing OpenEdge Replication for the first time
      • Upgrading an existing version of OpenEdge Replication
    •  OpenEdge Management or OpenEdge Explorer
      • Installing OpenEdge Management or Explorer for the first time
      •  System requirements
        • Product support
        • Browser support
    •  Support for multiple Eclipse frameworks
      • Integration after installation
      • Service pack updates to plug-ins
      • Uninstall
    •  WebSpeed configuration choices
      • Developing Web applications with WebSpeed
      • Deploying Web applications with WebSpeed
    •  Accessing product documentation and samples
      • Accessing documentation and samples from the Progress Download Center
  •  Performing an OpenEdge Installation in Windows
    •  Installation overview
      • Loading the installation media
      • Performing the installation
      •  Finishing the installation
        • Using property information from a previous installation
      • Post Installation Considerations
    •  Running the Progress Dynamics Configuration Utility
      • Before you begin
      • Completing the DCU wizard
      • Editing Progress Dynamics files
      • Editing installed files
      • Editing the Progress Dynamics XML configuration file
      • Starting a development session
      • Stopping and restarting Progress Dynamics
      •  Updating session types
        • Customizing Progress Dynamics session types
      • Running the Entity Import tool
      • Recompiling application code
      • Setting up for Web development
    •  Additional product installation activities
      • Using an Electronic License Addendum file
      • Installing additional products
      • Installing additional components to previously installed products
      • Viewing registry information
      • Downloading executables for heterogeneous environments
      •  Configuring an Apache Tomcat Java Servlet Engine
        • Testing the configuration
    •  OpenEdge Silent installation overview
      • Selecting a data input option for a Silent installation
      •  Running the Silent installation
        •  Understanding the response.ini file contents
          • Response.ini sample excerpt
      • Checking the status of the Silent installation log file
      •  Optional data input activities
        • Creating a data input option
        • Manually modifying data input option
    • Performing postinstallation tasks
    •  Uninstalling OpenEdge in Windows
      • Using the Uninstall or Add/Remove Programs utility
      • Manually removing OpenEdge
    •  Sharing an OpenEdge installation on a network overview
      • Primary tasks
      • Networking overview
      • Determining a shared network to clients connection
      •  Setting up the shared network
        • Prerequisites
        • Performing a shared network installation
      •  Running the Shared Network Installation Utility to set up a client connection
        • Shortcuts
      • Reviewing local intranet security settings
    • Uninstalling the Shared Network Installation Utility
    •  Running the Silent installation option for the Shared Network Installation Utility
      • Creating a user-defined response file
      • Executing NetSetup with the Silent installation option
  •  Performing an OpenEdge Installation on UNIX or Linux
    •  Installation overview
      • Starting the installation process
      •  Performing the installation
        • Navigating though the Installation Utility
        • Accessing online help topics
        • Installation-related messages
        • Committing your installation choices
      • Finishing the installation
    •  Additional product installation activities
      • Using an electronic license addendum file
      • Installing additional products
      • Adding components to previously installed products
      • Downloading executables for heterogeneous environments
    •  OpenEdge Silent installation overview
      • Data input options for a Silent installation
      •  Understanding the response.ini file contents
        • Response.ini sample excerpt
      • Running the Silent installation
      • Checking the status of the Silent Installation log file
      •  Optional data input activities
        • Creating data input option
        • Manually modifying data input option
        • Addressing a detected JVM version
      •  Performing postinstallation tasks
        • Setting AdminServer security
      •  Performing a rolling upgrade of OpenEdge Management
        • Making port updates
        • Installing a new console
        • Upgrading a remote container
      •  Uninstalling OpenEdge on UNIX and Linux operating systems
        • Uninstalling OpenEdge Replication
        • Manually removing earlier OpenEdge versions
  •  Administration Utilities
    •  Using the License Update utility
      • Changes to accommodate license updates
    •  Displaying license information using the SHOWCFG utility
      •  Using the SHOWCFG utility in Windows
        • Details about SHOWCFG functions in Windows
      • Using the SHOWCFG utility on UNIX or Linux platforms
      • Displaying license information in Windows
    • Managing user licenses on all supported platforms
    •  Removing license for installed product
      • Removing license from Windows platform
      • Removing license from UNIX platform
    •  OpenEdge license information
      •  Using the OpenEdge license file
        • Reading the license file
        • Maintaining the license file
        • Creating a usage report
    •  Using OpenEdge resources in Windows
      • Shared memory
      • Processes on Windows and UNIX platforms
    •  Manage memory and system configurations on UNIX platforms
      • Calculating memory needs
      •  Managing shared memory and process resources
        • Shared memory
        • Processes on UNIX platforms
      • Reducing memory usage
      • Swap space
      • Shared memory and kernel configuration
    •  UNIX troubleshooting tips
      • Error messages
      • Altered or missing progress.cfg file
      • Tailoring startup scripts
    •  OpenEdge event logging
      • OpenEdge event log file
      •  Managing the OpenEdge event log file size
        • Remove old log entries
        • Truncate the database log file
        • Truncating a log file online
      •  Event logging in Windows
        • Managing OpenEdge events in Windows
        • Understanding the Windows Application Event Log components
        • Windows Event Log and registry
•  Configuration
  •  Working in the OpenEdge Environment in Windows
    •  Reviewing environment variables
      •  System environment variables
        • Latest information updates
      •  Java environment variables
        • JDKHOME
    •  Windows registry and the progress.ini file
      • Environment variables
      • Additional details for Java-related environment variables
    • Setting OpenEdge Program Item properties
    • Using the Proenv utility
    • Getting started with the AdminServer
    •  OpenEdge products supported by the AdminServer
      • AdminServer considerations
      • AdminServer group name conventions and restrictions
    • Creating and configuring an OpenEdge database server
    • Running OpenEdge
    • Maintaining OpenEdge and Progress
    • OpenEdge key and certificate stores
    •  Support for IPv6
      • Specifying IPv6
    •  Windows 64-bit
      • Notes for the 64-bit GUI client
      •  Application development and deployment
        • ABL Development
        • ABL Deployment
        • .NET Open Client development
        • Product and database interactions
  •  Working in the OpenEdge Environment on UNIX
    • Default environment variables settings
    • UNIX environment variables
    •  Setting Java environment variables
      • Setting the JDK environment variable
    • Setting SQL client environment variables
    • Using the Proenv utility
    •  Getting started with the AdminServer
      • OpenEdge products supported by the AdminServer
      • AdminServer considerations
      • How to implement the User-Group Authorization feature
    •  Understanding the built-in terminal definitions
      • Terminal issues
      • Terminal identifiers
      • Additional terminal identifier considerations
    • OpenEdge key and certificate stores
  •  Managing OpenEdge Key and Certificate Stores
    •  Managing key stores for OpenEdge servers
      •  Establishing a trusted SSL server identity
        • Supplying a key store entry password to an OpenEdge server
      • Using pkiutil to manage an OpenEdge key store
      • Understanding key store content
      • Using genpassword to obtain a key store password-encrypted value
    •  Managing certificate stores for OpenEdge clients and servers
      • Installing trusted CA/root certificates
      • Using certutil to manage an OpenEdge root certificate store
      • Using mkhashfile to install root certificates in the OpenEdge root certificate store
  •  Configuration
    • Introducing OpenEdge Management and OpenEdge Explorer
    •  Overview of OpenEdge Management or OpenEdge Explorer
      • Introduction
      • OpenEdge Management or OpenEdge Explorer elements and descriptions
      • Additional OpenEdge Management or OpenEdge Explorer considerations
      • Configure OpenEdge Explorer post installation
    •  Working with Unified Brokers
      • Running locally
      • Running remotely
      • Unified Broker common elements
      •  Using default sample brokers
        • Additional Unified Broker characteristics
      •  Configuring and starting Unified Broker instances
        • Prerequisites to configure and use Unified Broker products
        • How to configure and start up Unified Broker instances
    •  Understanding and using the AdminServer
      • Starting the AdminServer
      •  Stopping the AdminServer
        • Performing the task using PROADSV on UNIX
      •  Changing the default port
        • Performing the task from the Windows desktop
        • Performing the task using PROADSV on UNIX
      • Changing the startup setting
      • Running more than one AdminServer
      •  Querying the AdminServer
        • Additional AdminServer considerations
      •  AdminServer-related authorization option
        • AdminServer Logging
    •  Using OpenEdge Management or OpenEdge Explorer
      •  OpenEdge Servers supported by OpenEdge Management or OpenEdge Explorer
        • OpenEdge Management or OpenEdge Explorer capabilities
      • Saving configurations
    •  Mergeprop utility overview
      • Operating interfaces
      • Property value
      •  Using the mergeprop utility
        • Command syntax
      •  Mergeprop parameter details
        • Target file
        • Delta file
        • File type
        • Action switch
      • Mergeprop examples
      •  Java API details
        • Constructors
        • Methods
        • File type and action parameters
      •  Logical structure and syntax of property files
        • Property value formats
    •  Ubroker.properties file and product configurations
      • Unified Broker products and associated clients
      • Unified Broker installation prerequisites
      •  Ubroker.properties file structure
        • AdminServer and requirements to set an owner for the broker
        • Working with the supported products
        • Editing and validating the content of the ubroker.properties file
        • Guidelines for editing the properties file
      •  Specifying IP version for underlying Java code
        • Database connection notes
        • Log file updates
    • Command-line utilities reference
  •  Starting and Running OpenEdge
    •  Starting OpenEdge in Windows
      •  Startup and shutdown
        • Using the GUI interface
        • Using the command-line interface
      •  Starting OpenEdge as a Windows service
        • Using the OpenEdge Management or OpenEdge Explorer to connect to the AdminServer
      • Starting single-user OpenEdge in interactive mode
      • Starting single-user OpenEdge in batch or background mode
      •  Starting the multi-user server or broker
        • Using OpenEdge Management or OpenEdge Explorer to start the multi-user server process
        • Using the command line interface to start the multi-user server process
      •  Starting the multi-user server or broker as a Windows  service
        • Using OpenEdge Management or OpenEdge Explorer to start the multi-user server or broker
    •  Starting OpenEdge on UNIX platforms
      • Startup and shutdown commands
      • Starting single-user OpenEdge in interactive mode
      •  Starting single-user OpenEdge in batch or background mode
        • Redirecting Output
      • Starting the multi-user server or broker
    •  Running OpenEdge clients and servers on a network
      •  Using network startup parameters
        • Client network parameters
        • Server network parameters
      • Specifying the network type (-N)
      • Network addressing (-S and -H)
      •  Starting applications on a network
        • Starting network brokers and servers
        • Starting TCP/IP clients in Windows
        • Starting TCP/IP clients on UNIX
      •  Starting multiple brokers using the same protocol
        • Using the OpenEdge Management or OpenEdge Explorer to start multiple brokers
        • Using the command-line interface to start multiple brokers
      • Accessing a server behind a firewall
      • Starting and running multi-user OpenEdge in interactive mode in Windows
      • Starting and running multi-user OpenEdge in interactive mode on UNIX
      •  Starting and running multi-user OpenEdge clients in batch or background mode in Windows
        • Using the Client to start multi-user OpenEdge in batch or background mode
        • Using the command-line interface to start multi-user OpenEdge in batch or background mode
        • Using OpenEdge Explorer to start multi-user OpenEdge in batch or background mode
        • Starting and running multi-user OpenEdge clients in batch or background mode on UNIX
•  OpenEdge Products and Components
  •  OpenEdge Installation Products and Components in Windows
    •  OpenEdge installation options
      • Complete installation option
      • Custom installation option
    •  OpenEdge product components and subcomponents
      • 4GL Development System
      • AppServer Internet Adapter (AIA)
      • Client Networking
      • NameServer
      • NameServer Load Balancer
      • OpenEdge Adapter for Sonic ESB
      • OpenEdge Application Server—Basic
      • OpenEdge Application Server—Enterprise
      • OpenEdge DataServer for MS SQL Server
      • OpenEdge DataServer for ODBC
      • OpenEdge Development Server
      • OpenEdge Enterprise RDBMS
      • OpenEdge Personal RDBMS
      • OpenEdge Replication
      • OpenEdge Replication Plus
      • OpenEdge SQL Client Access
      • OpenEdge DataServer for Oracle
      • OpenEdge Studio
      • OpenEdge Ultra Controls
      • OpenEdge Workgroup RDBMS
      • Query/Results
      • Mobile REST Management Agent
      • Translation Manager
      • Visual Translator
      • Web Services Adapter
      • WebSpeed Messenger
      • WebSpeed Workshop
      • OpenEdge Management SE
      • Progress Developer Studio for OpenEdge
      • OpenEdge Business Process Modeler
      • OpenEdge Business Process Server
      • SNMP Adapter
      • OpenEdge TDE
      • OpenEdge Multi-tenant Table
  •  OpenEdge Installation Products and Components on UNIX
    •  OpenEdge installation options
      • Complete installation option
      • Custom installation option
    •  OpenEdge product components and subcomponents
      • 4GL Development System
      • AppServer Internet Adapter (AIA)
      • Client Networking
      • OpenEdge Replication
      • OpenEdge Replication Plus
      • NameServer
      • NameServer Load Balancer
      • OpenEdge Adapter for Sonic ESB
      • OpenEdge Application Server—Basic
      • OpenEdge Application Server—Enterprise
      • OpenEdge DataServer for Oracle
      • OpenEdge Development Server
      • OpenEdge Enterprise RDBMS
      • OpenEdge Personal RDBMS
      • OpenEdge Workgroup RDBMS
      • OpenEdge SQL Client Access
      • Query/Results
      • WebSpeed Messenger
      • Web Services Adapter
      • OpenEdge Management SE
      • SNMP Adapter
      • OpenEdge TDE
      • OpenEdge Multi-tenant Table
•  Preinstallation Checklist for Windows
  • Before you start
  • Products to install
  • Prerequisite third-party software (Windows 32-bit only)
  • Values from your existing OpenEdge installation (Windows 32-bit only)
  • Installation and working directories
  • Installation type
  •  Recommended and optional components
    • WebSpeed with local Web server, OpenEdge Adapter for Sonic ESB, and/or OpenEdge Explorer
    • Progress Dynamics(Windows 32-bit only)
  • Database
  • OpenEdge Adapter for Sonic ESB
  • Options to install your Progress Developer Studio for OpenEdge plug-ins to additional targets
  • Web server
  • Progress Dynamics (Windows 32-bit only)
  • Language in which online messages appear
  • Character set, date, and number formats
  • Web Services Adapter (WSA) (for OpenEdge SOAP Web Services)
  • Options to secure your AdminServer
  • OpenEdge Business Process Server
•  Preinstallation Checklist for UNIX
  • Before you start
  • Java platform requirements
  • Products to install
  • Values from your existing OpenEdge installation
  • Installation and working directories
  • Installation type
  • Database
  • OpenEdge Management or OpenEdge Explorer
  • OpenEdge Adapter for Sonic ESB
  • Web server
  • Language in which messages appear
  • Character set, date, and number formats
  • Web Services Adapter (WSA) (for OpenEdge SOAP Web Services)
  • OpenEdge Business Process Server
  • OpenEdge product scripts and program modules
  • Identical file exists in the installation directory
•  Command and Utility Reference
  •  Administering and configuring Unified Broker products
    • ASBMAN
    • DBMAN
    •  Mergeprop
      • Command switches and arguments
    • NSMAN
    • PROADSV
    • WTBMAN
  •  Installing and managing keys and digital certificates
    • certutil
    • genpassword
    • mkhashfile
    • pkiutil
•  OpenEdge National Language Support
  • Packaging
  • Directory structure
  • Contents of each directory
  • Implementing regional support
  • International databases
  •  Progress messages
    •  File protection
      • Details about the installation and update of PROMSGS files
      • Procedures to protect PROMSGS files from being overwritten
      • Procedures to ensure PROMSGS files are synchronized
  •  Environment variables of the SQL client
    • Code page client uses to display data
    • Code page client uses to display PROMSGS from the server
  • Regional parameter files
  •  Progress.ini file and the Windows registry
    • [Startup] and [WinChar Startup]
    • [fonts]
•  NameServer and NameServer Load Balancing Details
  •  NameServer overview
    •  Unified Broker and Name Server relationship
      • Application Services
      • The default service
    •  Configuring NameServer communications
      • Specifying NameServer ports and hosts
      • Editing the services file
  •  Understanding load balancing
    • Percentage weight factors
    • Arbitrary sum weight factors
    • Fail-over weight factor
  •  Understanding server-level and connection-level fault tolerance
    • Connection-level fault tolerance
    • Using UDP broadcasting
    •  Using NameServer replication
      • Determining the broadcast address
    • Using NameServer neighbors
    • Performance implications of broadcasting
  •  Configuring OpenEdge NameServer instances
    • Downloading NameServer executables
    • Order of configuration
    •  Configuring and using NameServer instances
      • How Unified Brokers use NameServer instances
      • NameServer instances and client connections
    • Configuring the NameServer in OpenEdge Management or OpenEdge Explorer
    • Starting and managing a NameServer using OpenEdge Management or OpenEdge Explorer
•  Configuration Models
  •  Shared-memory configurations
    •  Shared-memory architecture
      • Broker
      • OpenEdge Database Monitor utility
      • OpenEdge Watchdog utility
      • Background writers
  •  Client/server configurations
    •  Terminology
      • Application workstation
      • Database server machine
      • Network file server
      • Single-process database server machine
      • Multi-process database server machine
    • Simple client/server configurations
  •  Client/server and OpenEdge AppServer in the network environment
    • OpenEdge TCP network support
  •  Preparing to run OpenEdge on a TCP/IP network
    •  Installing OpenEdge on your TCP/IP network
      • Locating your database
  • Typical TCP/IP configuration with a hard disk on each machine
  • Setting up network files to run OpenEdge
  •  Configuring OpenEdge on a network operating system
    • Making network resources available
    • Setting network resource attributes
    • Granting user access rights
•  AdminServer Authorization and Authentication
  •  AdminServer logging details
    •  Log format
      • Log contents
  • Determine the data logged in the AdminServer log
  • Setting authentication option to start servers administered by the AdminServer
  • Setting authentication option to access sub-processes administered by the AdminServer