You can continue using existing Performance Cockpits in Performance Dashboard. You can continue using the existing cockpit definition files but the configuration files for the Performance Cockpit need to be adapted.
Warning
Performance Cockpit and Performance Dashboard are not approved for simultaneous installation and use within a common Tomcat instance.
Procedure
Back up the webapp directory in your Performance Cockpit installation.
Uninstall Performance Cockpit.
Upgrade your existing PPM installation.
Convert the databases for your PPM clients using the runppmconverter command line program.
Install Performance Dashboard. After installation, all clients are ready for use with Performance Dashboard.
Copy the configuration files (_conf.xml and _def.xml) for all required Performance Cockpits from the webapp directory you previously backed up to the relevant configuration directories for the corresponding PPM clients.
Adapt all _conf.xml files to the new format. Edit the files as follows:
Change the name of the DTD file from pcconfig.dtd to dashboardconfig.dtd. Change the line <!DOCTYPE pcconfig SYSTEM "pcconfig.dtd"> to <!DOCTYPE pcconfig SYSTEM "dashboardconfig.dtd">
Delete the cssfile XML attribute for the pcconfig XML element. Change the line <pcconfig cssfile="default.css"> to <pcconfig>
Transfer the data in the ppmconnection XML element to a new XML element called connection: Replace the line <ppmconnection client="<client name>" user="<User>" password="<password>" mvbaseurl="..." /> with <connection name="ppm" type="PPM" data_retrieval="by_connection_user"> <property name="corbaurl" value="pcapd.company.com:900" /> <property name="client" value="<client name>" /> <property name="user" value="<user>" /> <property name="password" value="<password>" /> </connection>
Assign at least one dashboard user the privilege for editing dashboards with Dashboard Builder by adding the admin="true" XML attribute, e.g., <user name="system" admin="true" />
Save the _conf file with the same base name as all _def files in which this _conf file is specified in the pcconfigfile XML attribute for the pcdefinition element.
The first time you launch the dashboard, the missing configuration file _properties.xml will be generated. You can continue using the definition files with no changes. The first time you save using Dashboard Builder, they will be converted to the new format.