Installing Advanced Design System on Windows

Advanced Design System can be installed on a PC running Windows 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. For notes, tips, and details, see Detailed Installation. If you installed an Early Access version of ADS 2008, you should uninstall it before installing this version.

1. Insert the ADS PC installation DVD into your DVD drive or download the ADS installation image from the Agilent EEsof Knowledge Center website:

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

2. If you downloaded the installation image, navigate to where you saved the file then double click the self-extracting file to unzip it.
3. If the Setup program does not start automatically, choose Start > Run and enter D:\setup, where D: is your DVD drive or the path to the unzipped files, then click OK.
4. When the installation wizard appears, you can begin to set up the installation and install ADS. Details about each screen are available in Detailed Installation. When you are done, remove the DVD and click Finish; then:
   • If you are installing a network server, you are now ready to start setting up clients. For instructions, refer to Installing on the Server.
   • Install your codewords. For instructions, refer to Installing Your Licenses.
   • Install the Macrovision FLEXid software-security hardware key to your PC's parallel port or use your PC LAN card's ethernet ID. For instructions, refer to Installing Your Licenses.
5. 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. This tool is described in Using the Agilent License Preference Tool.

Detailed Installation

Use the following steps for installing ADS on a PC running Windows. 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 version.

To install ADS on a Windows PC:

1. Exit all Windows programs and insert the ADS installation DVD into your DVD drive or download the ADS installation image from the Agilent EEsof Knowledge Center website:

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

2. If you downloaded the installation image, navigate to where you saved the file then double click the self-extracting file to unzip it.
3. If the Setup program does not start automatically, choose Start > Run and enter D:\setup, where D: is your DVD drive or the path to the unzipped files, then click OK.
4. At the Welcome screen, choose Next to read the License Agreement. This is a usage agreement and is not related to the license codewords required to run the software. This appears only when you run Setup the first time or after uninstalling ADS.
5. At the License Agreement screen, after reviewing the agreement, choose:
   • Yes to accept the License Agreement and continue with the setup.
   • No to reject the License Agreement and end the setup program.
6. At the Customer Information screen, enter your information. There are no special requirements for this information, or connection to license codewords. Choose Next to specify the installation location.
7. At the Specify Your Installation Directory screen, choose:
   • Next to install to the default folder. The installation program will create this folder if it does not already exist.
   • Browse to specify a different destination folder. If you specify a folder that does not already exist, the installation program will create it for you.
8. At the Specify Your Home Directory screen, choose:
   • Next to accept the default.
   • Browse to select a different folder.
     The folder you specify will be the default startup folder for ADS. It will also be used to store the configuration data in a subfolder called hpeesof. If you are using more than one ADS version, please choose a new Home folder for each version. For the best performance, choose a folder on your local, not network, drive.
9. At the Select Features screen, choose an installation option:
   • Complete requires about 4.5 GB of disk space and installs the ADS design environment, simulators, documentation, examples, and DesignGuides but does not install the LAN Client files. Select Custom if you want to install LAN Client files. See Installation Items. If you choose a Complete installation, skip the next step.
   • Custom lets you choose the ADS items you want to install. For a list of custom installation items, see Installation Items.
     If you choose a Custom installation, and the machine you are installing to will be a network server, you must install the LAN Client Files item. For details, refer to Installing on the Server.

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

10. For a Custom installation, the next screen lets you choose the items you want to install. Click a item name to see a description. Select the items you want to install and click Next to continue.

    Note You must choose to install ADS Programs and tools which includes Layout, Simulators and Schematic Capture ; otherwise ADS will not run properly. Manuals & Help is selected by default to install the entire ADS documentation set. If you uncheck this item, documentation and help files will not be available regardless of which other items you choose.

11. At the Personal or Common program folder screen, choose:
    • Next to select the default option: Create folder and shortcuts only for current user.
    • The option: Create folder and shortcuts for all users, then click Next to continue.
12. Use the Select Program Folder screen to choose:
    • Next to install the ADS program icons to the default destination, which is Advanced Design System 2008.
    • Enter a new folder name, or choose a different destination folder for the icons from the Existing Folders list, then click Next to continue.
13. At the Check Setup Information screen, review your choices and click:
    • Back to access previous screens to verify entries and make changes. This screen appears again if you go back to make other choices.
    • Next to start the installation. Immediately after you click Next, the Setup Status screen appears and the program configures the installation process. When the program determines that your system is ready for installation, it begins to install files. The status screen displays the files being installed and the progress.
    • Cancel to exit the Setup without completing the installation.
