COSMOS Installation Instructions

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:

  • The administrative image can take 200MB of disk space for COSMOSWorks, 115MB for COSMOSMotion, and 200MB for COSMOSFloWorks.
  • Clients will not automatically upgrade when the administrative image is upgraded.
  • You can install a newer version of the COSMOS software in parallel to a previous version. For example, you can install COSMOSWorks 2006 as a separate installation from COSMOSWorks 2005.

 

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 2006 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 2006 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 /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 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
  • German language
  • 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 ADDLOCAL=German, /qb
Client The properties described above msiexec /i "<Msi_path>" INSTALLDIR="C:\Program Files\<your_chosen_folder>" SOLIDWORKSPATH="<path to SolidWorks>" CWUPGRADEINSTALL=1 ADDLOCAL=German, /qb

The following table shows the features available for the ADDLOCAL and ADDSOURCE properties. When you install the COSMOS applications as a client, use ADDSOURCE instead of ADDLOCAL. Command prompt feature names are case sensitive, cannot contain spaces or dashes, and must be separated by commas.

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

Feature

Command prompt syntax

Language support:

 
Czech Czech
Chinese ChTraditional
Chinese Simplified ChSimplified
English English
French French
German German
Italian Italian
Japanese Japanese
Korean Korean
Polish Polish
Russian Russian
Spanish Spanish

The above language list is valid for COSMOSWorks only. COSMOSMotion is available in English, Chinese, French, Italian, German, and Japanese. COSMOSFloWorks is available in English and Japanese. COSMOSM® is available in English only.

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

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 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 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 2006 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 2006 Setup dialog box, click Next.
  7. In the Program Maintenance dialog box, select one of the following options:
    • Modify. To add or remove COSMOS features. Follow the on-screen instructions to modify the application.
    • Repair. To reinstall the COSMOS application using the current installation parameters. The Repair option is useful if the COSMOS installation is corrupt. Follow the on-screen instructions to repair the installation.
    • Remove. To completely remove the COSMOS application. Follow the on-screen instructions to remove the applications.

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 2006 SP1 is a service pack for COSMOSWorks 2006 SP0.

Downloading a Service Pack from the Web

  1. On the SolidWorks website 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

  • You need the original CD set to upgrade to a service pack.
  • If you installed COSMOSWorks 2006 (SP0) with a web download, you need to update the installation with the CD (SP0) before you can apply a service pack.

To apply a service pack to individual installations from CD:

  1. Double-click the service pack executable you downloaded from the SolidWorks website. An example file name is cw2006_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 2006 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 the SolidWorks website. An example file name is cw2006_sp00210_i_Eng.exe.

A .msp file is extracted. An example file name is cw2006_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:\CW2006SP10Unzip\cw2006_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 2006 is an upgrade from COSMOSWorks 2005.

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 2006 on each client computer.
  3. When the COSMOS 2006 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 /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 of COSMOSWorks, enter the command:

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

License Information

COSMOS supports three types of license:

  • node-locked. This license type is tied to a particular computer based on its MAC address. This license is best suited for individuals.
  • hardware-locked. This license type is tied to a hardware lock or dongle. This license is best suited for individuals.
  • network. This license type allows users to float the use of their COSMOS licenses without exceeding the number of licenses purchased. This license type is best suited for multiple seat installations.

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:
    • Hardware Lock License. Select to receive a hardware-locked or node-locked license. You need the serial number of the dongle for a hardware-locked license. You need the Host ID or MAC address of the computer where COSMOS is installed for a node-locked license.
    • Network License for HOSTID. Select to receive a network license. Write down the Host ID or MAC address of the license server shown in the list.
    • Demo License.
  1. Click Request License File.
  2. Fill out the License Request Form.

- or -

  1. After installation, go to the SolidWorks website and click Services, Support, COSMOS, 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, 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.

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