Release Notes Postgres Enterprise Manager v3.0 Table of Contents I.Release Summary...1 II.New Features and Enhancements... 1 III.Postgres Enterprise Manager Architecture...3 IV.Installation, Pre-Requisites and Licensing...4 V.StackBuilder for PostgreSQL and StackBuilder Plus for Advanced Server... 5 VI.Internationalization / Localization...6 VII.Service Pack Maintenance (cumulative since v 2.0.2)...6 VIII.Documentation...7 IX.Platform Support... 8 X.System Requirements... 9 XI.Known Issues...9 XII.How to Report Problems... 9 I. Release Summary EnterpriseDB is proud to release another major upgrade to Postgres Enterprise Manager, a Postgres productivity tool designed to assist database administrators, system architects, and performance analysts in administering, monitoring, and tuning their PostgreSQL and Postgres Plus Advanced Server databases across large enterprises. Postgres Enterprise Manager has been architected to manage and monitor your database infrastructure anywhere from a handful to hundreds of servers all from a single console, allowing complete remote control over all aspects of your databases. II. New Features and Enhancements A. Merge with pgadmin v1.16 Copyright 2012 EnterpriseDB Corporation. All Rights Reserved. Page: 1
The PEM client now contains all the features and fixes of the latest release of pgadmin including the following highlights: Data Import Wizard Search for database objects by name Auto-refresh for objects when clicked in the object tree Security labels support Security barrier support Object type privileges support SSL compression option for SSL connections Copy table structure for New tables Support for optimized pg_dump/pg_restore options: Pre-data, Data, and Post-data For a complete list of updates see: http://www.pgadmin.org/development/changelog.php B. Web Client In addition to the current platform specific client that is part of PEM, there is now a web based PEM client providing you access to the monitoring capabilities of PEM from just about any browser on any device. C. Log Manager The Log Manager allows you to do bulk configuration of logging parameters (log file locations, logging frequency, log message selection, and log format) across all your servers, and optionally configure log collection into a central table in the PEM database. You then have a dashboard on which you can view the consolidated set of logs. D. SSH tunneling This feature allows machine-local settings for SSH tunneling of client connections to databases and PEM. By setting a hostname, username and password/certificate you will cause the client to open an SSH tunnel via the specified machine to the host/port in the main config for the server. This should provide easier access to the monitoring server from outside of the organization's firewall for authorized individuals. E. Detailed Global Alerts Global alerts now indicate which server or agent is down and/or not responding. Copyright 2012 EnterpriseDB Corporation. All Rights Reserved. Page: 2
F. Host System Details A table displaying details about the host's file system details" has been added to the Disk section of the OS dashboard. G. Processes Line Chart A line chart showing the number of processes over time has been added to the OS dashboard. III. Postgres Enterprise Manager Architecture Postgres Enterprise Manager is architected in a distributed fashion and contains the following three base components: Postgres Enterprise Manager Server responsible for a variety of administration functions, receiving information from all agents, and maintaining information in its repository. Postgres Enterprise Manager Client the user console from which all operations are carried out (e.g. database administration, viewing performance information, etc.) Postgres Enterprise Manager Agent responsible for performing tasks on each managed machine and collecting statistics for the monitored database server and operating system. In addition, there is an optional SQL Profiler server plugin component, which is installed separately similar to the three components listed above. A. Postgres Enterprise Manager Server This package (installed first) will install the Postgres Enterprise Manager Server. It creates the Enterprise Manager database in the database server (in normal mode PostgreSQL 9.2, in advanced mode a user selected database server) and starts the agent service on the pem-server host, which collects metrics for the OS and the PEM database server. Please see the Installation section below for more details on pre-requisites for installing the Server. B. Postgres Enterprise Manager Client This package will install the GUI client for Postgres Enterprise Manager. The client provides all the functionality of pgadmin 1.16, and adds supports for connecting to a Postgres Enterprise Manager server, allowing the user to manage servers centrally, configure monitoring and alerting, profile SQL workloads and browse dashboard pages showing useful graphs and statistics. The user can also run static configuration reports as well as reports against collected metrics. Copyright 2012 EnterpriseDB Corporation. All Rights Reserved. Page: 3
This release also introduces a web browser client that gets installed as part of the Server installation. The web client supports all the monitoring functionality of the GUI client. However at this time, the web client does not yet support all the database management features in the GUI client. C. Postgres Enterprise Manager Agent This package will install the Postgres Enterprise Manager agent. It creates and starts the agent service on each machine that the user wishes to manage with Postgres Enterprise Manager. The installation process requires the user to register the agent with an existing Postgres Enterprise Manager Server. Please see the Installation section below for more details on pre-requisites for installing the Agent. D. SQL Profiler PlugIn This package will create the files required to enable profiler logging against PostgreSQL v8.4 and higher or Postgres Plus Advanced Server v9 and higher. The database server requires a specific version of this installer. Postgres Plus Advanced Server 9.0 will ship with the SQL Profiler plugin already bundled and installed requiring only the configuration steps included in the Installation Guide. IV. Installation, Pre-Requisites and Licensing A. Postgres Enterprise Manager Installation Postgres Enterprise Manager installs quickly and easily through the use of click through graphical installers. The fastest and most trouble free way to install Enterprise Manager is to download and follow the instructions in the Postgres Enterprise Manager Installation Guide. The Installation Guide steps you through the installation of each base component in the most effective sequence and additionally provides tips to optimize each step for your installation. Finally, after completing the steps in the Installation Guide, your Enterprise Manager system will be configured, running and monitoring your managed hosts. The Postgres Enterprise Manager Installation Guide is available online at: http://www.enterprisedb.com/documentation/english and available in PDF format at: http://www.enterprisedb.com/postgres-enterprise-manager Please note that only an administrative or super user may run any of the Enterprise Manager installers. In addition, the installer can be launched on any platform using the command line. B. Pre-Requisites 1. Postgres Enterprise Manager Server: Copyright 2012 EnterpriseDB Corporation. All Rights Reserved. Page: 4
PostgreSQL 9.0.x or Postgres Plus Advanced Server 9.0.x or higher should be installed on the system using the EnterpriseDB installer. If not, the Enterprise Manager installer will install PostgreSQL v9.2.x for you. EnterpriseDB's Apache/PHP package should be installed on the system (recommended version: 2.2.22-5.4.5-1). If not, the Enterprise Manager installer will install/upgrade it for you. 2. Postgres Enterprise Manager Client: None for the GUI client. The web client requires one of the following internet browsers: - Chrome (21.0.1180.75) or higher - Firefox 12 or higher - Internet Explorer 9 or higher - Safari (5.1.5) or higher 3. Postgres Enterprise Manager Agent: There are no package dependencies for the agent. However a running PEM server instance must be accessible for installation to complete. 4. SQL Profiler PlugIn: C. Licensing PostgreSQL v8.4 or v9.x, installed using the EnterpriseDB installer. Note: the source code to the SQL Profiler Plugin is now available under a limited license to PEM product subscribers. This allows subscribers to use the SQL Profiler component of PEM with non-enterprisedb distributions of PostgreSQL. Subscribers under the direction of an EnterpriseDB technician can compile the source code against their version of PostgreSQL enabling the SQL Profiler to work correctly. To inquire if your distribution of PostgreSQL qualifies, contact EnterpriseDB Sales at US +1 781-357-3390 or 1-877-377-4352 ; EMEA +31 70 891 8451 ; Japan +81-3-5488-6007 ; UK +44 (0) 1235 227276 ; INDIA +91-20-30589500/01 Postgres Enterprise Manager is distributed and licensed by EnterpriseDB Corporation under a Limited Use License providing full functionality for evaluation purposes only, for a period of 45 days. When the evaluation period ends, the Enterprise Manager Client user interface features will operate with reduced functionality, however, the agents on your managed hosts will continue to collect data without interruption or loss of information. To use Enterprise Manager beyond the evaluation period in a production environment you are required to purchase a software subscription from EnterpriseDB. With the purchase of a subscription you will receive a product key, which when applied to the Client, will restore it to a fully Copyright 2012 EnterpriseDB Corporation. All Rights Reserved. Page: 5
functional state. To apply a Product Key, start the Postgres Enterprise Manager Client program and select Register PEM from the About menu. To purchase a subscription, contact one of the EnterpriseDB offices listed here: http://www.enterprisedb.com/company/offices V. StackBuilder for PostgreSQL and StackBuilder Plus for Advanced Server The three base components for Postgres Enterprise Manager are now available through either StackBuilder or StackBuilder Plus. These components may also be downloaded individually from the EnterpriseDB website at: http://www.enterprisedb.com/download-postgres-enterprise-manager. A. Update Monitor Update Monitor will notify you when new updates are available for any of the installed components. Note that Update Monitor is only available to subscribers of Postgres Plus Advanced Server or the EnterpriseDB Solution Pack for PostgreSQL. VI. Internationalization / Localization Postgres Enterprise Manager is not yet localized into any language except English. Localization will be available in a subsequent release, the timing of which has not yet been determined. VII. Service Pack Maintenance (cumulative since v 2.0.2) A. Client 1. Merged with pgadmin v1.16. 2. The initial Trace Filter dialog size partially obscures buttons on Windows. This has been fixed. (21020) 3. Child metrics in the Capacity Manager are not sorted correctly. This has been fixed. (21865) B. Server 1. The PEM enterprise server now installs PostgreSQL v9.2.1 by default. 2. The PEM enterprise server may now be installed using Postgres Plus Advanced Server as the backend data store. (21823) The alert name for SNMP traps was not included in the event. This has been fixed. (21374) C. Agent 1. A sporadic crash of the agent monitoring the PEM enterprise server was fixed. (21866) Copyright 2012 EnterpriseDB Corporation. All Rights Reserved. Page: 6
VIII. 2. The agent service is not started after installation on Windows XP. This has been fixed. (19896) D. SQL Profiler 1. The SQL Profiler could not use the Index Advisor properly with PREPARED STATEMENTS causing an error. This has been fixed. (19852) 2. An index error while using the SQL Profiler has been fixed. (20661) 3. ERROR: oidvector has too many elements. This has been fixed. (21689) E. Installers 1. Various files and directories were not being cleaned up properly during uninstallation. These have been fixed. Documentation Postgres Enterprise Manager has a comprehensive and detailed suite of documentation provided in extremely friendly and convenient formats. A. Installation Guide The installation Guide provides step-by-step guided instructions to installing and configuring each component including the Agents to monitor each host, the Enterprise Manager Server to store monitored data, the GUI Client to administer and view monitoring data, and the SQL Profiler for finding and tuning your slower running SQL statements. The Postgres Enterprise Manager Installation Guide is available online and downloadable PDF format at: http://www.enterprisedb.com/documentation/english B. Getting Started Guide The Getting Started Guide provides an introduction to Postgres Enterprise Manager and is written to acquaint you with the basics of operating the agents and server, performance monitoring and management, capacity planning, SQL profiling and analysis, and best practices to help you be successful in your database management activities. While not a comprehensive resource that completely explains all the features and functionality of Postgres Enterprise Manager, it does serve as an aid to help you evaluate the tool and get you up to speed with the basics of how to use the product quickly. For detailed information on product features, please use the Postgres Enterprise Manager s offline documentation available through the Client GUI. The Postgres Enterprise Manager Getting Started Guide is available online and downloadable PDF format at: http://www.enterprisedb.com/documentation/english Copyright 2012 EnterpriseDB Corporation. All Rights Reserved. Page: 7
C. Offline Documentation The bulk of Enterprise Manager s documentation is conveniently installed on the Client host machine and provided as HTML based context sensitive help from within the Client graphical user interface. Any time you need help with a particular feature or task in the Enterprise Manager Client you can get detailed help documentation by accessing the Help menu. D. Popup Help To assist users in understanding what various graphs and charts display on dashboards, a popup help bubble appears when the mouse cursor passes over areas of your screen. E. Postgres Expert Postgres Expert is a user selectable task in the Enterprise Manager Client that checks various characteristics of your target databases and reports back a description of what it reviewed along with recommendations for changes based on best practices collected and written by database experts at EnterpriseDB. The Postgres Expert component is accessed by choosing the Management- >Postgres Expert menu option and following the wizard prompts. IX. Platform Support Each component of Enterprise Manager is supported on various platforms as noted below. A. Enterprise Manager Server The Server is supported on the Postgres Plus Advanced Server and PostgreSQL Linux, Solaris and Windows server platforms for review at the following URLS: http://www.enterprisedb.com/advanced-server-platforms-lifecycles http://www.enterprisedb.com/postgresql-platforms-lifecycles B. Enterprise Manager Agent The Agent is supported on the Postgres Plus Advanced Server and PostgreSQL Linux, Solaris and Windows server platforms for review at the following URLS: http://www.enterprisedb.com/advanced-server-platforms-lifecycles http://www.enterprisedb.com/postgresql-platforms-lifecycles The Agent can monitor: PostgreSQL versions 8.2.x and higher Postgres Plus Advanced Server versions 8.3.xr2 and higher Copyright 2012 EnterpriseDB Corporation. All Rights Reserved. Page: 8
C. Enterprise Manager Client The Client is supported on the Postgres Plus Advanced Server and PostgreSQL Linux and Windows server platforms as well as the Windows client platforms as follows: CentOS, RHEL, Fedora, opensuse, SLES, Ubuntu, Win2008, Win2003, Windows 7, Windows Vista, and Windows XP. D. Enterprise Manager SQL Profiler PlugIn The SQL Profiler plug-in is supported with EnterpriseDB distributions of Postgres Plus Advanced Server and PostgreSQL on: CentOS, RHEL, Fedora, SLES, opensuse, Ubuntu, Win2008, Win2003, Solaris 10 x86, Solaris 10 SPARC and HP-UX. X. System Requirements A. Enterprise Manager Server Minimum hardware requirements for running the Postgres Enterprise Manager Server are: 1 GHz processor 1024 MB of RAM 256 MB of HDD plus space for your data B. Enterprise Manager Agent Same as the target database server instances on the managed host. C. Enterprise Manager Client 1GHz CPU 512 MB RAM D. Enterprise Manager SQL Profiler Plugin XI. Known Issues Same as the database server on the profiled host. A. Enterprise Manager Server SMTP alerts do not work with Hotmail's and Yahoo's SMTP server. B. Enterprise Manager Agent n/a Copyright 2012 EnterpriseDB Corporation. All Rights Reserved. Page: 9
C. Enterprise Manager Client n/a D. Enterprise Manager SQL Profiler PlugIn n/a XII. How to Report Problems To report any issues you are having please contact EnterpriseDB s technical support staff: Email: support@enterprisedb.com Phone: +1-732-331-1320 or 1-800-235-5891 (US Only) Copyright 2012 EnterpriseDB Corporation. All Rights Reserved. Page: 10