Installation of the Performance Canvas server

Install and get your software up and running in your IT environment. For more information on this topic take a look at the Related documents.

You need to determine which IP port for that should be used for the Performance Canvas server. The normal port to use is port 80 (http). However this may be in use by another application or server. A simple way (not 100% reliable) of determining whether port 80 is available on the target machine is to try accessing it using a web browser entering “localhost” as URL. If you get some type of response, the port is definitely busy.

If you are installing on a client machine that has the IP telephony application “Skype” active you may have an issue since skype by default occupies port 80. This is easily fixed by changing in Tools/ Options/ Advanced/ Connection and unchecking the “Use port 80 and 443 as alternatives for incoming connections”.

N.B. When upgrading from Perfomance Canvas 2007 to Performance Canvas 2009, follow the instructions below.

The server is self contained and needs very limited resources for basic operation. You will need

1. A free IP port number. Default is 80 (http).
2. About 200 MB of disk space.
3. Local Administrator privileges on the target machine.

Click here for system requirements in detail

Media is accessed via download or CD/ DVD distribution depending on your channel of purchase for the product. On the media you will find a self extracting install file called pc09.exe.

Run the pc09.exe install package.

• Welcome to the Performance Canvas Setup Wizard

• Accepting the license agreement

• Choose Typical, Custom or Complete installation

• Options in custom installation

• Ready to install

• Wait while installing Performance Canvas

• The first phase of the installation process is finished

Sometimes there can a problem installing the serivce on Windows Vista, 2008 (R1 and R2) and 7. If you encounter this problem, start a Command Prompt as administrator (Start → All Programs → Accessories → Right click on Command Prompt, chose “Run as administator”) (see picture).

In the command prompt, enter the following command

cd "C:\Program Files (x86)\Performance Canvas\bin"

Warning: Your search path may vary - use the tab-completion, ie C:\Protab will give C:\Program Files, tab once more will give “C:\Program Files (x86)\” etc.

In the bin folder, run the command

InstallService.bat

This will give the message

c:\Program Files (x86)\Performance Canvas\bin>servicemgr -install

Attempting service install with name Performance Canvas and description DSP Perf ormance Canvas 2009
====================
The service was successfully installed, you can start it either by
running 'net start "Performance Canvas"' from the command line or by using the
service console.
====================

and you can start the service either by using the Service manager or by running

net start "Performance Canvas"

in any Command Prompt running as administrator.

Your installation is now complete. Go through the steps below to verify that your Performance Canvas server is working correctly.

Verify that your installation is working by

1. Make sure you have the Performance Canvas service correct configured and started. Use the Service manager and look for Performance Canvas.
   1. If it is not started, try to start the service. If you are running Vista/Windows 7 make sure you are using an account with local admin privileges (not the default “local machine” account).
   2. If the service is not installed, run (as administrator) \Program Files\Performance Canvas\bin\InstallService.bat to install the service. When installed, start the service by using Service manager.
2. Start a web browser on the target machine. Enter “http://localhost” as URL (or “http://localhost:56100” if the port was changed to 56100). This should bring up the Performance Canvas home page. Note: This may take some time depending on the capacity of your machine, internet connections and so on. If the home page does not show within one minute, hit the “refresh” button in your browser.
3. Determine the IP number or address of the target machine. Try to access the Performance Canvas from another machine in the network by entering the IP number or the address as URL in the web browser of the client machine. This should bring up the Performance Canvas home page.

1. If step 2 did not work
   1. Make sure you do not have another application or server active on the machine using the port you tried to use. Try
      1. Stopping the Performance Canvas service using the service manager.
      2. Change the port number from port 80 if needed to your desired IP port. This is done my accessing the file called zenith.properties in the install directory (default is C:\Program Files\Performance Canvas). zenith.properties is best edited right-clicking on it, choosing Open with… Wordpad. Example: To change the port number used to 56100 change the line “dsp.port=80” to “dsp.port=56100” and save zenith.properties again.
      3. Restart the service and try verification step 1 again.
2. If step 2 worked and step 3 did not you probably have a firewall/network security related issue.

The next steps to get business value out of the server is to depends on the purpose of your server installation:

• Evaluation and Demo.
  • Using the supplied demo cubes. These cubes are automatically connected at install. Just start creating your first Canvas - Creating a new canvas or use one of the supplied.
  • Connect to your own data. Do basic server configuration. System Configuration
• First time setup. Do basic server configuration. System Configuration to start with and continue deciding on and setting up your security model.
• Experienced setup. Refer to the Reference documentation.

Follow the steps described in Basic Installation. All objects and settings from the old installation will be converted into the new installation.

When upgrading from Performance Canvas 2007 (PC07) to Performance Canvas 2009 (PC09) you have to manually uninstall PC07 before you install PC09. If you want to use objects (Canvases, Gems and Slicers) built in your old PC07-installation in the new PC09-installation, follow the steps described below:

1. Stop the service for Performance Canvas 2007 from the Control Panel Services.
2. Copy the “\Performance Canvas\store\” folder structure including all files in it to a temporary directory.
3. Uninstall the service for Performance Canvas 2007. (Run: \Performance Canvas\store\UninstallService.bat)
4. Uninstall the Performance Canvas 2007 from the Control Panel Add/Remove Program.
5. Run the new pc09.exe install package
6. Copy all files from the store folder in the temporary directory, except for the \deleted, \properties, \role, \settings, \temp and \tmp folders, into the new “Performance Canvas\store\” folder. To get the old data sources it is also needed to copy \settings\cubes.xml to the new store folder. Tip: Delete the six folders except for \settings\cubes.xml in the temporary directory before copying.
7. (optional) Change the port number from port 80 if needed to your desired IP port. This is done my accessing the file called zenith.properties in the install directory (default is C:\Program Files\Performance Canvas). zenith.properties is best edited right-clicking on it, choosing Open with… Wordpad. Example: To change the port number used to 56100 change the line “dsp.port=80” to “dsp.port=56100” and save zenith.properties again.
8. (Optional) Check the settings in the file “\Performance Canvas\bin\service.properties” and change if needed.
9. Install the new service. (Run: \Performance Canvas\store\InstallService.bat)
10. Start the new service from the Control Panel Services.