Installation

Requirements

Machine Requirements:

SUN SPARC workstation, running Motif or OpenLook under Sun OS 4.1.x or Solaris 2.3.

HP 9000 Series 700/800 HP-UX 10.00Up

Disc space required to load Panorama C/C++: 25 megabytes

Main Memory required: 16+ megabytes

Swap space needed: 32+ megabytes

Operations

Loading the Files

Panorama C/C++ can be installed by a system administrator with super-user privilege or by other users without super-user privilege. The person who installs Panorama C/C++ must have write permission in the directory in order to download files and generate new files. "Panorama C/C++" and "Panorama" are used interchangeably in this manual.

To avoid confusion, all capitalized characters in commands have been underlined in this chapter.

  1. Login to the workstation on which you will install Panorama.

  2. Make sure that you are under C-shell.

    If you are not in C-shell, type /bin/csh to enter C-shell.

  3. Now, make sure you have set the required file search path or have a .cshrc file in the home directory in which

    the path of C/C++ compiler, the path of OpenLook and/or Motif, etc., are properly specified.

    If there is no .cshrc file in your home directory, create a .cshrc file, or contact your system administrator for help.

  4. Make a directory to store all Panorama C/C++ files and then change to that directory:

    mkdir panodir

    cd panodir

    If you have an old version of Panorama C/C++ installed, you may completely delete all the files and the subdirectories of the old version, then start to install the new version of Panorama C/C++ in the directory.

  5. Load all distributed files into the Panorama C/C++ directory.

Initializing the Environment