14. When the installation is done, read the information displayed about license requirements and how to obtain codewords, then click OK.
15. A question box appears asking if the current PC will use a hardware key (also known as a dongle) to run the FLEXnet licensing system for ADS; choose:
    • Yes if you will use a dongle to run the FLEXnet licensing system. The Macrovision installation program loads the latest FLEXid drivers needed for the hardware key. If you need to install the drivers later, Macrovision recommends that you install the FLEXid drivers with their installer, which is included on the ADS PC Setup disk.
    • No if you will be using a PC LAN card's Ethernet ID to run the FLEXnet licensing system.
16. When the InstallShield Wizard Complete screen appears, remove the DVD and click Finish; then:
    • If you are installing a network server, you are now ready to start setting up clients. For instructions, refer to Installing on the Server.
    • Install your codewords. For instructions, refer to Installing Your Licenses.
    • Install the Macrovision FLEXid software-security hardware key to your PC's parallel or USB port, or use your PC LAN card's Ethernet ID. For instructions, refer to Installing Your 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 LAN Client files and requires approximately 4.5 GB of disk space. For a custom installation, you can choose which items you want to install.

Item	Description
ADS Programs and Tools	This is the basic ADS software, including the Design Environment; Data Display; and simulators for analog/RF systems, signal processing, and electromagnetic designs.
DesignGuides and Application Guides	Special interactive tool kits and handbooks for various design types.
LAN Client Files	Installs a setup folder enabling the PC to be a server for other LAN clients.
FLEXnet Files	Installs the FLEXnet license management software for a license server installation on a separate machine. For details, see Installing Floating Licenses on a PC Server.
Manuals and Help	Online manuals, help, and search engine. Documentation and help files will not be available if this option is not selected. ADS uses HTML-based documentation displayed using your Web browser. See Check the System Requirements for browser requirements.
Examples	Complete ADS application examples with search engine.

Client-Server Installations

ADS can also be set up to run using a client-server configuration. Use the following steps to set up your client-server configuration, starting with the server installation and setup.

Caution When performing a client-server installation over a network, Agilent recommends that the parent folder of the ADS installation folder be shared. If the ADS installation folder itself is shared, problems will result in the simulation Data Display window.

Installing on the Server

Install ADS on the server, making sure that the LAN client files are part of the installation. This installs a folder named setup under the installation folder (for example: C:\ADS2008\setup ), which contains the files needed to set up client machines.

Once the installation is completed, share the installation directory so that client machines can access the software across the network. Please consult your system administrator or refer to your Windows documentation or help for instructions on sharing directories.

Installing on Clients

Once you have installed ADS on a server and shared the installation folder, use the following steps to install clients on each client machine.

Note Certain LAN/Client PC installation problems can occur if you access server files through a UNC path, or a path such as \\hostname\share. This path can come about by using the Network Neighborhood to attach to server files, where you assign a drive letter to it; or through the use of the Windows Explorer, where you use \\hostname\share notation to access a shared drive.

1. Map a drive on the client machine that connects to the shared ADS installation directory from the server machine. For example, you might create a mapped drive G: that accesses the C:\ADS2008 directory on the server. Please consult your system administrator or refer to your Windows documentation or help for instructions on mapping paths.
2. Double-click setup.exe in the setup folder within the installation folder.
3. The Advanced Design System 2008 LAN Client Installation title screen appears displaying the Welcome screen. Choose:
   • Next to view the License Agreement.
4. At the License Agreement screen, choose:
   • Yes to accept the License Agreement and continue with the setup.
5. In the Select Features screen, choose a client installation option:
   • Recommended network installation. Installs main program files on the client machine and runs online manuals and component libraries from the network (requires approximately 350 MB of disk space on the client machine).
   • Maximum network installation. Runs all program files from the network. Only registry information, and PC icons are installed on the client machine, typically in C:\ADS2008.
6. Once you have specified an installation option, to confirm your choice of run-time directory (specifying the path to files on the server), choose Yes or No. (If you choose No, the LAN Setup program will end.)
   For Maximum network installation, go to step 9 (Select Program Folder screen).
   For Recommended network installation, continue here:
7. At the Choose Destination Location screen, define the install destination for the client's program files. Choose:
   • Next to install to the default folder. The installation program will create this folder if it does not already exist.
   • Browse to specify a different destination folder. If you specify a folder that does not already exist, the installation program will create it for you.
     The installation program also creates a Home folder which will be the default startup folder for ADS. Typically, this is C:\users\default. It is also used to store the configuration data in a subfolder called hpeesof. If you are using more than one ADS version, please choose a new Home folder for each version. For the best performance, choose a folder on your local, not network, drive. To change the Home folder, click Back to see the Specify Your Home Directory screen.
