Academic Company Events NI Developer Zone Support Solutions Products & Services Contact NI MyNI
9 ratings:
 2.55 out of 5     Rate this Document

Distributing Measurement Studio ActiveX Applications

Primary Software: Measurement Studio>>Professional Edition (Base Package)
Primary Software Version: 6.0
Primary Software Fixed Version: N/A
Secondary Software: N/A

Problem:
How do I redistribute Measurement Studio ActiveX applications?

Solution:
After you have created applications with Measurement Studio, you might want to distribute those applications to other computers as an executable file of some type. Depending on the programming environment in which you created your application, you might be able to automatically create an installer that contains the necessary files for distribution. However, in some cases, you will need to manually copy and register all of the files on which your application depends.

Automatic Creation of Installer
To distribute applications, you must create an installer that installs the application on the target computer. The installer you create must include support files for your Measurement Studio application. These files are located in the \Redist directory on the Measurement Studio installation CD. This directory includes merge modules, run-time files, and National Instruments installers. Some or all of these files may be required for the application to run on the target computer. Refer to the Distribution Status column in the NI Installers table for more information about which files you can freely distribute.

When choosing which files to include in your installer, consider the following questions:

  • Are you creating an MSI or non-MSI-based installer?
  • What components does your Measurement Studio application use?
  • What third-party files do you need to distribute, and where do you need to install them on your user's machine?

MSI and Non-MSI-Based Installers
If you use an MSI-based installer application, you must include the appropriate merge modules in your installer package. If you use a non-MSI-based installer application, you must include the run-time files in your installer and register the appropriate .ocx or .dll file. You must also design your installer to check the version numbers of the .ocx and .dll files to ensure that you do not overwrite a newer version with an older version.

Measurement Studio Components
After you have determined what type of installer you want to create, determine what components your Measurement Studio application uses. Include the necessary support files for those components in your installer. The following tables list the Measurement Studio components and their related MSI and non-MSI-based files. Refer to the appropriate table for the type of installer you are creating.

MSI-Based Installers
The following table lists the Measurement Studio and third-party merge modules that may be needed in your MSI installer.

Measurement Studio Component Measurement Studio Merge Module1 Dependent Merge Modules2
3D Graph MStudio3DGraph.msm
opengl32.msm
glu32.msm
Comcat.msm
Comctl32.msm
Mfc42.msm
Msvcp60.msm
Msvcrt.msm
Oleaut32.msm
488.2

-

Mfc42.msm
Msvcp60.msm
msvcrt.msm
Analysis

-

Mfc42.msm
Msvcp60.msm
msvcrt.msm
Common

-

Mfc42.msm
Msvcp60.msm
msvcrt.msm
Common User Interface

-

Mfc42.msm
Msvcp60.msm
msvcrt.msm
DataSocket

-

Mfc42.msm
Msvcp60.msm
msvcrt.msm
LabVIEW Real-Time Interface

-

-

NI-Reports3 NIReports.msm
NiPaths.msm
Comcat.msm
Msvcp60.msm
Msvcrt.msm
Oleaut32.msm
User Interface MStudioUI.msm
NIMesaDLL.msm
NiPaths.msm
Comcat.msm
Comctl32.msm
Mfc42.msm
Msvcp60.msm
Msvcrt.msm
Oleaut32.msm
Utility

-

Mfc42.msm
Msvcp60.msm
msvcrt.msm
VISA

-

Mfc42.msm
Msvcp60.msm
msvcrt.msm


1The .msm files are located n the \Redist\MeasurementStudio\MSMs directory on the Measurement Studio CD.
2The third-party merge modules are installed with the application you are using to create an MSI-based installer. Look for these merge modules in the appropriate installation directory.
3NI-Reports requires DCOM 1.2 or later on Windows 95 machines.

Non-MSI-Based Installers
The following table lists the individual Measurement Studio and third-party files that may be needed for a non-MSI-based installer.

Measurement Studio Component Measurement Studio Unpackaged Files1 Installation Location2 Third-Party Files3
3D Graph cw3dgraph.ocx windows\system[32] mfc42.dll
msvcrt.dll
oleaut32.dll
olepro32.dll
stdole.tlb
msvcp60.dll
opengl32.dll4
glu32.dll4
488.2

-

-

mfc42.dll
msvcrt.dll
msvcp60.dll
Analysis

-

-

mfc42.dll
msvcrt.dll
msvcp60.dll
Common

-

-

mfc42.dll
msvcrt.dll
msvcp60.dll
Common User Interface

-

-

