Installing Advanced Design System on UNIX and Linux

Advanced Design System can be installed on UNIX and Linux systems using either the ADS installation DVD or by downloading ADS installation images from the Agilent EEsof Knowledge Center website:

http://www.agilent.com/find/eesof-knowledgecenter

For last-minute program and documentation information, refer to the Release Notes document on our website at:

http://www.agilent.com/find/eesof-docs
Choose Advanced Design System > Release Notes: 2008

Installation Overview

Quick Installation

Use this condensed installation procedure if you are experienced installing Agilent EEsof products; otherwise, refer to Detailed Installation.

If you installed an Early Access version of ADS 2008, you should uninstall it before installing this release.

1. Log onto the system where you will install ADS.
2. If you are installing from a DVD and your system does not mount DVDs automatically, create a mount point, typically: mkdir /dvd. Then mount the ADS DVD using the correct DVD for your platform. Examples of mount commands:
   mount -F hsfs -r /dev/dsk/c0t6d0s0 /dvd (Solaris not running vold)
   mount -t iso9660 /dev/dvd /dvd (Red Hat Linux)
   If you logged in as root to mount the DVD, exit from being root before continuing the installation if you want to avoid installing as root.
3. If you are installing from a downloaded image, download then untar the appropriate ADS installation image for your platform from the Agilent EEsof Knowledge Center website:

   http://www.agilent.com/find/eesof-knowledgecenter

4. Change directory to the Program DVD or to the path of the extracted tar files.
   cd /dvd
   (or use cd /cdrom/cdrom0 on Solaris running vold)
5. Start the Setup program using the following command:
   ./SETUP.SH
6. When the Advanced Design System 2008 installation window appears, you can begin to set up the installation and install ADS. Details about each window are available in Detailed Installation. When the installation is complete, click Done to exit the installation program.
7. Unmount the installation DVD from the root directory:
   umount /dvd
   (or use eject dvd9 on Solaris running vold)
8. Configure user accounts. See Configuring User Accounts.
9. Use the FLEXnet security codewords from Agilent EEsof to set up a license.lic file. See Setting Up Licenses.
10. Place the license.lic file in the licenses sub-directory of your ADS installation directory and start FLEXnet. See Setting Up Licenses.
11. If you will be using license bundles, select a bundle using the Agilent License Preference Tool prior to running ADS. This tool is described in Using the Agilent License Preference Tool.
12. Start ADS. See Running Advanced Design System.

Detailed Installation

Use the following steps for installing ADS on UNIX and Linux systems. If you have not done so, please review Before You Begin. Also, if you installed an Early Access version of ADS 2008, you should uninstall it before installing this release.

Note The installation program does not support cross-platform installations. Please be sure to use the correct platform-specific installation disk for your system.

To install ADS on UNIX and Linux systems:

1. Log onto the system using an account that has permissions to write to the disk to which you want to install.
2. If you are installing from a DVD, mount the ADS DVD making sure to use the correct DVD for your platform. Mounting a DVD file system on a UNIX or Linux system requires root or super-user privileges on most systems.

   Note If you are running Solaris and the DVD has been mounted by vold, you can skip to step 3. You can check if the DVD is mounted by running the mount command without any arguments.

   The typical mount point, or directory, for a DVD is /dvd. This may be different on your system. The mount point directory must exist before you can mount the DVD. To create a /dvd directory, enter:
   mkdir /dvd
   To mount the Program DVD, run the command for your system. Here are examples:
   mount -F hsfs -r /dev/dsk/c0t6d0s0 /dvd (Solaris not running vold)
   mount -t iso9660 /dev/dvd /dvd (Linux)
   Once the Program DVD is mounted, exit from being root before completing the rest of the installation procedure if you do not want to install as root.

3. If you are installing from a downloaded image, download then untar the appropriate ADS installation image for your platform from the Agilent EEsof Knowledge Center website:

   http://www.agilent.com/find/eesof-knowledgecenter

   For example to untar the file on Linux:
   tar xf ads330rday_linux_x86.tar

4. Change directory to the Program DVD or to the path of the extracted tar files.
   cd /dvd

   Note If you are running Solaris, and the vold daemon is active, enter: cd /cdrom/cdrom0

