Page 2
Vaisala Canada Inc and its subsidiaries assume no responsibility for any loss or claims by third parties which may arise through the use of this software. Vaisala Canada Inc and its subsidiaries assume no responsibility for any damage or loss caused by deletion of data as a result of hardware malfunction.
Page 5
Understanding The Tabs in Locations ....66 Building a Trend with the Trend Tab....67 Understanding the Dropdown Menus and Buttons in the Locations Tabs .
About this Manual About this Manual The viewLinc 4.0 Administrator Guide includes the information you need to install, configure and operate the viewLinc system. You can also view the Quick Start Guide for a graphical overview of installing viewLinc. If you are not an Administrator, refer to the User Guide for information on the standard tasks performed using viewLinc.
Chapter 8: Reports. Includes a definition of historical data, what you can do with it, how to generate reports. Chapter 9: Transfers. Includes information about how to transfer Vaisala Veriteq device data to a PC for analysis using vLog. Chapter 10: Mobile UI. Includes information about viewLinc’s Mobile application and its interface.
About this Manual Use vLog software and its associated Quick Start Guide for setting up Vaisala Veriteq devices and viewing and printing device historical data as graphs or text files. Use your specific Vaisala product User Guide for information about installing 300 Series Transmitters.
Chapter 1: Getting Started This section includes: • Overview of the Vaisala Veriteq Continuous Monitoring System (CMS) • Administrator’s Road Map • What’s New in viewLinc 4.0 • System Requirements, Hardware and Software • Installing viewLinc • Logging in to viewLinc from an Internet Browser to Monitor Conditions •...
Chapter 1: Getting Started Overview Welcome to viewLinc 4.0, a key element in the Vaisala Veriteq Continuous Monitoring System (CMS). Using viewLinc you can easily monitor device readings locally on a PC or across a network using a supported version of ®...
Page 13
• Requires installation of Digi drivers (provided) • Requires use of Digi device USB port Vaisala Veriteq • Allows devices to connect USB cable directly or over an Ethernet network (when device host is installed) to the viewLinc server •...
Once your viewLinc system is installed, you may find the following roadmap a useful overview of the setup and configuration activities required to implement viewLinc. Edit Vaisala Veriteq device properties using vLog. (such as sample timing and device channels - see vLog user guide for details)
Once these set up activities are complete, you are ready to start monitoring device readings, viewing events and printing reports. You can also set up transfer schedules to view and analyze Vaisala Veriteq device data in the vLog software (see “About Transfers and Transfer Schedules” on page 126) System Requirements To install viewLinc, you need: •...
Page 17
System Requirements Windows XP/2003 x32 Program files: C:\Program Files\Vaisala\Vaisala Veriteq viewLinc Data files: C:\Documents and Settings\All Users\Documents\Vaisala\Vaisala Veriteq viewLinc Note: It is strongly recommended to use the default installation folders for data files as other folders may have special security restrictions placed on them.
If you are connecting 300 Series Transmitter devices, they are connected either wirelessly or using a Digi device. Refer to your Vaisala product User Guide for more information. For further graphical representation of installing viewLinc, see the relevant Vaisala Quick Start Guides. There are versions for those using vNet or Digi devices and those using USB/Serial ports.
Page 19
User Guide. Installing Vaisala Veriteq Drivers This section covers installing the drivers for vNet devices to connect Vaisala Veriteq devices to the network using an Ethernet connection. Repeat all of these steps for each vNet device you want to use.
Page 21
Vaisala Veriteq devices to the network. Figure 2: Overview of viewLinc system using Digi devices Attaching Main Hardware Connect your Vaisala Veriteq device to a Digi device using a Vaisala Veriteq cable. Connect your Digi device to power supply and Ethernet outlet.
• set sample intervals • enable or disable channels • specify device and channel descriptions • store historical data for backup purposes It is recommended you install vLog on all PCs with Vaisala Veriteq devices connected to them. viewLinc 4.0 Administrator Guide...
Next Select from the Select Components Enterprise Server screen and click Next Enter the installation key purchased from Vaisala. Select Non-secure, Secure server (SSL) or Both. Review the install options and click Install. Click once the application is finished installing.
Logging in to viewLinc Choose a destination location for the viewLinc program files, then click Next Select , then click Logger Host Next Click Install Click Finish You have installed all necessary viewLinc components.You can now move to any machine on the network - or stay where you are - and log in to viewLinc to monitor channels using any supported Internet browser on the network.
If no Locations display, you may not have any locations assigned to you, the administrator may need to configure the system, or there could be a problem with viewLinc itself. If you use Vaisala Veriteq devices, try discovering devices - see “Discovering Devices” on page 40. Note:...
Page 29
Getting Help North America Contact Vaisala Canada Inc, 8am-4pm PST Monday - Friday, at 1-866-861-3388 (or 604-273-6850) or email veriteqsupport@vaisala.com. See also www.vaisala.com/ lifescience-hitech. For sales, pricing, quotations, or general information, please call 1-800-683-8374 (or 604-273-6850). Outside of North America: helpdesk@vaisala.com...
Chapter 2: Management This section describes how to: • Configure various components of viewLinc using the Managers from the system configuration menu • Create and work with views in Views Manager • Use access control to give views access to different users and groups •...
Page 33
About Views Manager possible to to add a zone by right clicking the zone and selecting Add Zone To specify access control for your view, click the view to select it then select from the access Options | control panel on the right. The access control window appears.
About Dashboard Manager If it is necessary to resize the image, select Options | . A grey border will appear around the Resize Image image allowing you to adjust the size in a window. Navigate the locations tree to find a location or zone you would like to add to your dashboard.
Devices, Hosts, and Locations. It also provides the device discovery functionality which allows for the automatic detection and configuration of supported Vaisala Devices. The Device Manager consists of 3 panels: • Device Browser displays the tree of hosts, devices, and channels •...
About Locations Manager About Locations Manager The Locations Manager is new to viewLinc 4.0 and is the central location for organizing locations into relevant zones for use throughout the application. The Locations Manager contains 3 panels: Locations, Device Browser, and Location Properties.
If no devices are displayed in the Add Location. device browser, your device may not be connected properly. • If you use Vaisala Veriteq devices, try discovering devices - see “Discovering Devices” on page 40. Organizing Locations into Zones To organize your viewLinc screen and keep a closer eye on the locations that matter to you, you can organize your locations into relevant zones using the Locations Manager.
Organizing Locations into Zones Creating Zones To create a new zone: Select Options | System Configuration | Locations . Navigate the locations tree on the left or simply Manager right click on the System folder and select Add Zone A ‘New Zone’ folder will appear. Enter a name for the zone and press [Enter] To Add a location to a zone:...
Organizing Locations into Zones Right click the zone and select Rename In the Zone name dialog box, make your changes. Press Enter or click outside the dialog box to complete the name change. Note: Renaming zones edits the zone name only; it does not change the locations assigned within it.
Location, the channel must be set up by your viewLinc administrator. Refer to the spe- cific User Guide to learn more about enabling and disabling device channels on your Vaisala Veriteq device or 300 Series Transmitter. Note: Channels cannot be dropped on a location that is already linked to another channel.
Page 43
Organizing Locations into Zones filter to ensure all devices and channels are visible. If you still don’t see any devices, contact your system administrator. Drag the channel (represented by the icon) Channel from the Device Browser and drop it into a Location that is not already linked to a channel in the Locations tree.
Organizing Locations into Zones zone and can be re-assigned to a different zone from the device browser. To move channels between zones, see “Creating Zones” on page 29. To deactivate child locations: From the Locations tree in Locations Manager, expand the zone you want to delete.
Organizing Locations into Zones example, to show a column with colored icons representing alarm status, select Icon Click outside the list, or press to hide the options [Esc] list. Creating and Editing Location Thresholds Thresholds (less than or greater than values for associated measurements) can be assigned to selected locations from the thresholds tab in locations manager.
Chapter 3: System Settings There are several important settings screens in viewLinc, all located under the System Configuration tab. This section covers administrative tasks such as: • Discovering devices • Adding devices and hosts • Auto-swapping devices • Removing devices •...
Chapter 3: System Settings Discovering Devices To discover recently attached Vaisala Veriteq devices which may not show up in the Device Browser automatically: Note: 300 Series Transmitters are not recognized by viewLinc using the Discover devices procedure; use your Digi Discovery software if required.
Page 51
In the Add Device screen, select Veriteq Logger from the Device Class dropdown list. Enter the COM port number. To add a combination of Vaisala Veriteq devices and 300 Series Transmitter devices, select Upload Definitions File then enter or browse to the correct file. To add several Vaisala Veriteq Devices, see “Discovering Devices”...
Contact your network administra- tor if required. To add several 300 Series Transmitters or a combination of Vaisala Veriteq devices and 300 Series Transmitter devices, select Upload Definitions File then enter or browse to the correct file. To create a Definitions File, see the FAQ on page 139.
Page 53
Devices have the same channels enabled Channels. and be using the same units of measure for each matching channel. • Vaisala Veriteq devices are not linked to a Audit Trail. vLog Audit Trail. From , navigate the system tree to Options | Locations find the device you want to swap.
You can now remove the device from the network. Editing Device Properties and Aliases viewLinc allows you to edit a Vaisala Veriteq device description (maximum 16 alpha-numeric characters stored within the device), as well as its alias (maximum 64 alpha- numeric characters, not stored within the device).
In the Edit Device Properties screen, in the Description text box, enter the new information (maximum 16 characters for Vaisala Veriteq devices only). In the Alias text box, enter a more descriptive Alias (maximum 64 characters), if you want. This Alias is used if you specify...
Page 57
Editing Channel Properties and Aliases To edit channel properties: From Options | System Configuration | Device Manager select the Host and then the device whose channel’s properties you want to edit. Select the channel you want to edit. On the menu select Options | Channel Edit Channel...
Configuring Email Settings process is complete. Click when prompted to refresh. Configuring Email Settings Alarm notifications are sent via email, therefore administrators must set Email Settings to properly send email messages from your mail server. If you aren’t sure which usernames and passwords to use or which check boxes to enable, contact your IT Administrator.
Page 61
Editing Alarm Email Templates sending emails to a pager or cellular phone, or for a specific purpose within your company. You can edit email templates to include or not include many different items, for example: • Device description • Event Type •...
About Contact Schedules About Contact Schedules viewLinc allows you to set times when a particular user receives alarm notifications. Users can be set to receive notifications “always”, “never”, or on a schedule of times and rotating dates (for example 07:00-19:00 on a 4 day on, 5 day off rotation, or 08:30-17:30 on a 5 day on, 2 day off rotation).
It sets the amount of information to be logged in case of any support issues. • The security key is displayed here. This is the license key purchased from Vaisala for this system. viewLinc 4.0 Administrator Guide...
Chapter 3: System Settings Choosing Device and Channel Description Lengths (Aliases) Vaisala Veriteq devices have descriptions stored inside them that have a maximum length of 16 characters (300 Series Transmitters do not store descriptions). Channel descriptions have a maximum length of 12 characters. Some administrators may prefer to display a longer, more informative description.
About Preferences To choose temperature measurement units: In viewLinc, go to Options | System Configuration | Preferences In the Name column, select Preferred Temperature Units and in the Value column, choose either (C) or Celsius (F). Fahrenheit Note: This procedure does not alter how the device measures temperature - it alters the units in which temperature is displayed (except for chan- nels which already have preferred unit settings...
Page 69
Creating Preconfigured Comments for Email Messages To use preconfigured comments (in a custom Communication Alarm, for example): From Options | System Configuration | Templates | Alarm , highlight a template, then click the Comments Templates tab. On the Comments tab, select a comment from the drop-down list.
Chapter 4: Locations This section is for administrators and general users. In this section, you’ll learn about: • Locations, Trends, and Zones • Selecting Channels and Zones to display as Locations • Opening Large Popup Trend Views • Viewing and Working with Real-time Graphs in a Large Popup Trend View •...
Location tree, allowing any channel to become a Location. Depending on the type of Vaisala devices you have installed, a device may have up to five active channels and up to 27 definable channels available to measure readings such as temperature, relative humidity, voltage, pressure, current, etc.
About Locations Understanding the Locations Screen The Locations screen in viewLinc contains many important features: Item Details 1 - Tabs Contains main viewLinc tabs: Table View, Dash- board, Location Alarms, Trend. 2 - Options Contain buttons like Refresh, Popup Trend, Pause dropdown Alarming, etc.
About Locations Column Displays Device Serial Number The serial number associated with the device. Device Description The description that was entered for the device at the time of configuration. Channel ID The system defined number associated with the channel. Channel Number Number representing the channel for that device (each device has 1 or more chan- nels, and labels them 1, 2, and so on).
About Locations user can acknowledge threshold alarms if they have ‘Acknowledge Alarms’ permission on that location. The device alarms can be acknowledged if ‘Acknowledge Alarms’ is available on at least one location referencing that device. For further information on acknowledging alarms seeSee “Viewing Active Alarms”...
About Locations double forward and back arrows will adjust the start time by a greater distance. • Pressing the live button will fetch the most recent data using the ‘duration’ combo box value to adjust the start date of the graph. •...
About Locations Trend Tab Options • : Reloads data from server. Refresh • : Clears all channels from the trend. This option is Clear visible when building trends from the ‘System view’ tree. • : Displays a window to save the current Save as View…...
Real-Time Graphs Real-Time Graphs With viewLinc, you can view live data in graphical form at any time using the Trend tab in Locations. To view live data as a graph: From , click the tab. Options | Locations Trend Expand the Locations tree on the left to find a Location you wish to graph.
Real-Time Graphs Item Description Status bar Indicates channel monitoring status (OK or Alarm/Alarm condition type). Table 4: Large Popup Trend view elements Viewing Graph Detail in Large Popup Trend View With a Large Popup Trend View open, you can also zoom in on a specific time period.
Chapter 5: Alarms Alarms and Alarm Acknowledgement are the keys to success with the Vaisala Veriteq Continuous Monitoring system. In this chapter, you’ll learn to: • Understand Types of Alarms in viewLinc • Create Alarm Templates • Set threshold and Device Alarms •...
This alarm can also be triggered if a channel has been disabled in the device using vLog. To correct this issue, you can verify or modify the Vaisala Veriteq device settings using vLog. If the problem persists, contact your Vaisala technical support representative.
Page 91
Creating Alarm Templates To create an alarm template: From Options | System Configuration | Templates | , click the dropdown, then Alarm Templates Options select Add Alarm Template By default, the alarm template name is New Alarm Template. Click in the title to enter a more specific title. On the General Parameters tab, define the following: Choose the alarm color code - either blue, a Color Code.
Page 93
Creating Alarm Templates email address specified in Options | System Configura- are visible (see “Editing Users and Pass- tion | Users words” on page 54). Drag users to notify to the Selected Users column. Reorganize the list order if necessary using the arrow buttons. Click In the drop-down, choose an Repeat email notification...
Page 95
Creating Alarm Templates comment. How comments appear in an email is defined in the email template. Select the Comments tab. Select a preconfigured comment that is appropriate for the purpose of the notification or manually enter a new comment you want displayed in the notification. You can also list all locations and devices that are currently using the selected template by clicking Options...
Page 97
Threshold Alarms To set a threshold alarm: From Options | System Configuration | Locations Manager select the location or locations you want to set the threshold alarm for. Note: To select multiple locations at one time, hold down the [Ctrl] key while you select locations. To select a group of locations in a list, hold down the [Shift] key and select the first and last locations.
Threshold Alarms select the threshold to edit from the Thresholds tab in the Location Properties panel on the right. Select The Edit Threshold Options | Edit Threshold. screen displays. Edit threshold settings as desired. Click Save Disabling Threshold Alarms You can temporarily disable alarms without deleting all the setting information (for example, when you want to move a device from one location to another).
Page 101
Communication Alarms To set a Host Communication alarm, click Options | Host from the device browser panel and select Host Communication Alarm Settings To set a Device communication alarm, click Options | and select Device | Device Alarm Settings Device Communication Alarm Settings The Communications Alarm Settings screen appears.
Device Alarms On the Host or Device menu, select Communication The Communications Alarm Settings Alarm Settings. screen appears. Deselect the check box. Enable Alarm Click Save. Note: You can also pause alarms - for more informa- tion, see “Pausing Alarms” on page 97. Device Alarms Ensuring the continuous functionality of your device is required for accurate real-time monitoring.
Page 105
Acknowledging Alarms If an alarm is set to require alarm acknowledgement, alarms must be acknowledged. You must be logged in to viewLinc to acknowledge alarms. Acknowledgement information, such as the action taken and any comments, is tracked in the Event Log and Historical database.
Pausing Alarms Pausing Alarms You may want to pause alarms if you need to move devices, or if a certain known situation may result in conditions exceeding set thresholds. Pausing alarms is faster than disabling alarms for a temporary period. You can pause an alarm for up to 24 hours.
Chapter 6: Permissions This section includes: • Information about User Permissions, User Rights and Access control lists • How to create users, assign them to groups and zones, add permissions and control rights. viewLinc 4.0 Administrator Guide...
Creating New Groups, Users and ACL’s Creating New Groups, Users and ACL’s Creating a New Group Select Options | System Configuration | Groups. Select from the drop box in the Add Group Options Groups window. Complete the Group Name and Description fields with the appropriate information.
Page 113
Creating New Groups, Users and ACL’s Set the password manually by entering and confirming it, or click the Windows Authentication checkbox in order to make the user’s password the same as their windows password. Note: For this functionality to work, the login name field must match an existing windows login.
Page 115
Creating New Groups, Users and ACL’s nodes/locations unless otherwise specified by the user. The system will resolve any conflicting permissions by applying the highest permission and removing the lower ACL when changes are saved. viewLinc offers several access control privileges, as outlined in the following table: Security Level Privileges...
Page 117
Creating New Groups, Users and ACL’s Therefore it should remain unchecked if the user/group should not view the information in any of the subfolders. Access should instead be given to these subfolders on an individual basis. Click . The new permission should appear in the Save Access Control list and access to the Location will be limited accordingly.
Chapter 7: Events All events - such as alarms, transfers of data from the device, alarm acknowledgements, system configuration changes and general system notifications - are tracked in viewLinc’s Event Log under Options | Events The data tracked in Events is different from the data tracked in a device.
Adding Comments to Events with them. You can also filter by specific users, groups or locations by clicking accordingly then checking or unchecking the checkboxes for the desired users, groups or locations. Select to refresh the Options | Refresh list or click outside of the filters window and the list will refresh automatically.
Exporting Event Logs In a new browser window, a printer-friendly Event Log report opens. The Print dialog box displays automatically allowing you to set your print parameters and print the Event Log. Exporting Event Logs With viewLinc you can export event log data into a saved .tsv file for analysis at a later date.
Using viewLinc, you can create graphs and reports to analyze changes in data over time based on the historical data collected by Vaisala devices. In this section, you’ll learn what historical data is and how to: • Analyze historical data •...
Chapter 8: Reports About Reports Vaisala devices have the ability to store large amounts of data inside them. Data is logged in frequencies from once every 10 seconds to once every 24 hours. To set this frequency (known as the sample interval) for Vaisala Veriteq devices, refer to your vLog product guide.
Generating Historical Data Reports Generating Alarm History Reports To generate an Alarm history report: Select and left click to select the report Options | Reports you want to generate from the Report Definitions tree. The report parameters appear on the right side of your screen (users can only view report parameters for the reports they generate, or reports to which they have been granted owner access).
Generating Historical Data Reports from the options dropdown. The exclamation point icon indicates when you have made changes that need to be saved. Generating Location History Reports To generate a Location History report: Note: viewLinc does not provide a default Location History report.
Page 131
Generating Historical Data Reports Statistic Settings in the Statistic Settings tab), and/or Tabular Data. If you include the Interval Statistics graph, use the Statistics Settings tab to define how information will display on your report, and any statistical information you want to include: From Statistics Settings, select a statistics interval by checking the Include statistics at intervals checkbox if...
Creating New Reports Use the Page Layout tab to define the headers, footers, paper size and orientation: For Header or Footer options, choose to display on all pages, on the first page only, on the last page only, or on the first and last page. To define the content of your header or footer, enter text in the Left, Center or Right fields.
Chapter 9: Transfers This section describes how to: • Transfer historical data from Vaisala Veriteq devices • Create, edit, deactivate and temporarily disable scheduled data transfers viewLinc 4.0 Administrator Guide...
You can transfer Vaisala Veriteq device data according to a set schedule. Since transfers can be scheduled in advance, you don’t need to be there when the transfer takes place.
Page 137
About Transfers and Transfer Schedules From the Device drop-down, choose the device for which you want to set the transfer. In the “Email notifications to” dialog, enter the email zaddress to receive notification should the transfer fail. You can choose an email address, a list of email addresses separated by commas, or a distribution list created on your mail server by the IT administrator.
; the deactivated transfers appear in your list in grey Transfers text. Temporarily Disabling Transfer Schedules Disable a transfer schedule when you want to swap a Vaisala Veriteq device or no longer want to view a transfer schedule in your list of transfers. To temporarily disable scheduled transfers:...
Chapter 10: Mobile UI This section is for administrators and general users. In this section, you’ll learn about: • How to navigate viewLinc 4.0’s Mobile interface • The types of functions available in the Mobile application Let’s get started learning about the Mobile interface in viewLinc.
Page 143
About the Mobile UI Press Options | Popup Trend The Popup Trend window appears. This window is controlled using the same buttons and checkboxes as a traditional popup trend window. See “Opening Large Popup Trend Views” on page 71. Also see step 9 of “Building a Trend with the Trend Tab”...
Page 145
About the Mobile UI Press Pause X Alarming or Resume X Alarming (where X is the type of alarm you’d like to control.) The alarming will remain paused until you toggle it by following these steps again and selecting Resume X Alarming viewLinc 4.0 Administrator Guide...
Appendix: FAQs & Troubleshooting This section contains answers to frequently asked questions and information for troubleshooting common problems with viewLinc and vNet or Digi devices. It also contains some technical details for administrators and support staff. As an administrator, you may want to be aware of the viewLinc services running on your Windows PC.
Page 149
Q: My network uses a combination of Vaisala Veriteq devices and 300 Series Transmitters. How can I add them quickly? A: To add multiple transmitters or a combination of devices and transmitters at one time, create a .txt definitions file with one device or transmitter defined per line.
Page 150
(obtained from your IT department). IP addresses are assigned to vNet or Digi devices during driver configuration. Refer to the Vaisala Veriteq Quick Start Guide for vNet or Digi devices for installation instructions. For more about vNet, see www.vaisala.com/lifescience-hitech. For more about Digis, see www.digi.com.
Page 151
For more detail, in Device Manager, under Multiport serial adapters, right-click the device in question. Choose Properties, select the Advanced tab, and click on the properties button. On the left will be a list of the COM ports used for this device. To see which devices are being controlled by viewLinc, see the System tab.
Page 153
This port must be opened before the device can be used with Vaisala software. This port may be blocked by network devices (such as routers, firewalls or layer 3 switches) or PC software (such as the Microsoft Windows Fire- wall, 3rd party firewalls, or security software suites).
Page 154
<IP address of the device>. If there is communication between the device and the network, check that the Vaisala-supplied cable connecting the device to the device is connected properly. If the light on the cable is solid red, there is a problem with the network device or device cable.
Page 155
Q: I've made some changes in viewLinc, such as new thresholds and device descriptions, but they're not showing up. What's wrong? A: Location information is updated and refreshed depending on the refresh rate set in viewLinc. Click the Refresh button in viewLinc, or determine the refresh rate viewLinc is using and wait the allotted time.
Page 157
over Ethernet (PoE) (Optional) Digi Device 9-30VDC powered (AC adapter included). Requires transmitter configured with DB9 serial cable. Requires DB9-serial cable connection between Digi Device and Transmitter. Allows multiple PTU300, Multi-port Digi Device (Ethernet): HMT330, DMT340 or MMT330 devices to be connect to the viewLinc host server via standard TCP/IP Ethernet network.
Page 159
Device ACLs will be created for the Administrators group only For more help with any of these issues, contact Vaisala Canada at 1-866-861-3388 or vaisalasupport@veriteq.com. viewLinc 4.0 Administrator Guide...
Page 167
RealPort driver installation working with troubleshooting 140, 141 using color for alarms what’s new for reports windows services Vaisala Veriteq loggers xls files discovering See also System Requirements validation alarms zones 27–35 defined adding ACL to viewing creating...
Need help?
Do you have a question about the Veriteq viewLinc 4.0 and is the answer not in the manual?
Questions and answers