Each user must initialize the environment respectively for each machine on which a user will use Panorama.

  1. Run Panorama C/C++ Setup Script

    The script configures the environment file which holds descriptions of the environment in which Panorama C/C++ will run. For evaluation and product copies, you need to get the server code and fax it to ISA for the product license, then run the Set up again to install the keys in Step 6-g below.

    The Setup script will prompt you with questions to customize Panorama C/C++ for your workstation. The default value will be displayed in brackets after the prompt; press "return" to accept it.

    1. If you are in the directory in which you have installed Panorama, then type: "./Setup"

      Otherwise, type the full pathname, such as:

      /home/usr/panodir/Setup

      The Setup menu appears. You may get warnings that Panorama C/C++ cannot find some files. This is because Panorama C/C++ can be displayed on several different platforms - SUN, DEC, IBM, and HP. (This version can only run on a Sun, but you can display it on other platforms.) Ignore these messages unless they apply to the workstation on which you are running the Setup script. If these warnings apply to your system, please call ISA technical support.

    2. On the Setup menu, press 4

      Note: If you already have Panorama C/C++ installed on this machine -- perhaps an older version -- a message will appear reminding you of that; you may continue installing.

    3. Identify the font format for isafont.

      Type "return" to accept the default.

      Note: If you already have isafont installed on this machine -- such as from an older version of Panorama -- a message will notify you of it. Skip to Step 6-e.

    4. Identify the directory in which isafont should be installed.

      You must have write permission to this directory.

    5. Identify the directory in which Panorama was installed.

      Panorama will install isafont.

      Note: If for some reason isafont could not be properly installed, please select 4 from the Setup menu again and enter a different font format.

    6. Identify the computer on which the license manager will run.

      The license manager is the daemon that controls the number of copies of Panorama C/C++ that are checked out at any one time and allows Panorama to run on different machines on your network. Type in the name of the host machine on which Panorama is being installed.

    7. Identify the directory in which the license key will be installed.

      A License Key is the code that allows you to use Panorama C/C++. You will install the key in step 7.

      It is recommended to store the license key file in the machine in which Panorama files have been installed.

      Note: If you have already installed Panorama C/C++ with the key, and are now running the Setup script on a second machine, type in the directory in which you have already installed the key.

    8. Identify the directory to store temporary files generated by Panorama C/C++.

      You must have write permission to this directory.

      Setup can automatically create a .panotmpdir directory under your home directory for storing the temporary files if you accept the default. If you specify another directory instead, this directory specified must have already been created.

    9. Identify the C++,C compiler name ,make tool,text editor name and the command tool name.Type: "return".

      these are default names list below:

      C++ compiler name: CC
      C compiler name: cc
      Make tool name: make
      Text editor name: vi
      Command tool name: xterm

      You can specify another command instead if you want , these commands specified must be existed and run.

    10. Type "return" to exit the key installation.

      The Setup menu appears.

    11. Type "return" to exit the Setup script.

      Note: It is easiest to exit the Setup script, obtain the license key, and then run the Setup script again to install the key.

    12. If you have your .cshrc file in your home directory, you may add the panorama home directory to your path for automatically setting Panorama home directory. In your .cshrc file, append

      set path = ($path "panorama home directory")

      For example, if Panorama has been installed in /home/john/panodir, then append the following path into your .cshrc file:

      set path = ($path /home/john/panodir)

      Also, type this command on screen as required by the Setup script.

      Note: In case you installed earlier versions of Panorama C/C++ on the same machine, you might have already set Panorama path in the file searching path or the ~/.cshrc file. Then the above set path command typed on the screen and appended in the ~/.cshrc file may not properly set the path of the current version of Panorama C/C++.

      In this case, you may set the new Panorama home directory in the front of your file searching path by the command

      set path = ("new panorama home" $path)

      or carefully modify the ~/.cshrc file again to block or delete the previous Panorama set-path commands, close the X-window, logout and then login again. Type:

      which panorama

      to make sure that Panorama path has been properly set.

  2. Call ISA for your license key (for evaluation and product only, not for demo).

    A license key is needed for the evaluation or product copy. To install a product demo, this step can be skipped.

    1. Print the server code in either PostScript format

      lpr -h code.ps

      or in text format

      lpr code.txt

      Note: You might have identified another machine as the one on which Panorama C/C++ license manager will run. In that case, you must use that machine to run Setup and select 3 to both get the server code and later install it.

    2. Fax the printout to ISA Technical Support at (510) 632-6688. Or, send the server code by E-mail to isa@netcom.com. A license key will be issued for your copy of Panorama C/C++.

    3. Run the Setup script again to install the key. Type: " Setup "

    4. On the Setup menu, type:" 3 "

      The configuration questions will appear.

    5. Type "return" 3 times to accept the defaults.

      The installation prompt will appear.

    6. Type: " 1 "

      You will be prompted to enter your key code.

    7. Type in the key code.

      The number of licenses allowed by this key will be displayed.

    8. Type "return" to exit key installation

      The main Setup menu appears

    9. Type "return" to exit the Setup Script.

  3. Initiate Panorama license daemon (for evaluation and product only).

    To run the sample source code provided in demo package, it is not required to run the license manager.

    Note: If you have previously installed Panorama C/C++ on this machine -- perhaps an old version -- please use the ps command (ps -aux) to check if the old pano_lm_daemon is running. If it is, first kill it using the kill command.

    Type in the following command at system prompt:

    pano_lm_daemon -l pano_lm.log

    The above command consists of lower case letters. It does not contain "1" (one) or other digits.

    Wait three minutes for license daemon to initiate.

    Note: if you are a super user, you may append a set path command to set Panorama home directory, and the above panorama license daemon command in your /etc/rc.local file to automate them next time when the system is brought up.

  4. Verify to see if all the environment variables are properly set.

    It is a good practice to verify the environment settings before start to run Panorama. Type: " set "

    Check to see if the paths for C/C++ compiler, OpenLook and/or Motif, Panorama are properly set in the environment.

    Alternatively, you may type:

    which CC
    which cc
    which g++
    which gcc

    to check if the proper C/C++ compiler has been set. Similarly, check if the current Panorama and belong to the new version just installed.

    In case an old version of Panorama C/C++ was installed on the machine, the ~/.cshrc file of your home directory may contain the set-path command and set-environment commands for the previous version of Panorama. Those settings may affect the execution of the newly installed version of Panorama. Refer to section Special Note for System with Old Versions of Panorama in this chapter.

    If license daemon has been started, wait 3 minute and type in

    ps -aux

    to see if the license manager has been initiated.

    If both OpenLook and Motif are installed in you system, be sure that the paths for OpenLook and Motif are in a proper order in the searching path. Refer to Special Note for Systems with Both OpenLook and Motif .

