30/10/2023, 20:10 Installing the ROSS 5D client app – Support Portal

My activities Gaurang Patel ▾

Search 🔍

SUPPORT PORTAL > ROSS 5D KNOWLEDGE BASE > ADMINISTRATORS ONLY

Follow

INSTALLING THE ROSS 5D CLIENT APP

RECENTLY VIEWED ARTICLES

ROSS 5D architecture
Installing the ROSS 5D database
System requirements
OVERVIEW
User administration
1. Understand the ROSS 5D architecture Setting up user roles
2. Check system requirements are met
3. Install ROSS 5D database
4. Open firewall ports and proxy server URLs
5. Install Microsoft .NET Framework 3.5 SP1
6. Install Microsoft .NET Framework 4.8
7. Install SAP Crystal Reports runtime engine for .NET Framework
8. Install Microsoft Visual C++ redistributables
9. Install ROSS 5D app

https://qubit.rlb.com/hc/en-us/articles/230582267-Installing-the-ROSS-5D-client-app 1/8
30/10/2023, 20:10 Installing the ROSS 5D client app – Support Portal

10. Configure ROSS 5D app

11. Install PDF and XLSX viewers RELATED ARTICLES
12. Test

System requirements
DETAILS
Release 8.3.6
1. UNDERSTAND THE ROSS 5D ARCHITECTURE

Review the architecture documentation. Decide whether you will use a thick client approach where
each client runs the app, or a thin client such as Citrix or Windows Remote Desktop Services where
the app runs centrally. If you are installing a stand-alone system such as a laptop without internet
connectivity, install the server components before installing the app.

2. CHECK SYSTEM REQUIREMENTS ARE MET

Ensure that the client meets the system requirements, in particular a 64-bit version of Windows, 3D
graphics capability and a wheel mouse.

3. INSTALL ROSS 5D DATABASE

The app can be installed but not tested until you have installed the ROSS 5D database on a server.

4. OPEN FIREWALL PORTS AND PROXY SERVER URLS

ROSS 5D communicates directly on ports 80, 443 and 24195 to system services and indirectly via a
web browser link to the ROSS 5D Support Portal and CCS Knowledge Hub. If you are using ROSS
Classic, port 31438 is also required. Verify that the following URLs are accessible from your clients.
Open firewall ports and add to proxy server white lists if necessary.

https://qubit.rlb.com/home - will display a login page. Used for support portal.

http://qubit.au.rlb.com:24195/QubitErrorReportingWebService/ErrorReportingWebService.
asmx - will display a web page listing options supported. Used for error reporting.
https://secure.softwarekey.com/solo/webservices/XmlActivationService.asmx - will display
a web page listing options supported. Used for licence management.
https://dc.services.visualstudio.com - will display a Page Not Found error. Used for
performance, reliability and usage measurement.

https://qubit.rlb.com/hc/en-us/articles/230582267-Installing-the-ROSS-5D-client-app 2/8
30/10/2023, 20:10 Installing the ROSS 5D client app – Support Portal

https://dc.applicationinsights.microsoft.com - will display a Page Not Found error. Used

for performance, reliability and usage measurement.
https://ccsknowledgehub.com - will display a login with email page. Used as optional
single-sign-on method to CCS Knowledge Hub.
https://api.ross5d.com/home - will display a welcome message. Used for retrieving
currency escalation, relativity, and currency exchange data for benchmarking.
https://api.rlbpulse.com/api/Health - will display a blank page. Used for publishing to
Global Benchmarking and Analytics. This URL is hosted at multiple static IP addresses:
104.42.0.29
23.96.88.225

The support portal and its videos will also need access to the following URLs to operate correctly:

assets.zendesk.com
guide.zdassets.com
zdassets.com
gravatar.com
screencast.com
techsmith.com
ajax.aspnetcdn.com

During installation the app .exe installer will download the required .NET Framework versions if they
are not installed. You will need internet access at this time or install the .NET Framework versions
manually.

5. INSTALL MICROSOFT .NET FRAMEWORK 3.5 SP1

Some components of ROSS 5D require the old Microsoft .NET Framework 3.5. Version 3.5 does not
come pre-installed on Windows 8.0 or Windows Server 2012. If you run these or later versions
of Windows:

For clients, download Microsoft .Net Framework 3.5 SP1 from

http://www.microsoft.com/en-au/download/details.aspx?id=25150 and install it.
For a server, use Server Manager to install the feature of .NET Framework 3.5.

