Training & Support for your Systems2win templates

 

How to install
on behalf of another user

and how to install when you have less than Administrator privileges

Option A

Grant the user temporary Administrator permissions

  1. Temporarily grant the user Administrator privileges

    then log in as that target user (the person who will actually use Systems2win)

  2. Complete ALL of the installation steps

    (while logged in as the user — with administrative privileges)

  3. Change the user back to their usual privileges

All of the other options assume that you are installing Version 12 or higher !!!

If you are installing Version 11 or lower, then you must use Option A


Bookmark = RunAs

Option B

Use a different user's Administrator password

  1. Double-click the Systems2win exe file

    With Excel closed...

    Run the Systems2win exe file

    (Either double-click it, or right-click > Run As Administrator)

    (If your IT Department provided a custom installation file, run that instead)

    Enter a valid Administrator username and password,
         (perhaps temporarily granted from your IT Department)
    and accept all of the default options.

  2. Download and open this Excel file

    Logged in as the user (the person who will actually use Systems2win)
    who has Standard (not Administrator) permissions...

    Download and open this Excel file

    Systems2win-Finish-Install.xlsm

    (the macro that gets launched from this Excel file will automatically create the HKEY_CURRENT_USER registry entries that must be made when logged in as the target user — and cannot be installed by a generic administrator account)

  3. Finish installation

    You are now ready to finish the standard installation process, and verify installation success.


Bookmark = faster

Option C

Finish the install that your IT Department started

  1. Your IT Department already installed the Systems2win exe file

    They sent you an email notifiying you that you now need to finish the installation that they started

  2. Download and open this Excel file

    Logged in as the user (the person who will actually use Systems2win)
    who has Standard (not Administrator) permissions...

    Download and open this Excel file

    Systems2win-Finish-Install.xlsm

    (the macro that gets launched from this Excel file will automatically create the HKEY_CURRENT_USER registry entries that must be made when logged in as the target user — and cannot be installed by a generic administrator account)

  3. Finish installation

    You are now ready to finish the standard installation process, and verify installation success.


Bookmark = manual

Option D

Activate add-ins

How to manually activate your add-ins

Manually activate

Although the Systems2win-Finish-Install file is usually easier...

there are unusual circumstances when Systems2win might suggest to manually activate your add-ins.

Here's how to do it...

See the animated image >>>

Excel > File (or Office button) > Options > Add-ins

Click the Go button

Select the Browse button
Browse to the folder where Systems2win is installed
     (usually C:\Program Files (x86)\zSystems2win)
select S2winCom.xlam, click OK.

Then do the same to activate Systems2winXLL.xll



Training Matrix

Perhaps use your Training Matrix template to maintain your list of users

Keep a list of users

If you have more than a few users,

keep a list of users that have this Systems2win application installed
so that you know who needs the upgrade installed each year.

Tip: If you don't maintain a list of users, you can quickly identify your users
by writing a script to find all users on your network that have a zSystems2win folder
in either Program Files or Program Files (x86).

Of course you will still need to manually identify any laptop users not always connected to your network,
so it's a good idea to maintain a list of all users that have this application installed,
as suggested in the training for Systems2win Leadership Roles.


Bookmark = custom

Everything below this line is technical information for your IT Department

Your own custom installation file

Your IT Department has the option to use any text editor

(such as Notepad, or Textpad...)

or their favorite software packaging and distribution application

(such as Microsoft SCCM or SMS System Management Service, or Novell ZenWorks, or Altiris...)

to write a script or package to make installation faster and easier:

  1. by double-clicking your custom installation file (that does a few special things)
  2. or by prompting the user to install the next time they log in
  3. or by silently "pushing" the software (then notifying the user to finish the installation)

If your IT Department has created a custom installer...

It should come with instructions from YOUR IT Department for how to use YOUR installer.

And those instructions should always be sure to instruct your users
to follow the usual instructions for how to verify installation success.

Do not repackage the EXE as an MSI

It might be tempting to use a snapshot capturing tool or "intent wizard" to attempt to convert our EXE file into an MSI, or some form of ghost or imaging installer.

Don't do it.

Why not?

If you simply overwrite the registry entries to Open and Open1 at HKEY_CURRENT_USER > Software > Microsoft > Office > 14.0 (or whatever version you have installed) > Excel > Options , then that will work... but will blow away any other Excel add-in that might already be using those same registry keys.

You need an installer that is intelligent enough to assign registry entries to the next available "Open" keys — which might be Open3 and Open4.

And what if a user has a different version of Office and/or Windows?

That's what our installers (and vb scripts) do that a repackaged msi won't.
It's okay to wrap the EXE into an MSI, but don't repackage.

Sample Installation Script

Here is a sample install script

Install Script


Things your installation script might do

Alternative Portal Location

If some of your users require a portal setup decision that is different from the default way that most of your users synchronize with your master files on your central server,

