COSMOS
Installation and Service Packs Guide

Contents

 

Installation Methods

Applying Service Packs

Upgrading Installations to New Versions of the COSMOS Software

License Information

 

Installation Methods

This table shows the different ways to deploy and maintain the COSMOS® products (COSMOSWorks®, COSMOSMotion, and COSMOSFloWorks). Each method has an effect on how you install the initial version and on future service packs.

Method

Description

Service Packs

Best Suited for:

Individual installation from CD (most common)

Each seat is installed from the SolidWorks installation CDs.

Original CDs are required when patching.

Service packs are downloaded and applied to each computer.

Individual users

Users with administrative privileges during install and upgrade.

Locations where original CDs are available for installations and service packs.

Command prompt (silent installation*)

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

The system administrator applies a service pack to the administrative image**; service packs are downloaded and applied to each computer.

Users with administrative privileges during install and upgrade.

System administrators who want a customized installation.

 

* Silent installations

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

** Administrative images

An administrative image is a source image of the COSMOS software on a network. It is similar to a source image on a CD-ROM. Users who have access to the administrative image can install the product from this source.

To serve the COSMOS application files across a network, you create an administrative image of the COSMOS application files on a server's hard drive. You can install the administrative image from any computer on the network, including the client computer.

The resulting administrative image is a structure of folders in an uncompressed format. Once the administrative image is created, additional installations on computers across the network can be started from this server location.

Client computers can access the administrative image to run a COSMOS application on their local computers. An installation must be performed on each client computer before it can access and use the COSMOS application on the server.

Items to note:

 

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 SolidWorks Disk 4 into your CD-ROM drive, and follow the on-screen instructions. You may need to reboot your computer when installation is complete.

If you install the COSMOS software with the CD, and you apply a service pack to the installation at a later time, you need the original CD set to upgrade to a service pack.

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

Dialog box notes:

Specify COSMOS License Information

See License Information.

COSMOSWorks Option

Select one or more COSMOS applications to install.

COSMOS 2007 Install Choice

  • New installation. Select this option if you do not have an existing COSMOS installation.

  • Select an existing installation to upgrade. Select this option to upgrade your existing COSMOS installation, then select the version to upgrade.

Destination Folders

Install the COSMOS software on a local drive, not on a network drive. Identify the path to the SolidWorks software.

 

Command Prompt

To create an administrative image with a command prompt:

  1. Insert SolidWorks Disk 4 into your CD-ROM drive.

  2. Open the Command Prompt window.

  3. In the Command Prompt window, enter:

msiexec /a <Msi_path>

Type msiexec ? for a list of parameters.

In the command prompt above, the variable, Msi_path, represents the path and filename of the .msi file for your operating system and language. The COSMOSWorks .msi file name is constructed as follows:

i386_COSMOSWorks_<language>.msi

Values for <language>

Czech

Chinese

Chinese-Simplified

English

French

German

Italian

Japanese

Korean

Polish

Russian

Spanish

A sample command prompt is:

msiexec /a F:\cwwi\COSMOSWorks\i386_COSMOSWorks_English.msi

  1. Follow the on-screen instructions in the COSMOSWorks 2007 Installation Wizard dialog box.

Removing an administrative image

To remove an administrative image from the server:

  1. Make sure there are no active COSMOS sessions.

  2. Make sure that the COSMOS application is uninstalled from all the machines on which it was installed.

  3. Delete the administrative image from the server.

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 /qn 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 examples as templates 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>

  • Upgrade an existing version

msiexec /i "<Msi_path>" INSTALLDIR="C:\Program Files\<your_chosen_folder>" SOLIDWORKSPATH="<path to SolidWorks>" CWUPGRADEINSTALL=1, /qn

Client

The properties described above

msiexec /i "<Msi_path>" INSTALLDIR="C:\Program Files\<your_chosen_folder>" SOLIDWORKSPATH="<path to SolidWorks>" CWUPGRADEINSTALL=1, /qn

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, Properties, 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

ACTIVSERIALNUMBER

Serial number for COSMOS product. Format is xxxx xxxx xxxx xxxx xxxx xxxx.

Defined for individual installations and client installations from an administrative image.

CWUPGRADEINSTALL

Upgrades an existing version of a particular COSMOS application software.

1: Update

2: New installation; install in a new directory

Defined for individual installations and client installations from an administrative image.

INSTALLDIR

Specifies the installation directory for a particular COSMOS application software.

Defined for individual installations only.

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.

Defined for individual installations and client installations from an administrative image.

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.

Defined for individual installations and client installations from an administrative image.

SOLIDWORKSPATH

Specifies the folder where the SolidWorks software is installed.

Defined for individual installations and client installations from an administrative image.

SWDISTSUBTYPE

Specifies the SolidWorks edition installed on the computer.

0: Commercial Edition

2: Educational Edition

3: Student Edition

TARGETDIR

Specifies the installation directory for a particular COSMOS application software.

Defined for administrative installations only.

 

Modifying, Repairing, or Removing an Installation

To modify, 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 (COSMOSWorks 2007 SP0 for example.)

  5. Based on your operating system, click the appropriate button to modify or delete the installation. If you are modifying an installation, go to the next step; otherwise, confirm the deletion to delete the installation.

  6. In the COSMOSWorks 2007 Setup dialog box, click Next.

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

 

