Upgrading Installations to New Versions of the COSMOS Software |
|
This table shows the different ways to deploy and maintain the COSMOS
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. |
A silent installation is administered without the display of a user interface or dialog boxes.
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 2007 as a separate installation from COSMOSWorks 2006.
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.
Specify COSMOS License Information |
See License Information. |
COSMOSWorks Option |
Select one or more COSMOS applications to install. |
COSMOS 2007 Install Choice |
|
Destination Folders |
Install the COSMOS software on a local drive, not on a network drive. Identify the path to the SolidWorks software. |
To create an administrative image with a command prompt:
Insert SolidWorks Disk 4 into your CD-ROM drive.
Open the Command Prompt window.
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
Follow the on-screen instructions in the COSMOSWorks 2007 Installation Wizard dialog box.
To remove an administrative image from the server:
Make sure there are no active COSMOS sessions.
Make sure that the COSMOS application is uninstalled from all the machines on which it was installed.
Delete the administrative image from the server.
To pass properties to a silent installation:
Open the Command Prompt window.
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 |
|
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 |
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.
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. |
To modify, repair, or remove the installation:
Make sure there are no active COSMOS sessions.
In Windows, open the Control Panel.
Double-click Add/Remove Programs.
In the dialog box, select the appropriate COSMOS application (COSMOSWorks 2007 SP0 for example.)
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.
In the COSMOSWorks 2007 Setup dialog box, click Next.
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.
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.
On www.solidworks.com, click Customers.
On the Information for SolidWorks Customers page, click SolidWorks Subscription Service website.
Type your SolidWorks serial number, then click Login.
Click Downloads.
Under COSMOSWorks, COSMOSFloWorks, COSMOSMotion, COSMOSEMS, click the link for the service pack you want to apply.
Read the license agreement, then click Accept Agreement & Continue.
Select the language, operating system, and software you want, then click Continue.
For each product you plan to download, write down the Size. You need this information later in the installation.
Click each product to download.
In the dialog box, click Save and save the file on your computer.
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.
You need the original CD set to upgrade to a service pack.
If you installed COSMOSWorks 2007 (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:
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.
Unzip the executable.
In the COSMOSWorks Service Pack Manager Wizard, select Upgrade an individual installation of COSMOSWorks.
Click Next and follow the instructions.
Apply the service pack to the administrative image with the steps in To apply service packs to administrative images using the command prompt.
Locate the installation file (.msi) of the administrative image.
Double-click the installation file to start the update.
In the Specify COSMOS License Information dialog box, select I want to skip the license configuration.
In the COSMOS 2007 Install Choice dialog box, choose Select an existing installation to upgrade.
Click Next and follow the instructions.
The administrative image you used must be
accessible and in the same location where you originally installed it.
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.
In the COSMOSWorks Service Pack Manager Wizard, click Cancel.
Open the Command Prompt window.
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.
Follow the on-screen instructions.
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.
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:
Create a new administrative image from the service pack CD-ROM.
Follow the steps in Applying service packs to client installations to install COSMOS 2007 on each client computer.
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.
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
COSMOS supports four types of license:
serial number. A serial number is entered during installation, then activated when the application is first used. Available in certain regions of the world.
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.
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:
Activates all software licenses across the COSMOS product line.
Allows you to transfer licensing rights from one computer to another.
Enables you to install and activate the COSMOS products on one work computer and one home computer.
Can be performed immediately or within 30 days of installation.
Eliminates the need for dongles. However, if you run previous versions of COSMOS products that do not use activation, you need to retain the dongle.
To activate a license:
Start the application.
If you have not yet activated your license, the Product Activation dialog box appears.
Select:
Internet or email
Home or office.
Supply your contact information.
Obtain the license key:
Online. Submit the request.
Email. Click Save to create a file, then send the file to activation@solidworks.com. When you receive the license key, run the activation procedure again and click Open to load the response file.
The Activation/Reactive Succeeded dialog box displays the products that have been activated.
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:
In SolidWorks, click Help, License Transfer.
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.
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:
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.
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.
Click Request License File.
Fill out the License Request Form.
- or -
After installation, go to http://www.solidworks.com and click Services, Support, COSMOS, License Request Form.
Fill out the License Request Form.
An individual license is a node-locked or hardware-locked license.
To use an individual license:
During installation, select I have a license file from COSMOS in the Specify COSMOS License Information dialog box.
Browse to license.dat.
- or -
After installation, click Start, All Programs, SolidWorks, COSMOS Tools, License Administrator Tool.
In the COSMOS License Administrator dialog box, on the Status tab, click Configure License.
Click Select COSMOS License File and browse to license.dat.
Click OK then Refresh.
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:
Insert SolidWorks Disk 4 into your CD-ROM drive.
Click Install COSMOS Network License Manager.
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 -
After installation, click Start, All Programs, SolidWorks, COSMOS Tools, License Administrator Tool.
In the COSMOS License Administrator dialog box, on the Status tab, click Configure License.
Select Set Port and Host of the License Server.
Type the values in Port Number and Hostname of License Server.
Click OK then Refresh.