Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

SpinFire Ultimate Enterprise Distribution Overview

This page contains details on the use and behavior of SpinFire Ultimate .MSI installers and .MST language transform files that can be used with enterprise software distribution tools, such as MATRIX 42.

Default Language - The current culture of the target workstation.

Product Code - {F84A911D-FC39-491E-8661-0EE1A8016A91}

See SpinFire Ultimate Releases for a list of SpinFire Ultimate product IDs.  

Default Installation Directory - C:\[Program Files Directory]\Actify\SpinFire\11

Command Line Reference
https://technet.microsoft.com/en-us/library/bb490936.aspx

Enterprise Parameter ListEnterprise Installation Parameters

Files for Distribution

.MSI files - SpinFire Ultimate installation files that can be used with software distribution tools.

.MST files - In cases where the default SpinFire language is other than the current culture (language setting) of the target workstation, .MST files can be used to apply the desired application interface language.

.MSI and .MST Language Transforms

Code Block
themeDJango
SpinFire.x86.msi - x86 SpinFire Ultimate Installation .MSI
SpinFire.x64.msi - x64 SpinFire Ultimate Installation .MSI
1031.mst - x86/x64 German Language Transform File
1033.mst - x86/x64 English Language Transform File

Command Line Installation Examples

SpinFire x86 - Default installation folder and language, no UI:

Code Block
msiexec.exe /i SpinFire.x86.msi /qn

SpinFire x64 - Custom installation folder, default Language, no UI:

Code Block
msiexec.exe /i SpinFire.x64.msi /qn INSTALLDIR="C:\[Custom Directory]\SpinFire\11"

SpinFire x64 - Custom directory and German language setting (for use on target workstations with current culture other than German), reduced UI:

Code Block
msiexec.exe /i SpinFire.x64.msi /qb INSTALLDIR="D:\Apps\SpinFire" TRANSFORMS=1031.mst
Warning
titleImportant

When using the command line, the order of the arguments matters. Type the commands exactly as shown.

Suppressing Reboots

Some customers run into other issues with forced system reboots. The following are examples to suppress automatic reoboots.

SpinFire x64 - Suppress the UI, reboot and reboot messages.

Code Block
msiexec /i "SpinFire.x64.msi" /qn REBOOT=ReallySuppress /norestart

SpinFire x64 - Give minimal UI but suppress reboot and reboot messages.

Code Block
msiexec /i "SpinFire.x64.msi" /qb REBOOT=ReallySuppress /norestart

Command Line Uninstall Examples

Remove of SpinFire Ultimate using the product code, reduced UI:

Code Block
msiexec.exe /x {F84A911D-FC39-491E-8661-0EE1A8016A91} /qb
Info

Additional information on .MSI command line options is available from Microsoft: https://technet.microsoft.com/en-us/library/cc759262(v=ws.10).aspx

Additional Information

File Registrations

SpinFire.exe 

Font Registrations

Installed in the Windows fonts directory. Do not overwrite if already present on the target workstation.

MCAD2.ttf

monos.ttf

monosb.ttf

monosbi.ttf

monosi.ttf

MyriadCAD.otf

P22GDTFR.TTF

P22GDTNO.TTF

Included Microsoft Visual C++ Runtime Modules - Required

Visual C++ 9.0

Visual C++ 10.0

Visual C++ 11.0

Visual C++ 12.0

Visual C++ 2019

...

Disable “Check for Updates”

Under certain circumstances, it may be necessary to modify SpinFire

...

Settings if Internet access is not permitted from all workstations. In this case, the Check for Updates feature can be disabled by the system administrator, thereby preventing indiscriminate updates and ensuring a uniform work environment. It might also be desirable to force SpinFire users across the enterprise to use specific Settings or Configurations, such as default colours, Graphic settings and so forth.

  1. To disable the Check for Updates feature,

...

NOTE - DO NOT copy/paste the code examples below for your envirorments, this is for reference material only.

Copy Settings.config to C:\Program Files\Actify\SpinFire\11\

Code Block
languagexml
firstline1
titleSettings.config >> C:\Program Files\SpinFire\11
linenumberstrue
collapsetrue
<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <configSections>
        <sectionGroup name="applicationSettings" type="System.Configuration.UserSettingsGroup, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >
            <section name="SpinFire.Common.Properties.SharedSettings" type="System.Configuration.ClientSettingsSection, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" allowExeDefinition="MachineToLocalUser" requirePermission="false" />
        </sectionGroup>
    </configSections>
    <appSettings>
        <add key="Version" value="110704" />
    </appSettings>
    <applicationSettings>
        <SpinFire.Common.Properties.SharedSettings>
            <setting name="SharedSettingsDirectoryPath" serializeAs="String">
                <value>C:\ProgramData\Actify\SpinFire11</value>
            </setting>
            <setting name="SharedSettingsEnabled" serializeAs="String">
                <value>True</value>
            </setting>
        </SpinFire.Common.Properties.SharedSettings>
    </applicationSettings>
</configuration>