then simply write an alternative script that replaces the Systems2win.ini text file

Legacy Installer

If some of your users need to open legacy documents (version 10 or lower)...

then you could write your custom script to install both
the regular Systems2win exe and the Legacy Compatibility Installer

but you might decide to install the Legacy Compatibility Installer separately,
because many (most?) of your users might not need it,
especially if you encourage most users to migrate data from their old working documents to the new master templates

Silent Install

To run silently (accepting all defaults)

Follow the command with " /s"

And then be sure to come up with your own way to notify your user

that they need to finish the installation
(following the instructions near the top of this page)

Uninstall

Upgrades usually don't require uninstall

Since 2002, we have had 15 version upgrades,
and only 2 of them have been major enough to require uninstallation.

Usually, you simply install the new version overtop of the old one, with no need to uninstall.

To uninstall, use Control Panel > Programs and Features

Learn more about uninstall

Silent Uninstall

IF your user has Administrator permissions

Because you need to remove HKEY_CURRENT_USER registry entries,
this file must be launched by the target user (not a generic administrator account)

So this alternative will only work if the user has administrative permissions.

AND you are uninstalling a version of Systems2win that is newer than v12 Build 23 (May 1, 2015)

THEN you can use RemoveSilent.exe to uninstall silently.

RemoveSilent.exe is found in the zSystems2win folder where Systems2win is installed.

 

The Remove2.exe removes the (optional) Legacy Compatibility Installer, and it runs silently

but it also needs to remove HKEY_CURRENT_USER registry entries,
and therefore must be launched by the target user (not a generic administrator account)

 

If you are uninstalling a version of Systems2win that is older than v12 Build 24 (released May 1, 2015),
then download this silent-remove.zip, and follow the instructions in the readme.

Bookmark = txt

Special modifiers in the custom.txt file

To run any special modifiers in the custom.txt file,

follow the command with " /m=custom.txt"

Example that you might add to your custom script:

runas /user:yourdomain\ administrator "Systems2winInstall_v15_1A_ALL_YYMMDD.EXE /s /m=custom.txt"

Example for how to run the custom.txt file from the command prompt (without a script):

Assuming that you have already customized your custom.txt file...

(as instructed in the next section)

In Windows File Explorer:

Browse to the folder that contains both your Systems2winInstall exe file and your custom.txt file.

Hold down the Shift key as you right-click that folder in Windows File Explorer,
then select 'Open Command Window Here'

In the Command Window:

(with the correct folder already selected - as instructed above)

Type:

Systems2winInstall_v15_1A_ALL_YYMMDD.EXE /m=custom.txt
(where Systems2winInstall_v15_1A_ALL_YYMMDD.EXE is the name of your install file)

cmd window

then click Enter

to launch the installer

Download custom.txt, then use Notepad to edit the following modifiers:

Custom txt

LANGUAGE_IN=<Country Code>

Example: LANGUAGE_IN=34 will set the Systems2win menu to default to the Spanish language for that user.

33 for French. 55 for Portuguese. 86 for Chinese. 49 for German. 20 for Arabic. 1 for English.

Note: This sets the language for the Systems2win menu and dialogs.
All templates always default to English,
unless you have personalized your master template to default to another language.
Learn more about language translations.

DESKTOP_ICONS=NO

Will not install the desktop icon.

This is relevant only if you are installing logged in as the user with their own Administrator permissions.
If you are using Run As Administrator, there is no way to install icons to the (unknown) user's desktop.

If you want the desktop icon installed, simply change this to =YES.

ACTIVATE=NO

Will not attempt to activate.

This is relevant only if you own a license for a limited number of seats.
If you own a license for unlimited users, there is no activation needed.

If you want to automatically activate, simply change this to =YES.

CUSTOM_EXCEL_PATH

Usually, the installer will automatically locate where Excel is installed,
and will handle everything automatically.

If you get the error message that the installer cannot locate a supported version of Excel,
(perhaps because your IT Department decided to install Excel to some unique folder)
then
(if your installation file is newer than March 8, 2016)
you can:

1) Use Windows File Explorer to find where your IT Department (creatively) installed Excel.exe

and then replace CUSTOM_EXCEL_PATH=NO

with CUSTOM_EXCEL_PATH=C:\custom\folderpath
where C:\custom\folderpath is the path where Excel.exe is located. Leave out Excel.exe; just the path.

2) Specify the installed version of Excel

One (and only one) of the Excel versions must =YES

IS_EXCEL_64_BIT

In the (unlikely) event that the DLL is missing from your \Windows\SysWOW64\Kernel32\ folder...

you can also add another line at the bottom to specify the bitness of Excel.

If 32-bit Excel:

IS_EXCEL_64_BIT=0

If 64-bit Excel:

IS_EXCEL_64_BIT=1


Migration software to clone an entire drive

If you migrate your Systems2win application using imaging or ghost software that clones the entire hard drive,

then you will need to manually activate each user.