8. At the Select System Components to Install screen, select the additional items you want installed on the Client (or local) machine. The Space Required field displays the total disk space the installation will require, based on your choices. Click Next to continue.
9. At the Select Program Folder screen, specify the location to place the program icons. Choose:
   • Next to install the program icons to the default destination.
   • Enter a new folder name, or choose a different destination folder for the icons from the Existing Folders list, then click Next to continue.
10. At the Personal or Common program folder screen, choose:
    • Next to select the default option: Create folder and shortcuts only for current user.
    • The option: Create folder and shortcuts for all users, then click Next.
11. At the Check Setup Information screen, review your choices and click:
    • Back to access previous screens to verify entries and make changes. This screen appears again if you go back to make other choices.
    • Next to begin the installation.
    • Cancel to exit the LAN Setup without completing the client installation.
      Immediately after you click Next, the Setup Status screen appears and the program starts copying files. The status screen displays the files being installed and shows the progress installing the indicated option or file.
12. When the installation is complete, choose Finish.

Installing from a File Server

The contents of the ADS DVD can be copied to a file server PC enabling you to install ADS from this file server. This arrangement is useful for doing silent installations (see Silent Installations). The following steps explain how to set up the file server and run the installation on client PCs. Agilent EEsof recommends that you use the Windows Explorer to create folders and copy files in this procedure.

Note File server (UNC) based installations for ADS 2008 are not officially supported.

1. On the file server PC, create a folder and subfolder on a sharable hard disk using the structure shown in the following figure. This example assumes the folders are created on the C: drive.
   

   Note The contents of the ADS PC installation DVD must be copied into the dvd folder shown in this example.

2. Insert the ADS PC installation DVD into the file server's DVD drive. If the Setup program starts automatically, cancel it at your first opportunity.
3. Copy the contents of DVD into the folder D:\ADS2008\dvd.
   To ensure coping all files, select the DVD drive in Windows Explorer, and choose Edit > Select All, then Edit > Copy. Next, select the DVD folder and choose Edit > Paste.
   Remove the DVD from the DVD drive after all files are copied.
4. On the file server PC, share the folder D:\ADS2008.
   In Windows Explorer, select the folder, then choose File > Properties. Select the Sharing tab, and complete the information. Click OK.
5. For each client PC on which you want to install ADS, map the client to the folder D:\ADS2008 on the file server PC. In Windows Explorer, choose Tools > Map Network Drive and complete the information.
6. On the client PCs, run setup.exe from the mapped network drive. You may run the normal installation described in Detailed Installation, or the silent installation described in Silent Installations.

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.

Setting the HOME Directory

Use the following steps to specify the $HOME variable value in the registry for each version of ADS.

Caution Use extreme care when editing the system registry. The computer may not function properly if the registry contains an error. You should backup the registry as a precaution. For more information, see the Registry Editor's online Help.

1. Click on Start > Run.
2. Type in regedit.exe and click OK.
3. In the registry editor, select HKEY_LOCAL_MACHINE > SOFTWARE > Agilent > ADS > ( ADS version ) > eeenv
4. Select HOME and choose Edit > Modify to enter the desired location.
5. Close the registry editor.

Repeat these steps for each version of ADS.

Setting the HOME Environment Variable

Alternatively, you can set the $HOME variable as an environment variable. In this case, you will need to set it up in an MS-DOS batch script and run that batch script to start ADS.

Note If you install ADS using a non-standard method and use an MS-DOS batch script to start ADS, you will not be able to install off-cycle products (addons, hotfixes, MSRs). To install off-cycle products, you must have a valid ADS installation with standard registry entries.

Script for ADS 2006A

Script for ADS 2006 Update

Choose the ADS version by running the appropriate script. As a last step, you need to make sure that the Start in variable is set correctly on the desktop shortcut:

1. Right-click the desktop shortcut that you use to start ADS.
2. Click Properties.
3. Click the Shortcut tab.
4. Verify that the Start in value is the same as the $HOME variable setting.

Silent Installations

The InstallShield program provided with ADS supports a silent installation using Microsoft's Windows Installer (MSI) technology. A normal (non-silent) installation receives the necessary input from the person installing the software in the form of responses to prompts in dialog boxes. However, a silent installation does not display prompts for inputs. Instead, a silent installation gets inputs from the InstallShield silent response (.iss) file.

Silent Installation Overview

Here is an overview about how to set up and run a silent installation on a Windows PC for ADS 2008.

1. On a server PC's sharable hard disk, copy the contents of the ADS PC installation DVD to a folder. Details about setting up a file server are described in Installing from a File Server.
2. Share this folder and map the folder to a client machine.
3. On client PCs, run the setup.exe utility using arguments for a silent installation, including the file name for a response file.
4. If needed, run a silent uninstallation to remove ADS from client PCs.

