Deploying Measurement Studio Network Variable Applications

Measurement Studio 2015 Support for Visual Studio 2013 Help

Edition Date: May 2015

Part Number: 375857A-01

»View Product Info
Download Help (Windows Only)
The Measurement Studio NetworkVariable class library does not support XCOPY deployment because the NetworkVariable class library requires some support files to be installed on the machine that runs the application. Because of this, you must deploy applications that use the NetworkVariable class libraries in a different way.

Note:
In this topic, the phrase target machine means the machine to which you are installing the application.

This topic contains the following sections:

Client Deployment vs. Server Deployment

You can deploy applications that use network variables in two ways, depending on the location of the network variables with respect to the target machine. Client deployment is a deployment scenario where the application uses network variables hosted on another machine. Server deployment is a deployment scenario where the target machine hosts the network variables.

Client Deployment In this scenario, you create an application that accesses variables on an existing server. You need to deploy the client application to other machines that continue to use the existing network variables. For this case, you can use either an installer built using Measurement Studio Installer Builder or a Microsoft Visual Studio setup project. An installer built with Installer Builder detects dependent runtime installers and an installer built using a Microsoft Visual Studio setup project detects dependent merge modules.
Server Deployment In this scenario, you must deploy the Shared Variable Engine to another machine that acts as the server. To deploy the Shared Variable Engine, you must:
  1. Select NI Variable Engine in the Installers to Include pane of the NI Drivers & Components tab within the Installer Builder application.
  2. Run a separate installer on the target machine.

    The required installer is installed with Measurement Studio to the [InstallDir]\ Redist\NINETVARSERV folder.

    You can view all command line options for running the installer with setup.exe /?. From the command line options, you can choose to run the installer silently.

    You can use Distributed System Manager to create and configure network variables on the server. Distributed System Manager is installed by Measurement Studio. To run the installer without installing the Distributed System Manager, run the setup.exe /prop SYSMANEXCLUDE=1 command. To run the Shared Variable Engine installer silently and without the Distributed System Manager, run the setup.exe /q /acceptlicenses yes /prop SYSMANEXCLUDE=1 command.

Creating Network Variables During Deployment

There is no supported method to automatically deploy network variables with your application; network variables must be manually created on the target machine. You can create the required variables during deployment by using one of the three different methods: implicitly created variables, network variable classes, or Distributed System Manager.

Using Implicitly Created Variables

Implicitly created variables are created when a writer attempts to connect to the variable. Because implicitly created variables need not exist before usage, an application that uses implicitly created variables does not require additional steps to create the variables.

You should use implicitly created variables in the following scenarios:

Refer to the Implicitly Created Variables section in Key Measurement Studio Network Variable .NET Library Features for more information.

Using the Network Variable Class Libraries

You can use ServerProcess, ServerProcessInfo, ServerVariable, and ServerVariableInfo to explicitly create and configure variables on the target machine. If you are performing a server deployment, your application can use these classes to create the network variables as needed, or you can write an application to create the variables as part of the deployment process.

You should use the network variable class libraries to programmatically create network variables in the following scenarios:

  • You need to write to network variables simultaneously from multiple applications.
  • You need the network variables to persist after the application is closed.
  • You need to configure a client-side buffer for the network variables.
  • You need to specify a data type for the network variables.
  • You need to automate configuration for network variables.

Refer to Explicitly Creating Network Variables for more information.

Using Distributed System Manager

You can use the Distributed System Manager application to create and configure network variables on a machine. Distributed System Manager is installed as part of the server deployment scenario described in the Server Deployment section. Select Start»All Programs»National Instruments»Distributed System Manager to launch the application.

You should use Distributed System Manager to manually create network variables in the following scenarios:

For more information about creating and configuring variables with Distributed System Manager, refer to the Creating, Modifying, or Deleting Shared or Network Variables topic in the NI Distributed System Manager Help. In Distributed System Manager, select Help»System Manager Overview to access the help.

Deploying Network Variable Windows Forms Applications

The Deploying Measurement Studio Windows Applications topic contains most of the information required to deploy a Windows Forms application that uses network variables.

Note:
If the deployment scenario is a server deployment, you must include the Shared Variable Engine in your installer by selecting NI Variable Engine in the Installers to Include pane of the NI Drivers & Components tab within the Installer Builder application.

See Also

WAS THIS ARTICLE HELPFUL?

Not Helpful