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
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.
If you are not in C-shell, type /bin/csh to enter C-shell.
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.
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.
If Panorama C/C++ is delivered on a tape, for SUN OS 4.0, please insert the tape into the tape drive and type:
For Solaris 2.3, please insert the tape into the tape drive and type:
For HP-UX 10.00, please insert the tape into the tape drive and type:
For SUN OS 4.0.x or Solaris 2.3, please use uncompress command to uncompress the sun.tar.z (or sun.tar.Z) file, then use
For HP-UX 10.00, please use uncompress command to uncompress the hp.tar.z (or hp.tar.Z) file, then use
to get the all files and save them into a directory as the home directory of Panorama C/C++.
Each user must initialize the environment respectively for each machine on which a user will use Panorama.
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.
Otherwise, type the full pathname, such as:
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.
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.
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.
You must have write permission to this directory.
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.
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.
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.
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.
these are default names list below:
You can specify another command instead if you want , these commands specified must be existed and run.
The Setup menu appears.
Note: It is easiest to exit the Setup script, obtain the license key, and then run the Setup script again to install the key.
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
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:
to make sure that Panorama path has been properly set.
A license key is needed for the evaluation or product copy. To install a product demo, this step can be skipped.
or in text format
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.
The configuration questions will appear.
The installation prompt will appear.
You will be prompted to enter your key code.
The number of licenses allowed by this key will be displayed.
The main Setup menu appears
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:
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.
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:
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
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."
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:
In this case, follow the steps below:
set path = (/usr/bin/X11 $path)
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:
Then run the following command at system prompt:
Then enter the following command to see if the Panorama path has been properly set:
In case the Panorama path has not been properly set, exit the X-window, logout, then login again. Re-start X-window, and run:
After the Panorama path and environment variables are properly set, start the license manager again.
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:
Wait three minutes for license manager to initiate. Then Panorama C/C++ is ready to execute.
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:
She can now run panorama on machine A without any problem.
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:
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:
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.
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.
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.
Refer to the section Initializing the Environment . Follow the step 6 to step 9 to upgrade the demo.
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:
The saved files are usable in case you want to use the previous compiler.
The following are all the files in the Panorama C/C++ product: