TransMagic has advanced distribution options built into its standard installer which support a multitude of distribution scenarios.
For reference simply running the standard TransMagic installer has the following effects:
• Displays the TransMagic End User License Agreement (EULA).
• Removes any previous version of TransMagic that may be present on the system.
• Installs all necessary TransMagic redistributables.
• Installs itself on the system and integrates into Windows in the following ways:
a. Installs all core program functionality into the %ProgramFiles% directory by default, which will have the form:
i. %ProgramFiles%\TransMagic Inc\TransMagic RXX spX
b. Installs the TransMagic license manager program functionality into the CSIDL_COMMON_APPDATA directory, which will have the form:
i. CSIDL_COMMON_APPDATA\TransMagic\Licensing
ii. This directory structure must never be modified.
c. Installs the TransMagic Sample Files into the CSIDL_COMMON_DOCUMENTS directory, which will have the form:
i. CSIDL_COMMON_DOCUMENTS\TransMagic\Sample Files
ii. This directory structure is optional.
d. Populates the Windows application paths registry key:
i. HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\App Paths\TransMagic.exe
ii. Values (Value name \ Value data):
1. (Default) \ %ProgramFiles%\TransMagic Inc\TransMagic RXX spX\System\TransMagic.exe
2. InstallDir \ %ProgramFiles%\TransMagic Inc\TransMagic RXX\
iii. You can query the InstallDir value for the current TransMagic end-user install path.
e. All component registration, environment establishment and registry entries are created at run-time.
The TransMagic installer is an InstallShield "Setup.exe" single compressed installer based on Windows MSI installer technology. Thus, the TransMagic installer will accept more commands than are listed below. For a complete set of commands see the complete lists linked here:
• Installshield Setup.exe command line parameters
a. All Setup.exe command line parameters are sent after the /v"<option> <option> <option>" switch. Examples to follow.
• Windows MSI MsiExec.exe command line parameters
a. All MsiExec.exe command line parameters are sent directly after the .exe and before the /v switch mentioned above.
TransMagic specific installer options:Parameter
SILENT
Use to specify a silent install. Silent installs have no or limited UI and thus, several assumptions must be made:
• No redistributables are installed. As an admin using this option, you will need to run the installer once until it gets to the start page. At this point there will be a new folder in the %TEMP% directory that contains the uncompressed installer and redistributables. You can copy the redistributables from this directory and then cancel the install.
• No End User License Agreement (EULA) is displayed. By using the Full Silent option, acceptance of the EULA is implied on behalf of the company, the user and any other users on the machine. The EULA will also be contained in the uncompressed temporary install location mentioned above for reference of acceptance.
• By default no CAD Add-Ins are installed. These can be installed with additional command line calls below.
• The license will be a Node-Locked license. This can be changed to Floating with an additional option mentioned below.
You have the following options for a silent install:
• Full Silent: /s /v"/qn SILENT=1"
• This option will not display any progress meter or UI.
• Progress meter only: /s /v"/qb SILENT=1"
• This option will display a progress meter UI.
LANGUAGE
If not running a silent install you can specify the language that you would like to run the install in. This does not set the start-up language. This only sets the installer GUI language. The Start-up language can be set in the in the TransMagic GUI by following the instructions in the Interface Customization section.
To set the language send the following MsiExec.exe option immediately after the installer .exe and before the /v"" switch (if used):
/l<Language ID>
Here the Language ID's match those available in the TransMagic GUI:
• 1033 = English (Default. Not necessary to specify)
• 1031 = German
• 1036 = French
• 1041 = Japanese
• 1034 = Spanish
• 1046 = Portugues
For example to specify German, your installer command would look like:
TransMagicRXX.XX.XXX.exe /l1031
INSTALLDIR
Use to specify the install directory to anything other than the default %ProgramFiles% directory. The actual directory needs to be between the (\") quote operator on both the front and back. For example, to specify the directory “D:\Unique Install Dir” as the new install directory this option would look like the following:
/v"INSTALLDIR\"D:\Unique Install Dir\""
SWADDIN
When running from the command line, the CAD Add-Ins will not be installed by default. To install these you will need to set a parameter at the command line. To install the SolidWorks Add-In set:
/v"SWADDIN=1"
INVADDIN
When running from the command line, the CAD Add-Ins will not be installed by default. To install these you will need to set a parameter at the command line. To install the Inventor Add-In set:
/v"INVADDIN=1"
NOPROG
There are times when you may not want to install a program group or desktop icon. In this case you can send:
/v"NOPROG=1"
LLS
Note that this option is no longer available and is only shown here for legacy systems which have not updated yet. This option tells TransMagic to start up "aware" of a Local License Server. This is an extra cost option and not used unless you've been told specifically to install using this option. A Local License Server or LLS is a behind-the-firewall local instance of a FlexNet Operations license server. This is off by default. To enable this, set:
/v"LLS=1"
SCIF
This parameter tells TransMagic to start-up in "Offline" mode. This means that the cloud base license server will not be checked and any licensing operations will work in "Offline Activation" mode. This option is intended to be used in such places as a "Sensitive Compartmented Information Facility" or SCIF; hence, the option is named SCIF. By default this is OFF. To enable Offline Start-up mode, set:
/v"SCIF=1"
PING
By default TransMagic will issue a ping command to determine if the license server can be found. This could be either FNO or an LLS. However, an IT organization may have disabled the ping command. In this case, TransMagic will display the following dialog:
Here TransMagic may be able to connect to the server and the user can choose the [Ignore] command but having to do this every time the user runs TransMagic is cumbersome. In this case, so long as the IT organization can confirm connection to the server beforehand, there is an install switch that will tell TransMagic never to ping the server and thus disable this dialog.
To disable ping for all users of the machine, set:
/v"PING=0"
UPDATES
By default TransMagic will automatically check for updates to the program. This can be a burden on an IT organization and so this can be disabled via an installer command.
To disable automatic update notifications for all users of the machine, set:
/v"UPDATES=0"
-setkey
Although technically not part of the installer, it is often times desired to automatically set the license on the machine as well. To do this, you would send a command line call to the tmcmd.exe executable with the -set key parameter. A Windows command line command would look like the following.
As TransMagic licensing is "per user" vs. "per machine", this needs to be done from the user account. If you have a start-up batch file for your users, you might place this in that file. It only needs to be run once but it doesn't hurt anything if you run it again.
set INSTALLDIR = *See obtaining the installation directory above*
cd %INSTALLDIR%\system\code\bin
tmcmd -setkey<Your Activation ID here, no spaces>
*** LEGACY OPTIONS ***
*** IGNORE THESE OPTIONS UNLESS SPECIFICALLY DIRECTED BY TRANSMAGIC LICENSE SUPPORT - THESE ARE NOT PART OF THE CURRENT LICENSE SYSTEM ***
LICENSETYPE
Specify Floating Network license install vs. default Node-Lock. The default is already a Node-Locked license so it is not necessary to set this. To set the license type to floating, send:
/v"LICENSETYPE=Floating"
LICENSETAKE
TransMagic has a legacy licensing system and a new licensing system. This parameter need never be set unless under very specific circumstances and instructed to do so by a TransMagic team member. The default licensing system is the new licensing system. To set the legacy licensing system send:
/v"LICENSETAKE=0"
TransMagic installer command line usage examples:
NOTE: Perform installations as Administrator
Here are some examples. Let's say we wanted a completely SILENT install. The command line would like the following:
TransMagicRXX.XX.XXX.exe /s /v"/qn SILENT=1"
A silent install with progress meters:
TransMagicRXX.XX.XXX.exe /s /v"/qb SILENT=1"
Let's say we wanted a SILENT install of the SolidWorks Add-In. Usage would be as follows:
TransMagicRXX.XX.XXX.exe /s /v"/qb SILENT=1 SWADDIN=1"
Let’s say we wanted a SILENT install and to specify the unique install directory “D:\Unique Install Dir”. Usage would be as follows:
TransMagicRXX.XX.XXX.exe /s /v"/qb SILENT=1 INSTALLDIR=\"D:\Unique Install Dir\""
When installations fail a log file is often handy as well. This is the /l switch. Usage would be as follows:
TransMagicRXX.XX.XXX.exe /s /v"/qb SILENT=1 SWADDIN=1 INVADDIN=1 /l* Install.log"
Here's an example where the version of the TransMagic exe is filled in, for reference:
TransMagicR14.20.200.exe /S "/v/qn SILENT=1 SWADDIN=1 INVADDIN=1"
Although listed above in the MSI command line parameters a handy switch is the uninstall switch, which is /x. Silent uninstall would be as follows:
TransMagicRXX.XX.XXX.exe /x /s /v"/qn SILENT=1"
Any of the above options can be sent in any order after the /v. After the /v there should be an opening quote (") and closing (") quote and there should be a space ( ) between every option.
In the example below, note that the double quote needs to occur after the v, and a second double quote completes the string.
TransMagicR14.10.000.exe" /s /v"/qb SILENT=1 SCIF=1 SWADDIN=1 INVADDIN=1"
Served Model Distribution
The usage of "served model" distribution requires a special license of TransMagic Workgroup. However, with this license and method, TransMagic can simply be run from it's own run directory anywhere on a system by following these instructions:
• You can directly copy the TransMagic run directory "%ProgramFiles%\TransMagic Inc\TransMagic RXX spX" to the user's machine and create a desktop shortcut for TransMagic.exe.
• You are very likely running a Network\Floating license of TransMagic so open the file "...\TransMagic RXX spX\System\code\bin\TMInfo.txt" and change the "Network=false" setting to "Network=true".
• Contact TransMagic Support at support@transmagic.com if you need any assistance with an VBS scripts to accomplish any of the above tasks as we have scripts on hand that accomplish all of these tasks that we'd be happy to share with you.