6. INSTALL MICROSOFT .NET FRAMEWORK 4.8.1

https://qubit.rlb.com/hc/en-us/articles/230582267-Installing-the-ROSS-5D-client-app 3/8
30/10/2023, 20:10 Installing the ROSS 5D client app – Support Portal

ROSS 5D requires at least version 4.7.2 of the Microsoft .NET Framework runtime, but we
recommend upgrading to the latest version 4.8.1 for the longest future support period. Microsoft is
installing this on all PCs using Windows Update. If the client runs an earlier version of the .NET
Framework you can either:

Download the offline installer and install manually from https://dotnet.microsoft.com/en-

us/download/dotnet-framework/net481.
Use Windows Update for Business, Windows Server Update Services (WSUS) or
Microsoft Configuration Manager to upgrade all of your clients.
Run the ROSS 5D .exe installer which will download the .NET Framework. If you use the
.msi installer and the .NET Framework is still at version 4.7.1 or earlier the upgrade will not
proceed.

7. INSTALL SAP CRYSTAL REPORTS RUNTIME ENGINE FOR .NET FRAMEWORK

This file is required for some of the ROSS 5D reports.

Download and install CRRuntime_64bit_13_0_30.msi. Contact ROSS 5D Support for access to the
Microsoft Teams folder.

8. INSTALL MICROSOFT VISUAL C++ REDISTRIBUTABLES

These files are required by the Integrated DimensionX software.

Download and install:

Microsoft Visual C++ Redistributable for Visual Studio 2012 Update 4 (x64)
from https://www.microsoft.com/en-us/download/details.aspx?id=30679. Last tested
version 11.0.61030.
Microsoft Visual C++ 2015-2019 Redistributable (x64) from
https://visualstudio.microsoft.com/downloads/#microsoft-visual-c-redistributable-for-visual-
studio-2019. Last tested version 14.28.29913.0.

9. INSTALL ROSS 5D APP

Download and install ROSS5D_x64.msi.

https://qubit.rlb.com/hc/en-us/articles/230582267-Installing-the-ROSS-5D-client-app 4/8
30/10/2023, 20:10 Installing the ROSS 5D client app – Support Portal

The msi file is the fastest to download and install. As an alternative option there is also an exe file.
This is a larger download but automatically installs the correct versions of ROSS 5D, Crystal Reports
and the .NET Framework.

If you have a handful of clients you can install them manually. However if you have a larger number of
clients it will be easier to use Windows Group Policy. The screen shot below shows how the Crystal
Reports runtime and ROSS 5D app can be configured to be installed automatically when the client
logs on to the network (Note: this is an old image).

10. CONFIGURE ROSS 5D APP

When the app is first run, the user must enter the settings to find the ROSS 5D and ROSS Classic
servers. If the server cannot be found, check that:

The client is logged on to the domain.

The server name is visible to the client and configured in DNS, e.g. ping SERVERNAME
finds the server.
The TCP/IP protocol was enabled in SQL Server Configuration Manager on the server.
The DOMAIN\Users account is a member of BUILTIN\Users on the server.

If this was the first app in a new server installation you will need to activate your ROSS 5D licence. On
the message that there is no valid licence is an option to activate your licence. This opens a form for
entering your licence ID and password. You must also specify a shared folder location that is visible to
all clients and that they have read/write access to. If this folder is in a mapped network drive the
mapping must be specified identically, whether by login script, policy or manually. See the licence
activation guide for more information.

Also for the first time only, the IDX Licensing Server and ROSS Classic information needs to be
entered. On the File menu select Options. Go to the Administrator page and the General tab. Enter
the IDX licencing server's name. If you have ROSS Classic installed, enter the ROSS Classic server

https://qubit.rlb.com/hc/en-us/articles/230582267-Installing-the-ROSS-5D-client-app 5/8
30/10/2023, 20:10 Installing the ROSS 5D client app – Support Portal

name and account (usually ROSS). Also enter a username and password which are used to obtain
the descriptions of new projects from the ROSS Classic Office Administration module and check the
Connect box which enables this feature. Press Save and close the Options window.

11. INSTALL PDF AND XLSX VIEWERS

ROSS 5D exports reports in either PDF or Excel formats.

To export to PDF format you will require a PDF viewer to be set as the default program for .pdf files.
Download and install one of:

