Installation and Configuration

Overview

This chapter describes how to install the Zebra SMS and 123Scan on recommended platforms.


Download the SMS Solution from the Web

Both the SMS Solution and 123Scan must be downloaded to utilize the SMS Solution. Both utilities can be downloaded from www.zebra.com/sms, or download 123Scan from www.zebra.com/123Scan.)


System Requirements

123Scan Requirements

Hardware Requirements

  • Pentium Dual-Core E214 1.6GHz or Pentium Mobile Dual-Core T2060 or Pentium Celeron E1200 1.6GHz
  • 2GB RAM and 1.2 GB free hard drive space
  • USB port, 1.1 or higher, for the connection of USB Scanners

Software and Operating System Requirements

  • Microsoft Windows 7 or 10 (32 bit/64 bit)
  • If not present, Microsoft .NET Framework 3.5 SP1 loaded at time of initial 123Scan installation
  • Minimum display resolution = 1024 by 768 pixels

SMS Solution Requirements

Supported Operating Systems

The Zebra SMS supports the following Operating Systems:

  • Windows 7 SP1 (32bit and 64bit)
  • Windows 10 (32bit and 64bit)

SMS Solution Size

The Zebra SMS 32bit installation package is approximately 20 MB in size. The Zebra SMS 64bit installation package is approximately 30 MB in size. Once installed in a production environment, the SMS solution size decreases.

Table 1 Installed SMS Solution Sizes

Typical Installed Solution Size 32bit 64bit
SMS agent 4 MB 9 MB
SMS Package for one model scanner 3 MB 3 MB
Total required space 7 MB 12 MB


Installing the Solution

The following steps show the process to install 123Scan and the SMS Solution.

Install 123Scan (v5.0 or newer)

To install 123Scan:

  1. Go to www.zebra.com/us/en/support-downloads/software/utilities/123scan-utility.html.
  2. Scroll down to the Software section and select and run the relevant OS download for your PC (123Scan 32bit or 123Scan 64bit).
  3. The Zebra CoreScanner Driver is a prerequisite for both the 32bit and 64bit setup programs. The installation process checks for the CoreScanner driver on the target PC. If the CoreScanner driver is not present, or is outdated, clicking Install adds updated drivers before installing the Zebra 123Scan package.

    Figure 1 Installation of Zebra CoreScanner Driver Window

    The Microsoft .NET Framework is also a prerequisite for Zebra 123Scan. If .NET is not available in the system, the installer lists it as a requirement and installs it as part of the setup process.

  4. Click Next in the Welcome window.

    Figure 2 Welcome Window
  5. Review the license agreement and click Yes to accept.

    Figure 3 License Agreement Window
  6. Click Install to install 123Scan.

    Figure 4 Ready to Install Window
  7. As the installation proceeds, the status displays.

    Figure 5 Installation Status Window
  8. When the installation is complete, the following window displays. Click Finish.

    Figure 6 Installation Complete Window

Install SMS

To install SMS:

  1. Go to www.zebra.com/us/en/support-downloads/software/utilities/scanner-management-service-for-windows.html.
  2. Scroll down to the Software section and select and run the relevant OS download for your PC (SMS 32 Bit, or SMS 64 Bit).
  3. If you previously installed 123Scan on the same PC, the Zebra CoreScanner Driver (a prerequisite for both the 32bit and 64bit setup programs) was already installed. If you are installing the SMS Solution first, or on a different PC than 123Scan, the CoreScanner driver automatically installs before the SMS Solution installation.
  4. Click Next in the Welcome window.

    Figure 7 Welcome Window
  5. Review the license agreement and click Yes to accept.

    Figure 8 License Agreement Window
  6. Click the appropriate radio button for the type of setup to install.

    • Complete setup installs all Zebra SMS components.
    • Custom setup allows the user to de-select Start menu shortcuts for Developer Utilities.
    Figure 9 Select Type Window
  7. Click Next to continue with the installation.

    Figure 10 Select Feature
    Figure 11 Select Default SMS Package
  8. Click Install to continue.

    Figure 12 Ready to Install Window
  9. When the installation is complete, the following window displays. Click Finish.

    Figure 13 Installation Complete Window

Silent Unattended Installation of the Zebra Scanner Management Service

The CoreScanner driver and the Scanner Management Service (SMS) require the Microsoft 2017 C++ Redistributable Package which automatically installs if it is does not already exist on the host PC. For an unattended installation, a complication arises if the 2017 C++ Redistributable is not pre-installed. By default, Microsoft triggers a reboot of the PC after the C++ Redistributable installation. In this case, a reboot is injected into the overall silent install process (which may then also require a login).

To avoid the interruption, the 2017 C++ Redistributable can be downloaded from Microsoft (see links below) and pre-installed silently while suppressing the reboot using the command line switches /install /quiet /norestart. This delays the required reboot and allows custom silent CoreScanner and SMS installs to be performed using subsequent commands.

The Visual C++ Redistributable for Visual Studio 2017 can be downloaded from the Microsoft website (see links below). The appropriate file vc_redist.x86.exe (32bit version) or vc_redist.x64.exe (64bit version) must be selected and downloaded. The command line to perform its install silently without reboot is:


