We’ve developed some resources to help you work effectively from home during COVID-19 Click to learn more

Distribute SuperOffice

In this article

    What you are using as your distribution software does not matter, the basics are the same. You need a set of requisites for the SuperOffice client and some requisites for the SuperOffice Mail Link which is also used to register requests from Outlook to Customer Service.

    The requisites that are needed for the entire SuperOffice 7.5 to work are:

    Prerequisites Sales & Marketing windows client with mail link Sales & Marketing Web client with Web tools/Mail link Customer Service with Mail link  Office Ribbons
    Microsoft .NET Framework 4 sp1 Yes Yes Yes Yes
    Microsoft Visual C++ 2008 SP1 Redistributable Package (x86) Yes      
    Microsoft Visual C++ 2010  SP1 Redistributable Package (x86) Yes      
    Microsoft Visual Studio 2010 Tools for the Microsoft Office system (x86)
    or 
    Microsoft Visual Studio 2010 Tools for the Microsoft Office system (x64) 
    Yes Yes Yes Yes
    Microsoft Office 2010: Primary Interop Assemblies Yes Yes Yes Yes
    Microsoft Office 2007: Primary Interop Assemblies Yes Yes Yes Yes

    Note: The Microsoft Visual Studio 2010 Tools for the Microsoft Office system is called  "VSTO.4.0" and must be installed for the correct architecture (32 or 64 bit).

    In order to be able to automate the installations these requiestes must be downloaded from Microsoft or unpacked from the SuperOffice 7 installation media. Microsoft .NET Framework 4.0 sp1 must be downloaded because we do not ship it with the full installer.

    Our exefiles like SuperOffice.MailLink.Setup.exe is a installshield wrapper around the msi file SuperOffice.MailLink.setup.msi in addition to the prerequisites we need. It will first install our prerequisites and then run the msiexec. You may choose to install either with the MSI files (found in the SuperOffice 75 Server\Client\MSI folder) or our exefiles.Using our exefiles will as mentioned handle prerequisites correctly and also the difference between a minor and major upgrade* 
    If you choose to run the msifiles, then you must run the msiexec with a special parameter if this is a minor upgrade. A minor upgrade is typically a hotfix, moving from 7.1 to 7.5 is a major upgrade.

     

    Sales & Marketing windows client

    To unpack the SuperOffice7.exe file use the following command (path is just an example) c:\superoffice7.exe /k /d c:\SOInstallFiles

    /d <value> means you may specify the temporary directory to place the extracted files. This will leave you with the installfiles you may use to distribute. Once the Installer splashscreen with the different products appear you may cancel our installer. 
    /k means keep extracted files, don't delete them

     

    The extracted files are now found in the c:\SOInstallFiles folder.

    The SoInstaller.XML file is used by our installer, from it you will see what programs our installer will prompt you to close for the installation to be successful. The commands from this file is used to start the exefiles directly. It does NOT run via msiexec which is used for MSI files.

    These are the arguments:

    • /s - run InstallShipeld wrapper in silent mode
    • /v - pass the following parameters to msiexec
    • /v/qn - pass /qn to msiexec. For msiexec /qn means to run the msi silent without UI (it has a concept of several types of UI)
    • /v/REBOOT=ReallySuppress - This sends "REBOOT=ReallySuppress to msiexec. We do thsi to prevent the mashine from restarting after it has installed e.g the MailLink.
    • /v/SOBASEDIR=Dir - we send information about where the topfolder should be

    For package SuperOffice Mail Link and SuperOffice Mail Link for Office 2003 blocking programs will be:

    • Outlook.exe
    • SOCRM.exe
    • SOEventServer.exe

    For SuperOffice Sales & Marketing Windows client blocking programs will be:

    • SOCRM.exe
    • SOEventServer.exe
    • WinWord.exe
    • PowerPnt.exe
    • Excel.exe

    Our installers do not have a "killswitch" (it has been registered as a wish for future releases). One option is to use the MSIRMSHUTDOWN property: http://msdn.microsoft.com/en-us/library/aa370380(v=vs.85).aspx 

     

    To install SuperOffice Mail Link - to archive e-mail in SuperOffice from Outlook or Notes.

    SuperOffice.MailLink.Setup.exe /s /v/qn /v"REBOOT=ReallySuppress"

    To install SuperOffice Mail link  for Office 2003. If all clients have Office 2007 or higher there is no need to install it.

    SuperOffice.MailLinkLegacy.Setup.exe  /s /v/qn /v"REBOOT=ReallySuppress"

    To install SuperOffice Sales & Marketing Windows client. The SuperOffice7.mst file holds the configuration for SuperOffice.ini and SuperOffice.config.

    SuperOffice7.Windows.exe   /s /v/qn /v"REBOOT=ReallySuppress" /v"TRANSFORMS=x:\InstallDir\SuperOffice7.mst;"

     

    Note: Configure SuperOffice mail link using the SuperOffice.MailLink.ClientConfiguration.exe

     

    Sales & Marketing web client

    To get the distributable files for Sales & Marketing web client you may either get it directly from the <installdirectory for web client on the webserver>\Download folder, or go to File - Download - SuperOffice Web Tools in the Sales & Marketing web client to get the SuperOffice.web.tools.exe file.

    To unpack the files, run c:\SuperOffice.web.tools.exe /k /d c:\SOInstallFilesWeb

    /d <value> means you may specify the temporary directory to place the extracted files. This will leave you with the installfiles you may use to distribute. Once the Installer for SuperOffice Web Tools splash screen with the different products appear you may cancel our installer. 
    /k means keep extracted files, don't delete them

    The SoInstaller.XML file is used by our installer, from it you will see what programs our installer will prompt you to close for the installation to be successful. 

    For package SuperOffice Mail Link and SuperOffice Mail Link for Office 2003 blocking programs will be:

    • Outlook.exe
    • SOCRM.exe
    • SOEventServer.exe

    For SuperOffice web tools (Formerly known as TrayApp) blocking program is:

    • SuperOffiec.TrayApp.Client (the small owl in your computers system tray)

    Our installers do not have a "killswitch" (it has been registered as a wish for future releases). One option is to use the MSIRMSHUTDOWN property: http://msdn.microsoft.com/en-us/library/aa370380(v=vs.85).aspx 

     

    To Install SuperOffice Web Tool Plugin, integration between browsers and SuperOffice Client Applications.

    SuperOffice.WebTool.Plugin.exe /s /v/qn /v"REBOOT=ReallySuppress"

    To install SuperOffice Mail Link - to archive e-mail in SuperOffice from Outlook or Notes.

    SuperOffice.MailLink.Setup.exe /s /v/qn /v"REBOOT=ReallySuppress"

    To install SuperOffice Mail link  for Office 2003. If all clients have Office 2007 or higher there is no need to install it.

    SuperOffice.MailLinkLegacy.Setup.exe  /s /v/qn /v"REBOOT=ReallySuppress"

    To install SuperOffice Web Tools - automatic handling of documents in SuperOffice when you edit them on your local computer.

    SuperOffice7.Web.Extensions.exe  /s /v/qn /v"REBOOT=ReallySuppress"

     

    Note: Configure SuperOffice mail link using the SuperOffice.MailLink.ClientConfiguration.exe

     

    Customer Service

    From Settings - Summary the user may download SuperOffice.MailLink.Setup.exe and configure this. This is used to save email as requests or add messages to an existing request in Customer Service. If the user is only using Customer Service then the only possible blocking program will be Outlook.

    SuperOffice.MailLink.Setup.exe /s /v/qn /v"REBOOT=ReallySuppress"

     

    Note:Configure SuperOffice mail link using the SuperOffice.MailLink.ClientConfiguration.exe

     

    Upgrades to newer versions

    Note: Minor vs major upgrade. This instructs the installer who to handle the upgrade. For it to trigger a major upgrade the product code of the installed product and the product code for the upgrade must be different. 

    The installer will automaticly uninstall the previous version first if this is a major upgrade. If this is a minor upgrade, then the installer would not uninstall automatically. However, if you want to change install location you will have to uninstall first.

    To uninstall you may run either:

    Msiexec /x {Product.msi}

    or

    Msiexec /c {ProductCode}

     

    If this is a minor upgrade and you want to use the msifile, run the following command line:

    msiexec /i {Product.msi} REINSTALLMODE=vomus REINSTALL=ALL 

    If this is a major upgrade and you want to use the msifile, run the following command line: (This is the most used when upgrading to a newer version of SuperOffice)

    msiexec /i {Product.msi} 

    Replace {Product.msi} with the correct filename, like SuperOffice.MailLink.setup.msi

    If you want this to run silent, add /qn as parameter to msiexec
    msiexec /i /qn {Product.msi} 

     

    If you use the EXE files, then you run these as described above for installations. It will automatically handle minor and major upgrades and run the Msiexec with the correct parameters.

     

    Client upgrade warnings

    Before SuperOffice version 7.5 the client would automatically check what version the server had, and ask the user to upgrade if server version is newer than client version. We have changed this functionallity from 7.5 and you may now configure on the server if the clients should be asked to upgrade if they have a version older than a specific version. 

    Open web.config on the server where Sales & Marketing web is installed and add the following section in the

    <sectionGroup name="SuperOffice">
    ...
    <section name="Downloads" type="System.Configuration.NameValueSectionHandler, System, Version=1.0.5000.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"/>
    ...

    Now below </Documents> add the following new

    <Downloads>
      <add key="WebToolVersion" value="7.5.5199.1400" />
    </Downloads>

    If value is blank, we check against the current version installed on the server. So if you have installed 7.5 Patch 2 (Build 7.5.5253), but do not want your clients to be asked to upgrade if they have installed 7.5.5199 (Patch 1 of 7.5) you may set 7.5.5199.1400 in WebToolVersion value and the clients will only be prompted to upgrade if they are using a version older than 7.5.5199. If they are using an older version, but do not want to upgrade, they may tick the checkbox so it does not ask again. This information is stored in a persistent cookie which lasts till next server update. If the clients are running a 7.1 version of the web tools then they will be prompted to upgrade to 7.5 until the upgrade is done. 

    Older 

    For version 7.1 this is controlled by a registry setting. You may distribute a script which updates the following two keys and by setting th LastNotifiedServerUpdate to the version the server is currently running, this will be the same as the client ticking the box "Do not remind me about this update again"

    Windows Registry Editor Version 5.00

    [HKEY_CURRENT_USER\Software\SuperOffice\MailLink]
    "LastNotifiedServerUpdate"="7.1.5291.1400"
    "LastNotifiedServerUpdateUrl"="http://CorrectUrlToWebsite/FileDownload.aspx?filetype=file&id=SuperOffice.Web.Tools.exe"