...

  1. do the following:

    1. Set the Check for Updates field to Never.

    2. Set the Use Custom Updates URL field to blank—any attempt to use Help > Check For Updates will fail.

Create Shared Settings Configuration 

First you need to create your Settings.config file, this will need to be distributed by the Network Administrator to all client machines with SpinFire installed. It should contain nothing else but the “Shared Settings Enabled” , which will direct each SpinFire depoyment to use the ENTSettings.config; this file will host the predetermined configurations as chosen by the Admin.

  1. Open SpinFire in Admin mode

    1. To enable the shared settings option, right-click on SpinFire Icon and “Run as Administrator”.
      *NOTE: All the settings will show Locked by default. 

    2. Set the desired settings under the following pages (Make sure to select APPLY SETTINGS for each page). 

      1. Application / 3D Viewer / 2D Viewer / Importers

        Image Added
      2. Unlock any settings to allow End Users to control their own personal preferences and select APPLY SETTINGS. (e.g.: Unlock the Background color to allow the End User to change it.)

        Image Added

  2. Under the Options > Settings > Application Page

    1. Check the "Shared Settings Enabled" box.
      *NOTE: If this option is grayed out, then you will need to make sure you reopen SpinFire in Administrator Mode. 

    2. Add the directory path into the text field (e.g.: \\NETWORK\Storage\Actify\SpinFire Settings).
      *NOTE: This must be a UNC path, not shared Drive.

    3. Select APPLY SETTINGS.

      Image Added

      d. Tools > Export Settings > Save as Settings.config.

      Image Added

  3. Copy Settings.config for distributtion

    1. Now distribute the "Settings.config" file to all SpinFire client machines via your Company’s Distribution Software to the C:\Program Files\Actify\SpinFire\11 folder.

      Image Added
    2. Copy this file to a safe location.

      1. You will distribute this file, during the installation process, to the SpinFire installation folder.

  4. Create ENTSettings.config

    1. Select Tools > Export Settings….

      Image Added
      1. Tick on the items you want to retain.

      2. Select EXPORT to save the file locally as ENTSettings.config.

        Image Added

Deploy Shared Settings on End Users Machine and Verify Changes

Deploy the following (2) files on End User Machine(s):

  • The Settings.config file from above needs to be stored on end user’s machine under the following directory:

    • C:\Program Files\Actify\SpinFire\11

...

  • The ENTSettings.config from above file

...

Code Block
languagexml
firstline1
titleENTSettings.config >> C:\ProgramData\Actify\SpinFire11
linenumberstrue
collapsetrue
 <?xml version="1.0" encoding="utf-8"?>
<configuration>
    <configSections>
        <sectionGroup name="applicationSettings" type="System.Configuration.UserSettingsGroup, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >
            <section name="SpinFire.Common.Properties.SharedSettings" type="System.Configuration.ClientSettingsSection, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" allowExeDefinition="MachineToLocalUser" requirePermission="false" />
        </sectionGroup>
        <sectionGroup name="userSettings" type="System.Configuration.UserSettingsGroup, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >
            <section name="SpinFire.Common.Properties.ApplicationSettings" type="System.Configuration.ClientSettingsSection, System, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" allowExeDefinition="MachineToLocalUser" requirePermission="false" />
        </sectionGroup>
    </configSections>
    <appSettings>
        <add key="Version" value="110704" />
    </appSettings>
    <applicationSettings>
        <SpinFire.Common.Properties.SharedSettings>
            <setting name="SharedSettingsDirectoryPath" serializeAs="String">
                <value> </value>
            </setting>
            <setting name="SharedSettingsEnabled" serializeAs="String">
                <value>True</value>
            </setting>
        </SpinFire.Common.Properties.SharedSettings>
    </applicationSettings>
    <userSettings>
        <SpinFire.Common.Properties.ApplicationSettings>
            <setting name="CustomUpdatesURLEnabled" serializeAs="String">
                <value>True</value>
            </setting>
            <setting name="CustomUpdatesURL" serializeAs="String">
                <value> </value>
            </setting>
        </SpinFire.Common.Properties.ApplicationSettings>
    </userSettings>
</configuration>

Adding these files does the following:

  1. Sets the Check for Updates field to Never then locks it to prevent changes by end users.

  2. Sets the Shared Settings Enabled field to the proper folder.
  3. Sets the Use Custom Updates URL field to blank—any attempt to use Help > Check For Updates will fail.

Image Removed

...

  • needs to be placed in the location defined on the “Shared Settings” path, such as:

    • \\NETWORK\Storage\Actify\SpinFire Settings\

 

End Users should see the following:

  • Now, when the End User starts SpinFire, the application will read the distributed Settings.config in the C:\Program Files\Actify\SpinFire\11 folder

  • SpinFire will also read the ENTSettings.config from the location specified in the "Shared Settings" path.

  • Any unlocked settings, changed by the End User, will still be stored in their personal user settings file.

    • C:\Users\<USER NAME>\AppData\Local\Actify\SpinFire11\Settings.config