vcredist_x86.exe /install /quiet /norestart

or,


vcredist_x64.exe /install /quiet /norestart

The required reboot must be performed at the end of the overall installation process to ensure correct operation.

The Zebra Scanner Management Service and prerequisite CoreScanner driver are packaged using the Flexera InstallShield installer program. Options can be selectively installed using the Custom Installation option. In conjunction with this custom install option, the installer program supports command line switches to record custom responses that can be used to create a silent install response file. These response files, ending in the file extension .iss, may then be used to perform a silent installation of the CoreScanner driver and SMS components on production PCs.

Silent Install Command Line Options

Command Line Switch Description

Table 2 Command Line Switch Description

Switch Description
-s Silent mode. The -s switch runs the installation in silent mode using the responses contained in a recorded response file.
-r Record mode. The -r switch displays all the setup dialogs and records the chosen responses in the file specified with the -f1 switch described below.
-f1 Specify custom response file name and path. The -f1 switch specifies where the response file is located for the -s switch, or where it should be created when using the -r switch. Specify an absolute path; using a relative path yields unpredictable results.
-f2 Specify alternative log file name and path. When running an installation in silent mode (using the -s switch), the log file is created by default in the same directory and with the same name (except for the extension) as the response file. The -f2 switch enables you to specify an alternative log file location and file name. Specify an absolute path; using a relative path yields unpredictable results.

When executed from a command prompt, the example below uses the -r and -f1 switches to record your responses to the setup prompts into a custom response file:


“Zebra_CoreScanner_Driver_(64bit)_v3.07.0002.exe" -r -f1"c:\path\CSsetup.iss"

The responses chosen using the command above are saved in the specified response file and can then be used as input to silently install the CoreScanner with those chosen responses on production PCs.

The next example shows how the -s switch uses the response file created with the previous command to perform the silent install:


"Zebra_CoreScanner_Driver_(64bit)_v3.07.0002.exe" -s -f1"c:\path\CSsetup.iss"

Note that there is no space between the -f1 switch and first quotation mark for the custom response file.Additionally, you would perform the above steps for the silent installation of the SMS. Record the SMS response file using the -r switch on a PC that does not yet have SMS installed:


“Zebra_Scanner_Management_Service_(64bit)_v4.02.0010.exe" -r -f1"c:\path\SMSsetup.iss" 

Then use that resulting response file with the -s switch to install silently on other PCs:


“Zebra_Scanner_Management_Service_(64bit)_v4.02.0010.exe" -s -f1"c:\path\SMSsetup.iss"

If necessary, the -r switch option can also be used to record a custom response file for a silent removal of a program by running the command on a PC that has that program already installed.

2017 C++ Redistributables v14.16.27012 Download links:

x86: https://download.visualstudio.microsoft.com/download/pr/d0b808a8-aa78-4250-8e54-49b8c23f7328/9c5e6532055786367ee61aafb3313c95/vc_redist.x86.exe

x64: https://download.visualstudio.microsoft.com/download/pr/9fbed7c7-7012-4cc0-a0a3-a541f51981b5/e7eec15278b4473e26d7e32cef53a34c/vc_redist.x64.exe


Components and Folder Paths

SMS Components

Table 3 SMS Components

Component Description Installation Path
SMS agent folder SMS installation folder. User cannot customize this location. %ProgramFiles%\Zebra Technologies\Barcode Scanners\SMS
SMS Package download folder Folder on PC host in which SMS Packages are placed for processing. %ProgramFiles%\Zebra Technologies\Barcode Scanners\SMS\Download
SMS default log folder Default log file folder. User can change the logging location in the package at creation time. %ProgramFiles%\Zebra Technologies\Barcode Scanners\SMS\Download\Logs
Launch SMS as an Application Executable file to launch SMS as an application. %ProgramFiles%\Zebra Technologies\Barcode Scanners\SMS\SmsService.exe
Start SMS agent Script file to start the SMS agent. %ProgramFiles%\Zebra Technologies\Barcode Scanners\SMS\Start SMS Agent.bat
Stop SMS agent Script file to stop the SMS agent. %ProgramFiles%\Zebra Technologies\Barcode Scanners\SMS\Stop SMS Agent.bat
Release notes Release notes. %ProgramFiles%\Zebra Technologies\Barcode Scanners\Release Notes Windows SMS.pdf

123Scan Components

Table 4 123Scan Components

Component Description Installation Path
Application Application EXE and the supporting DLLs of the program %ProgramFiles%\Zebra Technologies\Barcode Scanners\123Scan2
Configuration files Default location of Configuration Files Users\Public\Documents\123Scan2\Configuration Files
Activity reports Default location of Activity Reports Users\Public\Documents\123Scan2\Activity Report Database
Data view reports Default location of Data View Reports Users\Public\Documents\123Scan2\Data View Reports
Saved images Default location of Saved Images Users\Public\Documents\123Scan2\Images
SMS Packages Default location of SMS Packages Users\Public\Documents\123Scan2\ SMS Packages
Scanner plug-Ins Scanner Plug-Ins ProgramData\123Scan2\Plug-ins
Application help document Application Help Document Program Files\Zebra Technologies\Barcode Scanners\123Scan2\Languages\en-us