Response File Contents

When a normal installation runs, the inputs to prompts are entered manually into dialog boxes. During silent installations, the inputs are provided automatically by a response file. The command to execute a silent installation includes the file name for a specific response file. ADS provides two sample response files. They are copied into the folder where the ADS PC installation DVD are copied onto the file server PC. For example, if the DVD contents are installed in D:\ADS2008\dvd, the sample files are located in D:\ADS2008\dvd\silent. The sample response files are:

• typical.iss performs a Typical installation.
• complete.iss performs a Complete installation.

The sample response files contain the default settings used for the normal Typical and Complete installations defined in Detailed Installation. They supply the following inputs requested by the installation program:

• Install ADS 2008 into the folder C:\ADS2008.
• Set the home folder to C:\users\default.
• Place shortcut icons for the Start menu in a default location.

If you want to change these settings, edit the response file directly. Be careful to locate and change only the settings in question to avoid corrupting the file:

• To change the installation folder, change C:\ADS2008 to a new setting.
• To change the home folder setting, change C:\users\default to a new setting.

Running a Silent Installation

To run a silent installation on a client PC, run the setup.exe utility using the silent installation switch and identify which response file to use:

1. On the client PC, verify that ADS 2008 has not already been installed. There should not be a C:\ADS2008 folder since the silent installation process is not expecting it to be there. If ADS has been installed, uninstall it.
2. On the client PC, open a Command Prompt or DOS prompt window. In a command prompt, change to the folder D:\ADS2008\dvd that is shared by the server PC.
3. Execute the setup.exe command. Use the silent installation option /s and identify the full path for the response file and log file using /f1 and /f2.

   Note When entering the paths for the response and log files, do not enter a space after the /f1 or /f2 switches; place double quotation marks around the path.

   The following example commands spawn a process running a Complete installation silently. The process appears in the Task Bar. The log file is written to the temp folder on the C: drive.
   cd D:\ADS2008\dvd
   setup /s /f1"D:\ADS2008\dvd\silent\complete.iss" /f2"C:\temp\complete.log"

4. After waiting 3 to 5 minutes for the installation process to finish, change to the folder $HPEESOF_DIR\tools \ lib \ dpkg, and run the tail command as shown in this example:
   cd C:\ADS2008\tools\lib\dpkg
   ..\..\bin\tail -f adsinstalllog.txt
   You will see the following message at the end of the log file when the process is done:
   End of silent installation

Running a Silent Uninstallation

When you need to run a silent uninstallation on a client PC, use the sample batch file, uninst.bat. Using our example location for the DVD contents, it is located in the folder D:\ADS2008\dvd\silent.
To run a silent uninstallation:

1. In a command prompt, change to the folder containing the batch file.
   cd D:\ADS2008\dvd\silent
2. Copy the uninstall response file to the folder C:\temp and run the batch file:
   copy uninst.iss C:\temp
   .\uninst
   This process opens a progress dialog box. When the dialog box closes, the process is done.

Troubleshooting

The most effective way to troubleshoot errors with the silent install/uninstall process is to run the same type of installation in normal or visual mode.

Creating Your Own Response File

A response file contains information that a person running a normal installation would usually enter as responses to dialog boxes. During a silent installation, when setup.exe is run with the /s option, setup.exe reads the necessary input from the response file at run time.

A response file is a plain text file consisting of sections containing data entries. A response file's format resembles that of a .ini file, except a response file uses the .iss extension.

To create a response file, run setup.exe using the /r option in a command prompt. This runs the installation normally, and records your inputs into a response file that can be used during a silent installation. By default, the response file is called setup.iss, and is created in the Windows or WinNT folder. To specify a different name and location for the response file, use the /f1 switch with setup.exe. For example, the following commands change to the folder containing setup.exe, run setup.exe, and create a response file. This command runs an installation session in a normal visual mode:

cd D:\ADS2008\dvd
setup /r /f1"c:\temp\mysetup.iss"

On another PC, or on the same PC after you uninstall ADS, you can play back or run this response file by running the command

setup /s /f1"c:\\temp\\mysetup.iss"

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. This can be the same PC on which you installed ADS and the Connection Manager client, or it can be a separate, stand-alone PC server. The server software is located on the CD-ROM labeled Connection Manager Server 2008 Installation Disc. The Connection Manager server does not require a license regardless of where it is installed. For instructions about installing the Connection Manager server, see Installing Connection Manager Server. For general information about Connection Manager, see the documentation Connection Manager.

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 the ADS 2008 Connection Manager server onto the PC you will use as the server.