mfc42.dll
msvcrt.dll
msvcp60.dll
DataSocket

-

-

mfc42.dll
msvcrt.dll
msvcp60.dll
LabVIEW Real-Time Interface

-

-

-

NI-Reports5 NIReports.dll NI-Reports under the
National Instruments
shared directory.6
Msvcp60.dll
msvcrt.dll
User Interface cwui.ocx
mesa.dll7
install cwui.ocx to
windows\system[32]

Install mesa.dll to the
mesa directory under
the National Instruments
shared directory
mfc42.dll
msvcrt.dll
oleaut32.dll
olepro32.dll
stdole.tlb
Utility

-

-

mfc42.dll
msvcrt.dll
msvcp60.dll
VISA

-

-

mfc42.dll
msvcrt.dll
msvcp60.dll


1The Measurement Studio unpackaged files are located in the \Redist\MeasurementStudio\UnpackagedFiles\ on the Measurement Studio CD. Look in the appropriate component folder for each component's unpackaged files.
2windows\system[32]represents the directory you set up to contain all system files on your particular operating system.
3Search in the Microsoft Knowledge Base for article 259403 for more information about redistributing the third-party files listed in the Third-Party Files column in the Non-MSI-Based Installer table.
4opengl32.dll is required for Windows95 Retail only. glu32.dll is required for Windows95 Retail only. Do not install opengl32.dll or glu32.dll if they already exist on the target computer.
5NI-Reports requires DCOM 1.2 or later on Windows 95 machines.
6The National Instruments shared directory is stored in the NISHAREDDIR value under the HKEY_LOCAL_MACHINE\SOFTWARE\National Instruments\Common\Installer registry key.
7Do not register this file.


National Instruments Installers
Several of the Measurement Studio components that you might include in your applications are stand-alone run-time systems for which National Instruments provides an installer. The following table lists these installers and information regarding the redistribution status of each. When you distribute these installers, you must include them with your installer and instruct your users to run them separately from your installer. These installers are located in the \Redist\NiInstallers\ directory on the Measurement Studio CD. Look in the appropriate folder for each component installer. You must distribute the entire contents of the appropriate component folder.

NI Installers Distribution Status
NI-DAQ2 Freely distributable
DataSocket Freely distributable
GPIB Freely distributable
IVI
  • IVIEngineSetup
  • BICDSetup3
  • IVI-specific driver installers4
Freely distributable
NI-VISA Not freely distributable1


1These installers are not freely redistributable. Before you include these installers in your application, you must either verify that each target machine for your application already has a valid license for the associated National Instruments application, or you must get written distribution authorization from National Instruments. You can freely distribute the VISA runtime engine which can be found on the NI Drivers and Updates.
2This NI-DAQ installer is valid only for Measurement Studio features. You can get the full NI-DAQ installer from National Instruments or from the NI-DAQ hardware installation.
3You run this installer only if your application uses any of the following IVI class drivers:
  • IviDCPwr
  • IviDMM
  • IviFGen
  • IviScope
  • IviSwitch
4Visit IDNET to get the most up-to-date driver installers for each driver you use in your application.

Additional Information
The following list includes additional considerations you must make as you create an installer to distribute your Measurement Studio applications to other computers.
  • User's system requirements
    • Windows 95: DCOM 1.2 or later
    • Windows NT: Service Pack 3 or later

  • End user post-installation tips
    • If the program is not able to find a .ocx file or is not able to create a control, verify the following items:
      • The correct .ocx and support files are on the target computer.
      • The control is properly registered on the computer. Make sure you run the registration utility (regsvr32.exe) and ensure that it registers the control.

    • If the controls in the program run in evaluation (demo) mode, the program does contain the correct run-time license. When developing your program, verify that the controls are running in a fully licensed mode. Although most programming environments include a run-time license for the controls in the executable, some do not. If you are developing a program in Visual C++ using single document interface (SDI) or multiple document interface (MDI), you must include the run-time license in the program code for each control you create. Consult NI Technical Support if you are not familiar with this operation.


Related Links:
Drivers & Updates: NI-VISA Run-Time Enginer 4.3 for Windows
Developer Zone: Instrument Driver Network
Product & Services: Interchangeable Virtual Instruments (IVI)
Support: NI Technical Support

Attachments:





Report Date: 04/04/2003
Last Updated: 05/01/2009
Document ID: 2W3G520Q

Your Feedback! poor Poor  |  Excellent excellent   Yes No
 Document Quality? 
 Answered Your Question? 
  1 2 3 4 5
Please Contact NI for all product and support inquiries.submit