Now you have successfully installed Panorama C/C++.

Note: If you use Motif, please make sure that the /usr/bin/X11 directory can be found in your path.

If you use Open Look, please make sure that the $OPENWIN/bin directory can be found in your path (for most systems, $OPENWINHOME/bin = /usr/openwin/bin). Also make sure the file /usr/lib/X11/XKeysymDB exists. If it does not, you may need to copy it from $OPENWIN/lib/XKeysymDB. Otherwise you might see warnings about "Unknown keysym name."

Special Note for Systems With Both OpenLook and Motif

For SPARC workstations with both OpenLook windows system and X11/Motif window system installed, some confusion may result because the X utilities (clients) are different for these two window systems.

The utilities for OpenLook are under $OPENWINHOME/bin (for most systems, $OPENWINHOME/bin = /usr/openwin/bin). The utilities for X11/Motif are under /usr/bin/X11. Before you try to install Panorama C/C++, you should check the current searching path (value of the $path). For OpenLook window system, make sure $OPENWINHOME/bin comes before /usr/bin/X11 in the searching path. For X11/Motif window system, make sure /usr/bin/X11 comes before $OPENWINHOME/bin. After you have installed the Panorama C/C++ environment, you should also aware of which X utility directory comes first.

For example, if you are running Motif, but $OPENWINHOME/bin comes before /usr/bin/X11, you might get the following x error:

X Error of failed request: BadValue (integer parameter out of range for operation)
Major opcode of failed request: 51 (X_SetFontPath)
Minor opcode of failed request: 0
Resource id in failed request: 0x3
Serial number of failed request: 5
Current serial number in output stream: 8

In this case, follow the steps below:

  1. Append the following to your .cshrc:

    set path = (/usr/bin/X11 $path)

  2. Restart Motif.

  3. Follow the installation steps as usual.

Special Note for Systems with Older Versions of Panorama

Older versions of Panorama may have required you to modify your .cshrc file to set environment variables such as PANORAMAHOME, PANORAMAKEYPATH, and PANORAMAHOST, etc.. Those settings may differ from the current settings. Please make sure that the old "setenv" statements are deleted, or modified according to the content of you current ~/.panorc file. Otherwise, the old settings of the environment variables may confuse the current version of Panorama C/C++.

Also delete the old set-panorama-path command from the ~/.cshrc file of your home directory and append the following command into the ~/.cshrc file of your home directory:

set path = ($path "panorama home directory")

Then run the following command at system prompt:

source ~/.cshrc

Then enter the following command to see if the Panorama path has been properly set:

which panorama

In case the Panorama path has not been properly set, exit the X-window, logout, then login again. Re-start X-window, and run:

source ~/.cshrc

After the Panorama path and environment variables are properly set, start the license manager again.

Re-booting the System

After Panorama C/C++ is properly installed, it is important to initiate the license manager when your system is re-booted.

You should start X-window first, then enter the following command at system prompt:

pano_lm_daemon -l pano_lm.log

Wait three minutes for license manager to initiate. Then Panorama C/C++ is ready to execute.

Trouble Shooting

Installation

install.GIF - 7.28 K

Working with Panorama C/C++

work.GIF - 7.86 K

Network Environment Example

Background:

In a network environment, there are, three machines A, B, and C. Anna has successfully installed Panorama in her account anna on machine A as follows:

Panorama’s installation (home) directory: /home/anna/panodir
Isafont directory: /home/anna/fonts
Panorama’s key path: /home/anna/keys
Panorama’s license host: A
Panorama’s temporary file directory: /home/anna/.panotmpdir

She can now run panorama on machine A without any problem.

Situation 1:

Anna wants to use this copy of Panorama C/C++ on machine B. Machine A should be running and Panorama C/C++ is properly installed. She should follow the steps below:

  1. Login to machine B as anna.
    (If you use "su anna", first type "cd" to go to your home directory.)
  2. Run Setup by typing Setup.
  3. Select 1 for installing font.
  4. Specify isafont directory as /home/anna/fonts.
  5. Specify Panorama installation directory as /home/anna/panodir.
  6. Quit Setup.
  7. Run panorama.
Situation 2:

Chris wants to use this copy of Panorama C/C++ on machine C using his account chris. Machine A should be running and Panorama C/C++ should be properly installed. He should follow the steps below:

  1. Login to machine C as chris.
  2. Run Setup by typing in /home/anna/panodir/Setup.
  3. Select 1 for installing isafont.
  4. Specify isafont directory as /home/chris/fonts.
  5. Specify Panorama installation directory as /home/anna/panodir.
  6. Select 2 for creating .panorc under Chris’s home directory.
  7. Specify Panorama installation directory as /home/anna/panodir.
  8. Specify A as the machine on which the license manager will run.
  9. Specify /home/anna/keys as the directory where the license key is stored.
  10. Specify /home/chris/.panotmpdir as Panorama temporary file directory.
  11. Quit Setup.
  12. Append to Chris’s .cshrc the following:
    set path = ($/home/anna/panodir $path)
  13. Run .cshrc by typing in:
    source .cshrc.
  14. Run panorama.

Upgrading from a Demo Version

Panorama's demo version has all the features of the actual product, but only works with the sample source code provided. By installing the correct license key, this demo version can be easily upgraded to an evaluation version or product version. Then it can work with the user's own source code.

Follow the steps below to upgrade a demo version to an evaluation or product version.

To avoid confusion, all capitalized characters in commands have been underlined in this chapter.

  1. Login to the workstation on which the license manager for Panorama C/C++ will run.

    he license manager is the daemon that controls the number of copies of Panorama C/C++ that are checked out at any one time and allows Panorama C/C++ to run on different machines in your network.

  2. Make sure that the demo version of Panorama has been correctly installed by running it with the sample code provided. Type

    panorama &

    If you are unable to start Panorama and run it with the sample source code, please refer to the demo installation pages in the Demo Operation Guide.

  3. Change into the directory in which the demo version of Panorama has been installed:

    cd "panorama demo installation directory"

  4. Initialize the environment variables.

    Refer to the section Initializing the Environment . Follow the step 6 to step 9 to upgrade the demo.

Using a New C++ Compiler

When analyzing the source code, different (versions of) compilers involve different .h files. The source code after pre-processing by different (versions of) compilers will be different. So are the data files generated by Panorama with the source code.

If you need to use a new C++ compiler, please make sure the following:

  1. In case you want to reserve the analysis results by the previous compiler, backup the .tdbs files, .dbs files, the .dbs sub-directory and the ddfile sub-directory generated by Panorama for the applications.

    The saved files are usable in case you want to use the previous compiler.

  2. Delete the above files, the .dbs sub-directory and the ddfile directory.

  3. Properly modify the ~/.cshrc file, make sure that the new compiler appears in front of the previous compiler in the searching path of your system environment. Or make sure that the new compiler is the only C++ compiler in your searching path.

  4. Type in the following command at system prompt:

    source ~/.cshrc

Distribution File List

The following are all the files in the Panorama C/C++ product:

filelist.GIF - 6.50 K

back to Table of Contents