Applying Service Packs

A service pack is the means by which product updates are distributed. Service packs may contain updates for system reliability, program compatibility, security, and more. Service packs are applied as patches to an existing software version. For example, COSMOSWorks 2007 SP1 is a service pack for COSMOSWorks 2007 SP0.

Downloading a Service Pack from the Web

  1. On www.solidworks.com, click Customers.

  2. On the Information for SolidWorks Customers page, click SolidWorks Subscription Service website.

  3. Type your SolidWorks serial number, then click Login.

  4. Click Downloads.

  5. Under COSMOSWorks, COSMOSFloWorks, COSMOSMotion, COSMOSEMS, click the link for the service pack you want to apply.

  6. Read the license agreement, then click Accept Agreement & Continue.

  7. Select the language, operating system, and software you want, then click Continue.

  8. For each product you plan to download, write down the Size. You need this information later in the installation.

  9. Click each product to download.

  10. In the dialog box, click Save and save the file on your computer.

  11. After the download is complete, confirm that the size is the same as the size you noted previously. If the file sizes do not match, you must download the service pack again.

Applying Service Packs to Individual Installations from CD

Minimum requirements

To apply a service pack to individual installations from CD:

  1. Double-click the service pack executable you downloaded from Downloading a service pack from the web. An example file name is cw2007_sp00210_i_Eng.exe.

An unzipping utility appears.

  1. Unzip the executable.

  2. In the COSMOSWorks Service Pack Manager Wizard, select Upgrade an individual installation of COSMOSWorks.

  3. Click Next and follow the instructions.

Applying Service Packs to Client Installations

  1. Apply the service pack to the administrative image with the steps in To apply service packs to administrative images using the command prompt.

  2. Locate the installation file (.msi) of the administrative image.

  3. Double-click the installation file to start the update.

  4. In the Specify COSMOS License Information dialog box, select I want to skip the license configuration.

  5. In the COSMOS 2007 Install Choice dialog box, choose Select an existing installation to upgrade.

  6. Click Next and follow the instructions.

Applying Service Packs to Administrative Images Using the Command Prompt (Silent Installation)

The administrative image you used must be accessible and in the same location where you originally installed it.

  1. Double-click the service pack executable you downloaded from Downloading a service pack from the web. An example file name is cw2007_sp00210_i_Eng.exe.

A .msp file is extracted. An example file name is cw2007_sp00210_i_Eng.msp.

  1. In the COSMOSWorks Service Pack Manager Wizard, click Cancel.

  2. Open the Command Prompt window.

  3. In the window, enter:

msiexec /a <path_to_.msi_file_of_an_administrative_image> /p <path_to_.msp_file>

Example: msiexec /a C:\adminimage\COSMOSWorks\i386_COSMOSWorks_English.msi /p C:\CW2007SP10Unzip\cw2007_sp00210_i_Eng.msp.

  1. Follow the on-screen instructions.

 

Upgrading Installations to New Versions of the COSMOS Software

An upgrade is a new version of software installed from either an administrative image or from a new set of CDs. For example, COSMOSWorks 2007 is an upgrade from COSMOSWorks 2006.

Upgrading an Administrative Image

You must install the new version of software as a new administrative image. You cannot modify the existing administrative image.

To upgrade an administrative image:

  1. Create a new administrative image from the service pack CD-ROM.

  2. Follow the steps in Applying service packs to client installations to install COSMOS 2007 on each client computer.

  3. When the COSMOS 2007 Install Choice dialog box appears, click Select an existing installation to upgrade, then select the version to upgrade in the list.

 

Upgrading with Silent Installations

To upgrade an existing version of COSMOS with a silent installation, use the /i and /qn 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 of COSMOSWorks, enter the command:

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

 

License Information

COSMOS supports four types of license:

Activating a Serial Number

Activation is a product licensing and registration process for COSMOS standalone product licenses.

Activation requires that you have Internet or email access. After activation, you do not need to be online to use the products. If you do not have email access on the computer where you use this product, you can save the activation file and send it from another computer.

This process:

To activate a license:

  1. Start the application.

If you have not yet activated your license, the Product Activation dialog box appears.

  1. Select:

  2. Supply your contact information.

  3. Obtain the license key:

  1. The Activation/Reactive Succeeded dialog box displays the products that have been activated.

License Transfer

To transfer your license to another computer, first transfer it back to the license key server at SolidWorks Corporation, then reactivate it on the new or upgraded computer.

If you were unable to transfer the license back to SolidWorks (because of hard drive failure, for example), reactivation is still successful in most cases. If not, contact your VAR for help.

To transfer a license back to the server:

  1. In SolidWorks, click Help, License Transfer.

  2. To reactivate, go to the new or upgraded computer and follow the procedure above as for the initial activation.

To view active licenses:

In SolidWorks, click Help, Show Licenses.

Obtaining a License File

You need to obtain a license file for all license types that do not use a serial number. 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.solidworks.com and click Services, Support, COSMOS, License Request Form.

  2. Fill out the License Request Form.

Using an Individual License

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

To use 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, SolidWorks, COSMOS Tools, 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.

Using 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 SolidWorks Disk 4 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 use 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, SolidWorks, COSMOS Tools, 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.