This document contains important information that was not included in the productspecific documentation for this release. These release notes provide information about enhancements and resolved problems. Important: Please read the entire release notes document before proceeding. If you are installing a PROS product for the first time, see the PROS Pricing Solution Suite Installation and Maintenance Guide for complete installation instructions. This document contains the following topics: 1. New Features ........................................................................................... 3 2. Resolved Issues ........................................................................................ 5 3. Open Issues ........................................................................................... 10 4. Configuration Changes ............................................................................. 10 5. Task Changes ......................................................................................... 11 6. System Parameter Changes ...................................................................... 11 7. Third-Party Software ............................................................................... 11 8. PROS Software Dependencies ................................................................... 12 9. To Upgrade an Existing Installation for Microsoft Windows............................. 12 10. To Upgrade an Existing Installation for UNIX ............................................... 16 11. Database Configuration ............................................................................ 20 12. Start the PROS Application ....................................................................... 25 13. Create a Shortcut on the Desktop .............................................................. 27 14. Uninstall ................................................................................................ 28 15. Contacting PROS ..................................................................................... 29
Typographic Conventions The following typographical conventions are used in this document. Type style or symbol
Bold
Text
Commands in code, menu commands, and toolbar buttons Variables, command-line placeholders
Examples
set echo on;
Italic
% chmod 600 <file_name> Note: Remove the < > placeholder symbols when you insert the variable name.
Monospace
Code examples
env.bat
1.
New Features
Description
Frequency Analysis This table provides multi-dimensional insight into a set of transactions by showing the most frequently observed context dimension values or by showing the breakdown of a measure across each dimension.
Module
Analytics
DEV105685
Key Performance Indicator Enhancements The Key Performance Indicator table now shows the prior period's measure value in addition to the selected period's value. The table has also been converted to Adobe Flash.
Analytics
DEV105687
Band Analysis on Row Measures You can now band the x-axis by using row-based measures. Row-based measures may also be used on the left and right yaxes. This capability expands the set of measures used beyond basic measures.
Analytics
DEV107432
Pricing Analytics Optionally Leverages the SAP Product Hierarchy Dimension Pricing Analytics is now configurable to leverage the SAP Product Hierarchy Dimension. The application transforms the mixed-level hierarchy into a hierarchy with products at consistent levels.
Analytics
DEV108151
Color Coding by Dimension The scatter plot chart now offers color coding based on dimension. This feature provides the benefit of enhanced visualization of points that share a common dimension.
Analytics
DEV108157
Default Log Scale On/Off State Configurable for Scatter Charts This enhancement provides the ability to configure the log scale on/off state for each measure on a chart. Some measures may always require a log scale so that the ability to turn log scaling on by default is now offered.
Analytics
DEV105491
View Pricing for Products Identified by Alerts This feature enables users to navigate directly from the triggered alerts screen to change prices.
Execution
DEV105802
Enhanced Approval Workflow Configuration to Enable Deals to Be Auto-Published The approval workflow now supports the configuration of autoapproval and auto-publishing by deal type. If configured, a deal can be automatically approved and published upon submission if it meets pre-determined thresholds.
Execution
ID
DEV106293
Description
Classify a Price Action The user can select and classify the type of price changes from a drop-down list that is set up in the system. The list is controlled by the customer. Examples: Liquidation, competitor match, and so forth
Module
Execution
DEV106362
Enable and Display Manual Intraday Price Changes With PROS Pricing Solution Suite, pricing analysts can now create intraday prices and set effective times of day for those prices. Price lists show effective times of day for intraday price changes in addition to effective dates.
Execution
DEV107027
Apply Work Team Security to View and Edit Lookups PROS Pricing Solution Suite now enables designated users to include pricing area as a dimension for lookups. When a pricing area is defined for a lookup, only users whose work teams include the pricing area can view and modify the lookup.
Execution
DEV107032
Apply Security to View and Edit Lookup Definitions PROS Pricing Solution Suite now gives designated users the ability to assign roles directly to a lookup definition. Only users with a role assigned to the lookup definition can view it, edit its configuration options, and create lookups.
Execution
DEV107044
Consistency of Reference Drop-Down Values with SAP Formula Elements in Deal Manager With this enhancement, any Deal Manager changes to the reference values in one formula element of an SAP formula strategy will propagate to all other formula elements within that strategy. This propagation ensures that the reference values are consistent for the entire SAP formula.
Execution
DEV107046
Allow Status Changes on Deal Detail Users can now change the status of a deal from the Deal Detail screen. This allows a deal to be quickly submitted into the approval workflow immediately after it is created. This capability also enables managers to view the details of a deal and approve or reject it easily from the same screen.
Execution
DEV107196
Price Modification Options Secured Administrators can now block or permit users from making specific kinds of price modifications. For a user to modify prices in a specific way, such as changing by a specified percentage, the user's role must contain the privilege for making that kind of modification.
Execution
DEV107238
Deal Detail Auto-Approval Feedback If an automatic approval workflow is configured, the user will see immediately after submitting a deal whether it was approved or rejected based on the pre-determined thresholds.
Execution
ID
DEV107451
Description
Reference Strategy Elements from Price Routine This enhancement allows users to configure price routine elements to reference specific strategy elements. This allows users to see certain strategy element metrics in the price routine and to view these metrics at the deal level.
Module
Execution
DEV107477, DEV107478
Customer Agreement Output With this feature, PROS Pricing Solution Suite can present approved and accepted deals and related pricing decisions with all relevant contexts, including customer and customer attributes, deal header level information, deal line-item level information and contexts, and prices and pricing adjustments related to each deal line item. Defining Data Values by Pricing Area for SAP Formula Reference This enhancement allows users to define SAP formula reference data values by Pricing Area through the SAP formula reference data interface.
Execution
DEV107590
Execution
DEV107816
Automatically Send Customer Agreements and Automatically Approve Pricing Manager Prices Sent through Deal Manager When a deal is published, PROS Pricing Solution Suite will automatically present the customer agreement and the prices of the line items within that deal to the Enterprise Resource Planning (ERP) system. In addition, users now have the ability to send the customer agreement for a specific deal through Deal Manager.
Execution
DEV108044
Line-Added Date Function for Strategy Formulas A new date function, LINEADDED_DATE(), allows users to reference the date that a line item was added to a deal. By using LINEADDED_DATE() instead of CURRDATE() in strategy formulas, the user is able to freeze specific strategy elements in order to prevent recalculation of certain values.
Execution
DEV108350
Triangular Currency Conversion Through this enhancement, it is no longer necessary to have data for every possible currency combination. PROS Pricing Solution Suite can perform currency conversions for any two currencies if the effective exchange rates are available between each of these currencies and a pre-defined global currency.
Execution
DEV108486
Product List and Deal Summary Configuration The metrics in the Deal Summary section can now be configured to calculate a weighted average from the line items within a deal. The user is able to select the unit of measure for conversion purposes, if necessary.
Execution
2.
Resolved Issues
Support ID incident
Description
Module
Analytics
DEV107373 disableTransactionList Attribute Error The view transaction list feature is now disabled for charts that are based on a virtual cube. DEV107534 Selecting a Group Based on Multiple Dimensions Returns No Data on Time Series The time series chart now correctly processes results when the reporting scope, or dimension grouping, is set on more than one dimension. DEV108883 Scatter and Bubble Charts There is a significant performance improvement for Scatter and Bubble charts, especially for cubes with a large number of dimensions.
Analytics
Analytics
Support ID incident
SPRT05221 DEV108960
Description
You are not logged in and Data retrieval error Errors Several minutes after starting a complex query, report, or chart in Analytics, an error messageYou are not logged in or Data retrieval erroris displayed. There are a two known causes of this problem. 1. On some end-user systems, a registry key has been set that specifies a timeout that limits how long the browser will wait to receive a response. If this timeout is specified and is too short to allow PROS Pricing Solution Suite to process the request, the error will occur. There are two possible places that this registry key may be specified: HKEY_CURRENT_USER\Software\Microsoft\ Windows\CurrentVersion\Internet Settings or HKEY_LOCAL_MACHINE\Software\Microsoft\ Windows\CurrentVersion\Internet Settings If both are specified, the value in HKEY_CURRENT_USER takes precedence. In either of these registry keys, a DWORD Value named ReceiveTimeout may specify the timeout in milliseconds. If this the case in your environment, PROS recommends changing the timeout value to a larger value, for example 1800000 (30 minutes) to avoid the timeout error. Another alternative is removing the registry setting to allow the default setting of one hour to take effect. See http://support.microsoft.com/kb/181050 for more information. (Note that although this Microsoft Knowledge Base article indicates that it does not apply to Microsoft Internet Explorer 6.x and 7.x, PROS has confirmed that it does apply.) 2. Another possible cause of this error is that your environment has configured a firewall or proxy that is monitoring communications between the enduser browser and the PPSS application server, and that firewall or proxy has a timeout specified that terminates the connection when a request is not processed within that timeout. If this is the case in your environment, you can change the firewall or proxy configuration to increase the timeout to 30 minutes or longer to avoid the timeout error.
Module
Analytics
Support ID incident
Description
Module
Analytics
DEV109108 Time Series Performance There is a significant performance improvement for Time Series charts. SPRT04853 DEV107613 PopulatePxInputCondData Task
Execution
The StackOverflowError message is no longer displayed when copying a strategy for which the price domain cannot be determined.
SPRT04932 DEV107847 Hidden Flags Are Reset When Deleting a Strategy Execution
Element Now, when deleting a strategy element, the hidden flags of other elements are not reset.
SPRT05119 DEV108558 User Interface Performance Improvement Execution
There is improved performance of the user interface for a user who is assigned a workteam with multiple level definitions.
DEV109352 Enable the User to Change a Version's Start and End Execution
Dates If the end date of a deal is earlier than the current date, the user is unable to update the deal. The current rules for updating the dates of a deal prevent the user from changing the start and end dates of the deal. To avoid this limitation, the user should select an end date for a deal that will safely cover the negotiation period. The user can complete negotiation, and then change the end date to the current deal end date.
DEV109354 Copying a Deal with Different Start and End Dates Does Execution
Not Affect the Copied Line Items Dates When a deal is copied, the dates of the copied line items remain unchanged; those dates are not changed to the dates of the set for the new deal. To change these dates, the user must open the deal, and then change the dates of each line item to the dates of the new deal. Note: The strategies selected for each line item on the copied deal may not be valid for the new date range. Because of this, when the dates for the line item are changed, a price may not be calculated for this line item.
Support ID incident
N/A DEV94164
Description
Internet Explorer 6.0 SP1 terminates when accessing the application menu or context bar. There is a known bug related to the 918899 Windows update patch. This patch was included in updates released on or after August 8, 2006. More information on the patch can be found at http://support.microsoft.com/kb/918899 Please perform one of the following options: (Recommended) Install the most current cumulative security update for Internet Explorer 6, dated November 2006 or later. For example, the 922760 cumulative security update released in November 2006 corrects the issue. Information about how to obtain and install this update can be found at http://support.microsoft.com/kb/922760 Note: Restart the system after installing the update. or Install the 923996 update patch. This update fixes the specific problem in the 918899 update patch. Information about how to obtain and install this update can be found at http://support.microsoft.com/kb/923996 Note: Restart the system after installing the update. or Remove the 918899 update. Perform the following steps to remove the Microsoft Windows update patch: 1. From the Control Panel, click Add or Remove Programs. 2. The Add or Remove Programs pop-up window is displayed. 3. Click the Show updates check box located at top of the screen. 4. Scroll down to Windows XP update > Security update for windows XP KB918899. Click Remove. 5. Follow the instructions on the Software Update Removal wizard to remove the patch. Note: Restart the system after removing the update.
Module
General
3.
Open Issues
Description
Module
There is an inconsistency between the benchmark values in the Analytics waterfall chart and the table. Clicking the Help icon on the Alert definition screen causes an error to display. In some instances, Flash charts that are operating correctly stop unexpectedly on a users machine. The current resolution is to clear cache and cookies in Internet Explorer. Users are unable to choose a product group with more than 1,000 products if the system is using an Oracle database. Analytics Analytics
DEV105986 DEV106982
Execution
Internet Explorer is leaking memory while including application General Java script files. An issue has been raised with Microsoft to determine if there is an Internet Explorer or Windows patch to resolve the problem.
4.
Configuration Changes
There are pros.dtd file changes for version 3.7.5. This file is located in the <PPSS_installation_directory>\build\config (Windows) and <PPSS_installation_directory>/build/config (UNIX) directories. Property
Added The DataMapper service is now contained within Tomcat. This property may be removed. To ensure that adequate memory is available for Tomcat, add the memory previously allocated for the DataMapper service to the memory for Tomcat.
Description
DataMapper_jvmmemory
10
5.
Task Changes
6.
7.
Third-Party Software
The following third-party software must be installed before proceeding with the installation of the new release. Environment Component Platform
HP PA_RISC, HP Itanium2 Sun Solaris IBM AIX LINUX Windows Sun Java Server Development Kit 1.5.0_11 1.5.0 1.5.0_11 1.5.0_11 Do not use 1.5.0_07 or 1.5.0_08. build pap64dev-20070201 (SR4) or higher LINUX Do not use patch 7,8, or 9. Important: jdk1.5.0_11 must be created off the root of C:\ under a directory without spaces in it. For example: C:\Java\jdk1.5.0_11 A system environment variable must be created for JAVA_HOME with this value. Also, the PATH environment variable must include this at the beginning of the values, with the \bin directory appended. For example: C:\Java\jdk1.5.0_11\bin Desktop Microsoft Internet Explorer Windows 6.0
Version
1.5.0_04
Notes
TZupdater 1.0.2 applied
11
Environment
Component
Platform
Version
Notes
Important: If company practice is to initiate all installations, request that IT install the scable vector graphics plug-in. If this is not done, Internet Explorer runs a check to verify whether or not the plug-in is installed. If the plug-in is not installed, an installation pop-up window is displayed Important: If company practice is to initiate all installations, request that IT install the Flash plug-in. If this is not done, Internet Explorer runs a check to verify whether or not the plug-in is installed. If the plug-in is not installed, an installation pop-up window is displayed.
Desktop
Windows
3.03
Desktop
Adobe Flash
Windows
9.0
8.
9.
All commands are run from the Command Prompt window. You can open the window by selecting Start => Run and typing cmd in the text box.
12
13
Leaving the contents of <PPSS_previous_installation> intact and installing the new version in a different directory.
or
Saving the directory structure into a zip or tar file archive, if your file system has the available space. The space required varies, depending on the size of the log and data loader directories.
14
pros.dtd server.xml emailer_control.xml 1. Change to the <PPSS_installation_directory>\build\config directory. cd <PPSS_installation_directory>\build\config 2. Copy the pros.dtd from the <PPSS_previous_installation>\build\config directory. copy <PPSS_previous_installation>\build\config\pros.dtd . 3. Change to the <PPSS_installation_directory>\tools\tomcat<version_number> \conf directory. cd <PPSS_installation_directory>\tools \tomcat<version_number>\conf 4. Copy the server.xml file from<PPSS_previous_installation>\tools \tomcat<version_number>\conf. copy <PPSS_previous_installation>\tools \tomcat<version_number>\conf\server.xml . 5. Change to the <PPSS_installation_directory>\build\config\emailer directory. cd <PPSS_installation_directory>\build\config \emailer 6. Copy emailer_control.xml from the <PPSS_previous_installation>\build\config\emailer directory. copy <PPSS_previous_installation>\build\config\emailer \emailer_control.xml . Note: Verify that the paths in pros.dtd are updated and point to the current directory.
15
3. Download the PPSS_3_7_5.tar.gz file in binary mode. 4. Transfer the gz file to the target server.
17
1. Back up your database. 2. Back up the current version of the code by: Leaving the contents of <PPSS_installation_directory> intact and installing the new version in a different directory.
or Saving the directory structure into a zip or tar file archive, if your file system has the available space. The space required varies, depending on the size of the log and data loader directories.
pros.dtd server.xml emailer_control.xml 1. Change to the <PPSS_installation_directory>/build/config directory. cd <PPSS_installation_directory>/build/config 2. Copy the pros.dtd from the <PPSS_previous_installation>/build/config directory. cp <PPSS_previous_installation>/build/config/pros.dtd . 3. Change to the <PPSS_installation_directory>/tools/tomcat<version_number> /conf directory. cd <PPSS_installation_directory>/tools /tomcat<version_number>/conf 4. Copy the server.xml from <PPSS_previous_installation>/tools /tomcat<version_number>/conf. cp <PPSS_previous_installation>/tools /tomcat<version_number>/conf/server.xml . 5. Change to the <PPSS_installation_directory>/build/config /emailer directory. cd <PPSS_installation_directory>/build/config/emailer 6. Copy emailer_control.xml from the <PPSS_previous_installation>/build/config/emailer directory. cp <PPSS_previous_installation>/build/config/emailer /emailer_control.xml .
Note: Verify that the paths in pros.dtd are updated and point to the current directory.
1. Copy the SCF to the <PPSS_installation_directory>/scf folder. For example: cp <download_directory>/<your_config_file>.xml . 2. Edit the pdk.properties file in $HOME/pdk.properties. Review the Configuration Changes section for new or changed parameters. See the PROS Pricing Solution Suite Installation and Maintenance Guide for details about the parameters. 3. From the Command Prompt window, change to the PROS Pricing Solution Suite installation directory. cd <PPSS_installation_directory> 4. Run the configure.sh <scf_location> command. For example: ./configure.sh scf/<your_config_file>.xml 5. Monitor the configure.log file for errors.
20
For SQL Server To create the SQL Server data source file, run the following command: createSqlServerDS.bat PDK_DS You will be prompted for the user name and password of the database for the application.
For Oracle To create the Oracle data source file, run the following command: createOracleDS.bat PDK_DS You will be prompted for the user name and password of the database for the application.
For SQL Server To create the SQL Server data source file, run the following command: ./createSqlServerDS.sh PDK_DS You will be prompted for the user name and password of the database for the application.
For Oracle To create the Oracle data source file, run the following command: ./createOracleDS.sh PDK_DS You will be prompted for the user name and password of the database for the application.
21
For Windows, perform the following: Edit the <PPSS_installation_directory>\build\config\pros.dtd file and set the patchmode parameter to true: <!ENTITY patchmode "true">
For UNIX, perform the following: Edit the <PPSS_installation_directory>/build/config/pros.dtd file and set the patchmode parameter to true: <!ENTITY patchmode "true">
For Windows, perform the following steps: 1. Change to the bin directory. cd <PPSS_installation_directory>\build\bin 2. Choose one of the following according to your environment: If only Pricing Analytics is installed, run the following command: runPricingAnalyticsOnlyPatch375.bat If both Pricing Analytics and Pricing Execution are installed, run the following command: runPricingPatch375.bat 3. Review the following log files for any possible errors. Errors must be reviewed and corrected before continuing with the installation process. Pricing Analytics log files PricingPatch370-3.0.28_to_3.0.29-TaskSql.txt PricingPatchAnalytics375-TaskSql.txt
22
For UNIX, perform the following steps: 1. Change to the bin directory. cd <PPSS_installation_directory>/build/bin 2. Choose one of the following according to your environment: If only Pricing Analytics is installed, run the following command: ./runPricingAnalyticsOnlyPatch375.sh If both Pricing Analytics and Pricing Execution are installed, run the following command: ./runPricingPatch375.sh 3. Review the following log files for any possible errors. Errors must be reviewed and corrected before continuing with the installation process. Pricing Analytics log files PricingPatch370-3.0.28_to_3.0.29-TaskSql.txt PricingPatchAnalytics375-TaskSql.txt Pricing Execution log files PricingPatch375-1TaskSql.txt PricingPatch375-2TaskSql.txt
23
For Windows, perform the following steps: 1. Change to the bin directory. cd <PPSS_installation_directory>\build\bin 2. Run the LoadSecurity task. runTask.bat LoadSecurity 3. Review the following log files to monitor the progress of the task and to check for any possible errors. Errors must be reviewed and corrected before continuing with the installation process. prosservices_serverX_log.xml runPROSServices-X.txt runTaskManager-1.txt taskmanager_server1_log.txt
For UNIX, perform the following steps: 1. Change to the bin directory. cd <PPSS_installation_directory>/build/bin 2. Run the LoadSecurity Task. ./runTask.sh LoadSecurity 3. Review the following log files to monitor the progress of the task and to check for any possible errors. Errors must be reviewed and corrected before continuing with the installation process. prosservices_serverX_log.xml runPROSServices-X.txt runTaskManager-1.txt taskmanager_server1_log.txt
24
For Windows, perform the following: Edit the <PPSS_installation_directory>\build\config\pros.dtd file and set the patchmode parameter to false. Enter <!ENTITY patchmode "false">
For UNIX, perform the following: Edit the <PPSS_installation_directory>/build/config/pros.dtd file and set the patchmode parameter to false. Enter <!ENTITY patchmode "false">
For Windows, enter 1. Change to the bin directory. cd <PPSS_installation_directory>\build\bin 2. Start the application. prosctl start
25
2. Start the application. ./prosctl start For a multi-host configuration, the following procedure must be performed on the master host and each of the worker hosts.
For Windows, enter 1. Change to the bin directory. cd <PPSS_installation_directory>\build\bin 2. Start the application. To run the following script on the master host, enter startPROSLauncherAgentMaster.bat To start PROS Pricing Solution Suite launcher components on each worker host, enter startPROSLauncherAgent.bat On the master host, run the following script: prosctl start
For UNIX, enter 1. Change to the PROS bin directory. cd <PPSS_installation_directory>/build/bin 2. Start the application. To run the following script on the master host, enter ./startPROSLauncherAgentMaster.sh To start PROS Pricing Solution Suite launcher components on each worker host, enter ./startPROSLauncherAgent.sh On the master host, run the following script: ./prosctl start
26
27
14. Uninstall
Use the following procedure to uninstall this product and to revert to the previously installed version: 1. Stop the application as described in Stop the PROS Application. 2. Restore the database and the list of files using the backup files, as described in Back Up the Previous Version. 3. Back up the previous version to the original location. 4. Start the application, as described in Start the PROS Application.
28
PROS Product Information Phone FAX Web Address 713-335-5151 713-335-8144 http://www.prospricing.com
Copyright 2007 PROS Revenue Management, L.P. All information contained within this document is the confidential property of PROS. It is submitted with the understanding that it shall not be disclosed to any third party either in whole or in part without the prior written consent of PROS. No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, photocopying, or otherwise, without the prior written permission of PROS. PROS makes no representations or warranties with respect to the contents hereof and specifically disclaims any implied warranties of merchantability for any particular purpose. Furthermore, PROS reserves the right to revise this publication and to make changes in content hereof without obligation of PROS to notify any person of such revision. Trademarks All other brands and their products are trademarks or registered trademarks of their respective holders and should be noted as such. This product includes software developed by the Apache Software Foundation (http://www.apache.org/).
29