Step 2: Running the Install Program

NOTE >> Before you can run MemoryScape, you must obtain a licence. You can request one by email at license@roguewave.com.

This section describes how you install a new version of MemoryScape. Before starting, you should read the TotalView Release Notes available for download at http://www.roguewave.com/help-support/documentation/totalview. In addition, some operating systems may need to be patched. For more information, see the TotalView Platforms and System Requirements guide.

Here is the procedure for installing MemoryScape:

1. (Optional) Go to the system upon which you will be installing MemoryScape and become the root user:

NOTE >> In some circumstances (particularly on a Macintosh), you’ll want to use the sudo command instead of su. If you use the sudo command, you’ll be typing sudo ./Install instead of ./Install in step 2.

Installing MemoryScape as the root user prevents users from modifying the software. However, you should not run MemoryScape as root.

2. Go to the directory containing the files extracted from the downloaded tar file and then start the Install program by typing:

For information on using this command, type ./Install -help. If you use any of the options described in this displayed information, the installation procedure is no longer interactive.

3. The Install program asks you to accept the license terms for MemoryScapte. You can respond Yes to accept, No to decline, or ? to view the license terms. You must accept the license terms to continue the installation.

4. The Install program asks that you name an installation directory. If the directory you specify does not exist, the program requests a new location, effectively meaning the directory you specify must already exist.

If you do not enter a name, the installation directory will either be/usr/toolworks or /opt/toolworks—this is system-dependent. Type a period “.” to place MemoryScape in your current directory.

This manual refers to the installation directory’s pathname as installdir.

The Install program then creates a toolworks directory and places two subdirectories within it:

If you are installing MemoryScape for multiple platforms in a common NFS directory, you only need to install the common components once.

6. The Install program asks if it should create a symbolic link (named memoryscape) to this installation directory.

If you are not the root user, Install cannot create the link, so you should answer “n” (no). If Install cannot create the link, you can ignore its complaints and continue installing MemoryScape by pressing Enter.

7. If you became root using su, exit from root after Install concludes by typing:

MemoryScape prints information that includes a version number and a message indicating that a license file is not installed.

If MemoryScape cannot initialize the license manager, it prints the following message:

If you see this message, you need to confirm that you did install the license. You may need to set the LM_LICENSE_FILE environment variable to the installation directory. (This variable is described in the next step.)

Before you can use MemoryScape, you must place the demo license into the flexlm-version directory. This license file, which is called license.demo, was attached to the email message confirming your download request. If your email system didn’t retain this name, you must rename it after you save it to disk.

1. If you installed MemoryScape as the root user, become the root user again. If you used sudo to install MemoryScape, use sudo in the following step.