Creating a Session

Before you begin

A remote C/C++ project is required.

About this task

Sessions store and organize the results of several performance tuning Activities. A Session must be created before any Activities are created.

Procedure

  1. Make sure the Performance Tuning perspective is open.
  2. Right click the Sessions node in the Performance Explorer view and select New Session.

    The New Performance Tuning Session Wizard will open.

  3. Enter a name for the new Session.
  4. Select a remote C/C++ project.
  5. Select a remote context for the project, consisting of the build host and project location. This should be the context that is used to build the application, and is where the application's source code can be found (if available).
  6. If the build host will also be used to run the application then leave Same as build host checked. If the application will be run on a different host then uncheck the box and select the runtime host. If the desired runtime host is not listed then cancel the wizard, create a connection to the runtime host, and then open the New Performance Tuning Session Wizard again.
  7. Select a folder on the runtime host where temporary files will be stored during the performance run. These files will be automatically deleted after the performance run completes.
    1. Click the Use Default button to select the default location for the user account on the runtime machine.
    2. Click the Browse button to select a specific location.
  8. Click Next.

    The second page of the wizard is used to enter the executables and shared libraries that make up the application. This page is optional, however it is strongly recommended to enter this information because it will help produce useful feedback on how to increase the application's performance.

  9. Add executables by clicking the Add button next to the Executables list.

    Many applications consist of a single executable, however if your application consists of multiple executables then please enter them all.

  10. Add shared libraries by clicking the Add button next to the Shared Libraries list.

    Enter the shared libraries that are built along with the application for which you would like to collect performance data. It is not necessary to list 3rd party or system libraries.

  11. Click Next.

    It is recommended to begin performance tuning by running a System Scorecard Activity. This Activity will: 1) validate the runtime host by checking for the required system tools and 2) provide suggestions for configuration changes that can increase the application's performance.

  12. Select the minimum platform on which the application is expected to run. Select Auto if you are not sure what the minimum platform should be.
  13. Select the ideal platform. Recommendations will focus on performance tuning for this platform. Select Auto if you are not sure what the ideal platform should be.
  14. Click Finish. The newly created Session will appear in the Performance Explorer

Feedback