COSMOSDesignSTAR Installation Guide

Contents

 

Installation Methods

Upgrading Installations to New Versions of the COSMOS Software

License Information

 

Installation Methods

This table shows the different ways to deploy and maintain the COSMOSDesignSTAR product.

Method

Description

Best Suited for:

Individual installation from CD (most common)

Each seat is installed from the installation CD.

Individual users

Users with administrative privileges during install.

Locations where original CDs are available for installations.

Command prompt (silent installation*)

Installation parameters are specified with a command prompt (command line) or batch file.

Users with administrative privileges during install.

System administrators who want a customized installation.

 

* Silent installations

A silent installation is administered without the display of a user interface or dialog boxes.

 

Individual Installation from CD

An individual installation is one in which the COSMOS software resides and runs on a user's computer.

To install on a local computer from the CD:

Insert the COSMOSDesignSTAR CD into your CD-ROM drive, and follow the on-screen instructions. You may need to restart your computer when installation is complete.

Due to Microsoft limitations, you cannot install the application from a remote CD-ROM drive.

Dialog box notes:

Specify COSMOS License Information

See License Information.

Destination Folders

Install the COSMOS software on a local drive, not on a network drive.

 

Command Prompt

Passing properties to a silent installation

To pass properties to a silent installation:

  1. Open the Command Prompt window.

  2. In the Command Prompt window, use the /i and /qb options of the msiexec.exe command, and set the global properties for those installation options that you want to be different from the default values.

Use the following example as a template for a silent installation. A detailed description of all properties is in the Properties section of this document.

Installation type

Properties

Example

Individual

  • location: C:\Program Files\<your_chosen_folder>

msiexec /i "<Msi_path>" INSTALLDIR="C:\Program Files\<your_chosen_folder>"

The English command prompt syntax must be used regardless of the language you install.

Global properties and multi-seat silent installations

If you are installing multiple seats of the COSMOS application, you may find it convenient to use a remote installation application to install the seats over the network, without displaying the installation dialog boxes. See the next section for a list of the global properties to pass to the remote installation program.

Properties

The following is a list of all the defined global properties and their meanings.

Property

Description and format

INSTALLDIR

Specifies the installation folder for the software.

LICENSEFILEPATH

Specifies where you have the COSMOS license file on your computer. After the installation, this file is automatically copied into the COSMOS installation directory.

LICENSEHOSTNAME

Host name of the server machine.

This property must be specified if you are using the property SELECTIONWITHLICENSE="2" in the command line option.

LICENSEPORT

Port number of the server machine.

This property must be specified if you are using the property SELECTIONWITHLICENSE="2" in the command line option.

SELECTIONWITHLICENSE

1: If you want to point to a license.dat file

2: If you want to use the portnumber@hostname option to access the license from a server machine.

 

Repairing, or Removing an Installation

To repair or remove the installation:

  1. Make sure there are no active COSMOS sessions.

  2. In Windows, open the Control Panel.

  3. Double-click Add/Remove Programs.

  4. In the dialog box, select the appropriate COSMOS application (COSMOSDesignSTAR 2006 for example.)

  5. Based on your operating system, click the appropriate button to repair or remove the installation. If you are repairing an installation, go to the next step; otherwise, confirm to remove the installation.

  6. In the COSMOSDesignSTAR 2006 dialog box, click Next.

  7. In the Program Maintenance dialog box, select one of the following options:

 

Upgrading Installations to New Versions of the COSMOS Software

An upgrade is a new version of software installed from a new CD. You can only have one version of COSMOSDesignSTAR on your computer at a time.

Upgrading from CD

To install from the CD, insert the COSMOSDesignSTAR CD into your CD-ROM drive, and follow the on-screen instructions. You do not need to manually uninstall the previous version of COSMOSDesignSTAR. You may need to restart your computer when installation is complete.

Upgrading with Silent Installations

To upgrade an existing version of COSMOS with a silent installation, use the /i and /qb options of the msiexec.exe command. See the Properties section for a list of the global properties that can be passed with the command prompt.

For example, to upgrade an existing version, enter the command:

msiexec /i "< Msi_path>" INSTALLDIR="C:\Program Files\<your_chosen_folder>"

 

License Information

COSMOS supports three types of license:

Obtaining a License File

You need to obtain a license file for all license types. The license file name is license.dat.

To obtain a license file:

  1. During installation, select I want to request for a license file through the internet in the Specify COSMOS License Information dialog box, then click Next.

  2. Select the preferred license type:

  1. Click Request License File.

  2. Fill out the License Request Form.

- or -

  1. After installation, go to http://www.cosmosm.com and click Services, Support, License Request Form.

  2. Fill out the License Request Form.

Activating an Individual License

An individual license is a node-locked or hardware-locked license.

To activate an individual license:

  1. During installation, select I have a license file from COSMOS in the Specify COSMOS License Information dialog box.

  2. Browse to license.dat.

- or -

  1. After installation, click Start, All Programs, COSMOSDesignSTAR, License Administrator Tool.

  2. In the COSMOS License Administrator dialog box, on the Status tab, click Configure License.

  3. Click Select COSMOS License File and browse to license.dat.

  4. Click OK then Refresh.

Activating a Network License

To use a network license, you must install the license service on a server then connect clients to this license service.

To install the COSMOS Network License Manager:

  1. Insert the COSMOSDesignSTAR CD into your CD-ROM drive.

  2. Click Install COSMOS Network License Manager.

  3. Follow the on-screen instructions to copy the license file and configure the COSMOS License Server Service on the server.

You cannot run the COSMOS software on the server using this installation.

To activate a network license on a client installation:

You must first prepare a license server with the steps in To install the COSMOS Network License Manager.

During installation, select Set Port and Host Name of License Server in the Specify COSMOS License Information dialog box.

The port number is specified in license.dat. You can open this file in a text editor. In the SERVER line, the last four digits are the port number. The default number is 7585.

The host name is the name of the computer acting as the host of the COSMOS license.

- or -

  1. After installation, click Start, All Programs, COSMOSDesignSTAR, License Administrator Tool.

  2. In the COSMOS License Administrator dialog box, on the Status tab, click Configure License.

  3. Select Set Port and Host of the License Server.

  4. Type the values in Port Number and Hostname of License Server.

  5. Click OK then Refresh.