5. Start the installation program using the following command:
   ./SETUP.SH
   Note that the Sun File Manager is not recommended to invoke SETUP.

   Note If you are running Netscape, or another program that uses a lot of color resources, you should shut it down before starting the Advanced Design System installation.

6. At the Introduction window, click Next to read the License Agreement. This is a usage agreement and is not related to the license codewords required to run the software.
7. At the License Agreement window, after reviewing the agreement, choose:
   • I accept the terms of the License Agreement, then click Next to continue with the setup.
   • I do NOT accept the terms of the License Agreement to end the setup program.
8. At the Choose Install Set window, choose
   • Complete to install the basic ADS software, design guides, examples, and documentation. Refer to Installation Items. If you choose Complete, you can skip the next step.
   • Custom to choose which ADS items you want to install. For a list of Custom Installation items, refer to Installation Items.

     Note While you choose here which ADS features you want to install, the ability to run them is determined by the licenses you have purchased.

9. For a Custom installation, the next window lets you choose the items you want to install. You must choose to install the ADS programs and tools option since it is the basic ADS software. You can always re-run the installation program to install other items. Click an item name to see a description. Select the items you wish to install and click Next to continue.
10. At the Choose Install Folder window, enter the full path to the directory where you would like ADS software to be installed. If you specify a directory that does not already exist, the installation program will create it for you. The default directory is /usr/local/ADS2008. Choose:
    • Next to install to the default destination or
    • Enter the full path or click Choose to browse to a different destination directory then click Next to install to the specified folder.
11. At the Pre-Installation Summary, the installation directory you have selected is shown, along with the available disk space on the disk partition that contains this directory. If you want to keep the installation directory shown, click Install. If you want to change the installation directory, click Previous.
12. The Installing Advanced Design System 2008 window appears. When installation is finished, the Install Complete window appears. Click Done to close the installation program.
13. Unmount the installation DVD:
    cd /
    umount /dvd9

    Note You must be in the root directory to unmount the DVD. If you are running Solaris and vold is active, enter following command: eject dvd.

14. Configure user accounts. See Configuring User Accounts.
15. Use the FLEXnet security codewords from Agilent EEsof to create a license.lic file with the correct SERVER and VENDOR line configurations. See Setting Up Licenses.
16. Place the license.lic file in the licenses sub-directory of your ADS installation directory and start FLEXnet to enable your codewords. See Setting Up Licenses.
17. Start ADS. See Running Advanced Design System.
    If you will be using license bundles, select a bundle using the Agilent License Preference tool prior to running ADS. See Using the Agilent License Preference Tool.

Installation Items

A complete installation installs these items except the FLEXnet files, and requires approximately 4.5 GB of disk space. For a custom installation, you can choose which items you want to install.

Configuring User Accounts

Configure the user accounts that will run ADS as follows:

C Shell

Add the following at the end of $HOME/.cshrc:

setenv HPEESOF_DIR <install_directory>

setenv AGILEESOFD_LICENSE_FILE <path_to_license_file>
Default: $HPEESOF_DIR/licenses/license.lic

set path = ( . $HPEESOF_DIR/bin $path )

Bourne or Korn Shell

Add the following at the end of $HOME/.profile:

HPEESOF_DIR=<install_directory>

AGILEESOFD_LICENSE_FILE=_<path_to_license_file>
Default: $HPEESOF_DIR/licenses/license.lic

PATH=.:$HPEESOF_DIR/bin:$PATH

export HPEESOF_DIR AGILEESOFD_LICENSE_FILE PATH

Note If you are running Common Desktop Environment (CDE) or HP VUE, your user account may be using $HOME/.dtprofile or $HOME/.vueprofile respectively to set up your user account instead of .cshrc or .profile. The .dtprofile and .vueprofile files contain a line that can be uncommented to activate the use of .cshrc or .profile. Please see your system administrator or CDE or VUE documentation for details.

Once the user accounts are configured, each user should log in and verify that the new environment variables are set. Type the env command and check that HPEESOF_DIR and AGILEESOFD_LICENSE_FILE are set and that PATH contains a path to the ADS bin subdirectory.

If you installed ADS as root, the ownership of directories and files will be set to user id 1313 and group id 22. To change this, enter:

cd $HPEESOF_DIR
chown -R root *
chgrp -R sys *

Setting the Display

If you plan to run ADS from a remote computer and you want the display to appear on your local machine, you will need to set the DISPLAY environment variable:

