Professional Documents
Culture Documents
Vico Office R6.5 Installation Guide
Vico Office R6.5 Installation Guide
Vico Office R6.5 Installation Guide
June 2017
Vico Office Installation Guide Page 2
Installation Checklist
Use the installation checklist to ensure that you have installed Vico Office successfully and have set it
up for optimal use. To view this document, Microsoft Excel must be installed on your machine.
The Vico Office system consists of components that can be installed in various configurations.
The Vico Office Client is the main program in Vico’s integrated solution for construction planning, con-
trolling and constructability analysis and is needed for all users who will interact with project data.
The VOC provides a basic set of functions needed for creating, viewing and reporting of projects. Vico
Office modules are task-specific programs that run in the VOC. A module is activated when a license for
it is available on the user’s system or via a license server.
The Vico Project Server manages the access and storage of project data. The VPS creates new data-
bases for each new project and maintains the master list of projects that is visible in the Vico Office
application. A VPS can be installed together with the VOC or separately on a remote server.
Note: To use Vico Office, a VPS must be installed somewhere (locally or on the network).
Vico licenses can be installed locally (single user licenses) or remotely (floating licenses). Floating
licenses must be installed on a host with a VLM. The VLM cannot be installed on a host where the VOC
has been installed. For more information, see 24.
Single user licenses are installed locally on a host where the VOC has been installed.
Vico Office Installation Guide Page 4
Floating licenses are installed on the host where the VLM has been installed. The VOC systems pull
licenses from the pool of installed licenses on the VLM.
Licenses installed on a license server can be managed using the License Server Administration utility,
which is accessed as a webpage (Start menu > Vico Software > Vico License Manager > Server
Administration).
Vico Office Installation Guide Page 5
System Requirements
These are the current system requirements for Vico Office, along with our recommendations for the con-
figuration.
Recommended Minimum
Minimum Requirements
Configuration
Note: There is a noticeable difference in performance between the minimum requirements and the recom-
mended minimum configuration.
General Requirements
The Vico Office Client (VOC) can interact with a remote Vico Project Server (VPS) over a local network
connection (not a WAN). For optimal performance of the system, the network connection should have
the following characteristics.
Vico Office Installation Guide Page 6
Item Requirements
These are the requirements for the correct installation of the VOC.
Vico Office Installation Guide Page 7
Item Requirements
l Windows 10
l Windows 8/8.1
Supported operating
l Windows 7
systems
l Windows Server 2008 R2
l Minimum: 4 GB
Memory
l Recommended: 16 GB or more
Item Requirements
l Windows 7
l Windows 8/8.1
Supported operating
l Windows 10
systems
l Windows Server 2008 R2
Item Requirements
l Shared database: 40 MB
l C:\VERSANT\8\bin\versantd.exe
l C:\VERSANT\8\bin\obe.exe
Firewall exceptions l C:\Program Files\Vico
(Inbound and outbound Software\Vico Project Server
rules) Admin\VPSDaemon.exe
Note:
l For good performance, a high bandwidth and low latency connection between the VOC and VPS is
required.
l If the VOCs are having trouble connecting to the VPS, you may need to change the firewall set-
tings.
Item Requirements
l Microsoft Windows® 10
l Microsoft Windows® 8
Supported operating
l Microsoft Windows® 7
systems
l Windows Server 2008 R2
Disk space l 2 MB
Memory l 3 MB
Vico Office Installation Guide Page 10
Item Requirements
2. In the second line of the file, add vico.opt XXXX, where XXXX
is the desired port number.
Item Requirements
l Port 9000
If needed, you can change this port to a custom port number
in the XYNTService.ini file.
The server webpage admin should now refer to the same port
number.
Note:
l Licenses are stored in this location: C:\ProgramData\Vico Software\VicoLM
l Single user licenses and floating licenses cannot be installed on the same system.
Vico Office Installation Guide Page 12
Vico Office is an award-winning suite of products designed specifically for general contractors and own-
ers. Vico Office is the first integrated construction management solution with a unique BIM-neutral envir-
onment. This means that users can publish, combine, coordinate, and augment Revit, Tekla, ArchiCAD,
CAD-Duct models, and even IFC files with 4D scheduling and 5D estimating data.
l Autodesk Revit 2016, 2017 and 2018 (Architecture, MEP and Structure)
** Bentley is not supported in Vico R6.1 or later. To use Bentley, you must use Vico R6 or earlier.
Now you can start "asking questions of the 5D model." What happens if we change the facade to glass?
What happens to the schedule if we add a parking garage? What happens if we substitute this material
for that material? In real-time, the model provides the answers of what happens to the schedule and what
happens to the budget.
Vico Office Installation Guide Page 14
System Configuration
Firewall Settings
The Vico Office Client (VOC) communicates with the Vico Project Server (VPS) via the TCP/IP pro-
tocol. This communication takes place through dedicated ports, which should be open on both the VOC
system and the VPS system.
The Vico Office installer attempts to make required changes in the Windows firewall. Any additionally
installed firewall software should be configured manually.
The Vico License Manager (VLM) and the Vico Crash Reporter also require specific ports to be open. In
addition to the systems on which the software is running, the VLM and Crash Reporter may require ports
to be open on installed firewalls on routers and modems. This allows them to communicate respectively
with the Vico Software license administration system and the Vico Crash Report server.
The table below provides an overview of all open port requirements and program exceptions.
Note:
l For the 5019, 5088, and 6000-6200 ports/port range, we recommend setting the exception for the
related .exe process.
l The path (for example, C:\VERSANT\8\bin) changes as the Versant version (for example, 8)
changes. This applies to all programs that use the VERSANT path.
(Crash
Report
Uploader)
Windows UAC can block the VPS to VOC communication in the specific case where:
l UAC is active.
—And—
1. Right-click the Vico Office program shortcut, and then click Properties.
2. On the Compatibility tab, select the Run this program as an administrator check box, and then
click OK.
Configuration Options
The Vico Office Client (VOC), Vico Project Server (VPS), and Vico License Manager (VLM) can be
installed in various configurations.
Vico Office Installation Guide Page 17
Standalone Configuration
A standalone configuration is recommended for demonstration and offline work only. Although this con-
figuration can provide maximum performance, collaboration is a manual process.
In this configuration, Vico Office and Vico Project Server (VPS) are installed on the same system, which
means that the same computer is both server and client. Project databases, the master database, and
the shared database are available without connecting to a server.
Vico Office Installation Guide Page 19
Both Vico Office and VPS are installed on the same machine.
Note: The communication between Vico Office and VPS takes place via TCP/IP. Server and client both
have the same TCP/IP address – this is considered a threat by most antivirus and firewall software. If it
is not possible to make adjustments to firewall and/or antivirus software, we do not recommend a stan-
dalone configuration.
A LAN configuration is recommended for most use cases. In this configuration, a dedicated system is
set up as the Vico Project Server (VPS), and work stations with the Vico Office Client (VOC) installed
connect to the VPS over a local area network. Multiple users can access the same project at the same
time, which enables work-as-one: parallel work on a project as a team.
Users pull licenses for the various modules from a pool of licenses installed on the server.
Note: Because of hardware limitations of the server (related to memory usage), a large number of users
might require additional VPSs to be set up.
A WAN configuration, which only applies to the VLM, provides on-site project teams access to a VLM
license server that is set up in the office. The license server must be accessible from outside the office,
and this can be achieved by placing the license server computer inside a DMZ. Floating licenses are typ-
ically required.
Vico Office Installation Guide Page 22
Setting up a license server in the DMZ can provide access to floating licenses from outside the office.
Note: Other than for licensing, WAN solutions for Vico Office require virtual desktop/application solu-
tions. Our customers have successfully used Citrix, and supplemental documentation is available. For
more information, contact the Vico Office Support team.
Vico Office Installation Guide Page 23
The Vico Office installer guides you through the steps for installing Vico Office components.
l The installer checks to ensure that your machine has the required system components. If any
are missing, it will list them so that when you click Next, they are downloaded and installed.
Note that you need Internet access to download these prerequisites.
If your machine does not have Internet access, you can use another machine with Internet
access to download the prerequisites from the Downloads page of SupportLink. Unzip the
downloaded file and place the prerequisites next to the Vico Office setup file. The installer
will automatically pick up these prerequisites and install them during the Vico Office install-
ation.
l If the required system components are up-to-date, the disk space requirements are dis-
played.
3. Click Next.
The license agreement appears.
4. Read the license agreement, select the I accept the terms of the License Agreement check
box, and then click Next.
Vico Office Installation Guide Page 24
Note: The Next button is enabled only after you have scrolled to the bottom of the agreement.
6. Click Next.
Note that Vico License Manager cannot be installed at the same time as Vico Office.
8. Click Next.
9. Read the Trimble Solution Improvement invitation. You are encouraged to participate in the pro-
gram.
When you select 'Yes', a crash report is automatically sent to Trimble. Only necessary inform-
ation required by developers to help them understand why a crash occurred is included in the
report.
When you select 'No', a crash report is NOT automatically sent to Trimble. However, you can still
send this report manually. A prompt will be available on the UI after the crash has occurred.
Important: If you are installing Vico Office in a Citrix environment, the option to send crash
reports is not available. To enable this feature, see "Sending Crash Reports in a Citrix Envir-
onment" on page 30.
Please remove it or set it to <empty>. Otherwise, this setting might prevent crash reports from
being sent to Trimble.
Licensing Process
The licensing process for Vico software consists of the following steps:
Vico Office Installation Guide Page 25
The VOC or VLM installation must be completed before continuing with license installation.
The resulting license file (.lic) is stored in the following location: C:\ProgramData\Vico Software\VicoLM
If a Vico License Distribution Server connection fails, the License Installation Utility displays a message
and automatically generates a license request file for 'offline' license installation.
1. In the Vico Software License Request Problem message, click OK to save the license request
file.
2. Attach the license request file to an empty email, and send it to licensing@vicosoftware.com.
Important: The request file should be the only attachment to an otherwise empty email. If the
email is edited or additional attachments are added, the automatic process will fail.
Vico Office Installation Guide Page 26
After the request file is received, an email with the license file is automatically sent by the Vico
License Distribution Service.
Hardware ID (HWID)
Vico licenses are hardware-dependent, which means that a unique HWID is generated and copied to the
license file during installation. This ID is compared to the one that is generated when a Vico product is
started. If they match, the license can be checked out.
Note: Changes to the hardware or operating system may result in a new HWID, which invalidates exist-
ing licenses. HWID generation is affected by the following:
l UAC settings
2. Open the Vico Office setup file, and select Vico License Manager (VLM) to install the VLM on
that machine (server).
3. To install the floating licenses on the server computer, open the .liu license installation files and wait
for 15 to 20 seconds.
Example license names are:
l VO R5 Takeoff Manager
l VO R5 Cost Planner
l VO R5 Cost Explorer
Note: The .liu files should be associated with the Vico License Installation Utility (LIU). If the file
association is missing, download and install the License Installation Utility separately.
4. To start the Server Administration page on the license server, click the Start menu > Vico Soft-
ware > Vico License Manager > Server Administration .
2. To install the VOC license on the client computer(s), execute the license installation file (.liu file
attached to license notification), and wait for 15 to 20 seconds.
3. On the Dashboard in Vico Office, set the connection to the VLM in the VLM Server field, and
restart Vico Office.
When you start Vico Office, it will check out the Vico Office Client license locally and should be able to
check out the module licenses from the server.
2. On each user's computer, download and install the Vico Office Utility, which is available on the
Downloads page of SupportLink.
3. On the License server access step, enter the name or IP address of the server computer during
installation. The VLM connection information is stored in an Environment Variable that you can also
Vico Office Installation Guide Page 29
create manually.
If there is a need to revert back to a previous Vico Office release on your machine, some files have to be
removed manually, as the Vico Office database files are not backward compatible. Please follow these
steps to avoid any database conflict.
2. Uninstall Vico Office and all related components (Vico Project Server, Schedule Planner Standard).
l C:\osc
Note: This folder is hidden by default. To display hidden folders, select this option 'Show hidden
files, folders, or drives' (File Explorer > Organize > Folder Options > View).
l C:\Users\<CURRENT_USER>\osc
Note: Your user profile folder might be set to a different (network) drive. If you type
%HOMEDRIVE%%HOMEPATH% in File Explorer, it will point you to the user profile folder.
During the Vico Office installation, you are invited to participate in the Trimble Solution improvement pro-
gram. This program is available only to the system administrator who installed Vico Office. Due to the
nature of a Citrix environment, this program is not automatically available to the rest of the Citrix users.
There are two ways to participate in the program: one will require Citrix users participation and the other
will require the Citrix Administrator to modify the registry settings.
Please remove it or set it to <empty>. Otherwise, this setting might prevent crash reports from being
sent to Trimble.
Citrix Users
1. When a crash occurs while using Vico Office, a warning icon will appear on the top-right corner of
the window.
Citrix Administrators
1. Start Registry Editor and locate the following:
Computer\HKEY_CURRENT_USER\Software\Vico Software\Vico Office
Troubleshooting
Vico Office Antivirus or firewall Set exceptions for the following files: itest –v
cannot blocks the <SERVER_
n C:\VERSANT\8\bin\versantd.exe
connect to connection. NAME>
(TCP/IP port 5019)
local or
n C:\VERSANT\8\bin\obe.exe (TCP/IP (DOS command
network VPS
port range 6000-6200) line function)
Note: Multiple
(Versant
firewalls/antivirus n C:\VERSANT\8\NotificationDaemon.exe
database).
can be present on a (TCP/IP port 5088) Check the
machine Reinstall VPS/start ‘versantd’ service Control Panel -
>
Administrative
Versant database is
tools ->
not installed
Services ->
properly/’versantd’
VersantD
service is not
running
Vico Office Installation Guide Page 32
Vico Office TCP/IP networking is Set up TCP/IP networking (ask your ipconfig
crashes not set up properly administrator)
during startup (DNS name
(DOS command
resolution).
line function)
TCP is broken or
there is no network
adapter in the
machine
Vico Office User must have Set proper rights on the Versant DB Run the
drops E7031 permissions to write directory in Windows Explorer following
error during Versant DB directory (C:\Versant\db) commands in
startup (usually Command
c:\Versant\db) Prompt:
makedb testdb
createdb
testdb