Adobe Acrobat Reader DC https://get.adobe.com/reader/. If when opening reports you

get the error "There was an error opening this document. Access denied.", open Acrobat
Reader DC and select menu Edit and Preferences. In the Security (Enhanced) category,
uncheck the box for Enable Protected Mode at startup.
Foxit PDF Reader https://www.foxitsoftware.com/downloads/#reader
Tracker Software PDF-XChange Viewer http://www.tracker-software.com/product/pdf-
xchange-viewer

To export to Excel format you will require Excel or an XLSX viewer to be set as the default program for
.xlsx files. Download and install one of:

Microsoft Excel or Microsoft Office https://products.office.com/en-au/business/office

Microsoft Excel Viewer https://www.microsoft.com/en-au/download/details.aspx?id=10.
This software is able to view files but is not able to save them so you cannot manipulate
the data or send the report to a client.
Apache OpenOffice http://www.openoffice.org/

12. TEST

Use this list as a check list to ensure that the server and client are configured correctly.

1. Run the ROSS 5D app. After showing the splash screen the main window should open
with the project search sidebar displayed. This tests that the ROSS 5D app and .NET
Framework 4.5.1 or higher are installed, the ROSS 5D licence has been activated,
connectivity is in place to the database server and the database is installed, that the
database security is set correctly and that the C++ Runtime files have been installed.
https://qubit.rlb.com/hc/en-us/articles/230582267-Installing-the-ROSS-5D-client-app 6/8
30/10/2023, 20:10 Installing the ROSS 5D client app – Support Portal

2. Maximise the ROSS 5D window. This checks that the scaling settings are correct on a
high DPI tablet.
3. In the File menu select Options and the Administrator page. In the Project tab add a
project called TEST. Press Save and close the Options window.
4. In the Search sidebar search for TEST so that it shows in the project list below. Right-click
TEST and select New Project Version and From UNIVERSAL-1. Press Reports in the
Home menu. In the Section drop-down select Parameter List and press Add. Press
Export to PDF. The element list should be displayed in your PDF viewer. This tests that
Crystal Reports and the .NET Framework 3.5 are installed and that your PDF viewer is
installed and is set as the default program for PDF files. Close the PDF viewer.
5. Press Export to Excel and Continuous spreadsheet. The list should open in Excel or your
XLSX viewer. This tests that Excel or your XLSX viewer is installed and is set as the
default program for XLSX files. Close Excel or the XLSX viewer.
6. Press the IDX button and Yes to upgrade the project version. The IDX window should
open. This tests that the C++ Runtime files have been installed and that your DimensionX
licences have been added to the Dimtronix Licensing Service.
7. In the File menu of the IDX window select Options. In the Display tab set the Graphics
Driver to Software if you have neither a graphics acceleration card nor integrated 3D
graphics, Direct3D 9.0c if this is a server where you connect via Remote Desktop or
OpenGL 2.0 otherwise. Press OK to close the Options window. Press Add Drawing and
select a PDF file. Press OK on the Drawing Properties window that appears. The PDF
should be displayed. This tests that your DimensionX graphics driver is set correctly.
8. Close the IDX window and press F1. The Support Portal should open. This tests that
your email address is set correctly in the mail attribute of your Exchange system and your
firewall and proxy settings allow access to the Support Portal.
9. Go to the tutorial videos and play a video. Confirm that you can hear the audio. This tests
your firewall, proxy settings and internet policy settings allow access to videos. Close your
internet browser.
10. Press Shift-F1. The CCS Knowledge Hub should open. This tests that your firewall and
proxy settings allow access to the CCS Knowledge Hub. Close your internet browser.
11. If you have ROSS Classic installed, right-click TEST in the search bar and select Import
ROSS Classic EB Job-Version. Enter the job-version code of a detailed estimate/bill and
enter your ROSS username and password. Click Copy Now. Your ROSS Classic project
version should be displayed. This tests that your ROSS Classic server name is set
correctly and that you have no connectivity issues to the ROSS Classic server.

https://qubit.rlb.com/hc/en-us/articles/230582267-Installing-the-ROSS-5D-client-app 7/8
30/10/2023, 20:10 Installing the ROSS 5D client app – Support Portal

Was this article helpful? 👍 👎 0 out of 0 found this helpful

0 Comments

Be the first to write a comment.

https://qubit.rlb.com/hc/en-us/articles/230582267-Installing-the-ROSS-5D-client-app 8/8