setenv DISPLAY <my_hostname>: 0.0 (C-Shell)

DISPLAY = <my_hostname>: 0.0 _(Korn Shell, Bourne Shell)
export DISPLAY

For a Sun Ray file server and diskless terminals using Solaris 8, you will need to set the DISPLAY environment variable:

setenv DISPLAY <servername>$Display (C-Shell)

set DISPLAY = <servername>$Display (Korn Shell, Bourne Shell)

export DISPLAY

For details on using the Sun Ray appliance, refer to the Sun website at:

http://wwws.sun.com/sunray/index.html

Installing to Multiple Disk Partitions or Directories

If you do not have a single partition large enough to hold the entire ADS installation, you can spread the installation across partitions using symbolic or soft links. The symbolic links are created before installation to redirect files to other partitions.

For example, suppose you want to install ADS with most of the software installed in /opt/apps/eesof, but you want the example projects to be installed to /disk2 due to lack of disk space in the /opt partition. Before starting the installation program you would do the following:

1. Create the main installation directory:
   cd /opt/apps
   mkdir eesof
2. Create the directory that will hold the example files on / disk2:
   cd /disk2
   mkdir ads_examples
3. Create a link named examples in the main installation directory that points to the /disk2/ads_examples directory:
   cd /opt/apps/eesof
   ln -s /disk2/ads_examples examples
4. Begin the installation process. When the examples are installed, the example projects will follow the /opt/apps/eesof/examples link to /disk2/ads_examples.

Following is a list of the larger directory (not the complete list) names for ADS, along with approximate sizes. Any of these directories can be re-directed to another disk partition as shown above for the examples directory. The sizes shown are for a complete installation.

Using Multiple ADS Versions

Use the following instructions to maintain and run more than one version of ADS (such as version 2006A and 2008). Keep a separate $HOME directory for each version of ADS to help in structuring all the files and prevent problems that may arise if the configuration files are shared between multiple installations. The $HOME directory is where all your projects are kept.

Setting the HOME Environment Variable

You need to specify the variable $HOME separately for each version of ADS that you want to run. You can set up two directories from which you can run different scripts to launch the version of ADS you want.

Below are example scripts. Please change them to match your system.

Script for ADS 2006A

#!/bin/ksh
#
# Script for starting ADS 2006A on UNIX and Linux systems.
cd /users/jdoe/ads2006a
HOME=/users/jdoe/ads2006a
HPEESOF_DIR=/utils/eesof/ads2006a
PATH=$HPEESOF_DIR/bin:$PATH
export HOME HPEESOF_DIR PATH
ads

Script for ADS 2008

#!/bin/ksh
#
# Script for starting ADS 2008 on UNIX and Linux systems.
cd /users/jdoe/ads2008
HOME=/users/jdoe/ads2008
HPEESOF_DIR=/utils/eesof/ads2008
PATH=$HPEESOF_DIR/bin:$PATH
export HOME HPEESOF_DIR PATH
ads

Installing Connection Manager

If you will be using the Connection Manager product, you should be aware that it contains two parts: the Connection Manager client, and the Connection Manager server.

The Connection Manager client is installed during the ADS installation. To run it, you must obtain the license link_connect_mgr. Then, to use Connection Manager to communicate with instruments, you must install the Connection Manager server. The Connection Manager client and server installations are not related to a client-server installation of ADS.

The Connection Manager server must be installed on a Windows PC. ADS 2008 does not include installation for Connection Manger Server. To use Connection Manager Server with ADS 2008, install Connection Manger Server from ADS 2006 Update 3 installation media. The Connection Manager server does not require a license. For instructions about installing the Connection Manager server, see Installing Connection Manager Server. For general information about Connection Manager, see the Connection Manager documentation.

Note Prior to ADS 2004A, when the Connection Manager Server was installed on a stand-alone Windows PC, ADS had to be installed on the same PC. Starting with ADS 2004A, when you install Connection Manager server on a stand-alone PC, it is no longer necessary to also install ADS on the same PC. The Connection Manager client and server software must be from the same or compatible release. If you have been using an older release of Connection Manager, then you install ADS 2008 on a client system, you also must install a compatible release of the server software. Since the Connection Manager server was not updated for ADS 2008, the compatible release for ADS 2008 is 2006 Update 3.