Sapience Buddy

Install Guide for Windows

Updated: November, 2017

Sapience Analytics 2010-17 www.sapience.net

Contents

Welcome to Sapience Buddy! ................................................................................................................... 3

Prerequisites ........................................................................................................................................... 3

Quick Start............................................................................................................................................... 3

Install Sapience Buddy ............................................................................................................................. 4

Installation using Sapience Updater ................................................................................................................ 4

Manual installation.......................................................................................................................................... 7

Sapience User Registration ..................................................................................................................... 13

FAQ ....................................................................................................................................................... 13

Unable to access Sapience web login page ................................................................................................... 13

Auto registration of Sapience Buddy with Sapience server fails.................................................................... 14

How to resolve the “Invalid user ID” error ..................................................................................................... 14

How to install Microsoft .Net framework 4.5.2 ............................................................................................. 14

Confidential © Sapience Analytics 2010-17 www.sapience.net Page 2 of 15

Welcome to Sapience Buddy!
This guide helps you install Sapience Buddy app on your system. Download the package from the location
shared by the Sapience Support team.

Prerequisites
Before you begin with the installation, ensure that your system meets the following minimum requirements:

Hardware

Supported OS Windows 7, Windows 8, Windows 8.1 and Windows 10 (32 or 64 Bit)

RAM Minimum 4 GB (recommended 8 GB for heavy applications like CAD / CAM,
or 3d Applications)
Platform Microsoft .Net Frame 4.5.2 with user permissions to:
C:\temp and C:\windows\temp
C:\ProgramData\Microsoft\Crypto
Network

User desktop Port 443 open; for the user to browse

Sapience server Port 443 open; to receive user requests
Connectivity Access to the Sapience Web Client from user desktop using a browser
Software

Microsoft .Net framework 4.5.2 and above

Quick Start
Admin and expert users can directly refer the following instructions to install Sapience Buddy on your
system.
1. Install Sapience Updater.
Run the SapienceUpdater.msi.

2. Install Sapience Buddy.

Run the Setup.exe.

3. Open Sapience Buddy and start using the application.

Click the Sapience Buddy icon on your desktop.

For detailed installation instructions, refer the rest of this guide.

Confidential © Sapience Analytics 2010-17 www.sapience.net Page 3 of 15

Install Sapience Buddy
Based on the type of system environment, choose the appropriate app installation process:
 Laptop or user desktop: Sapience Updater

 Citrix server / RDS server / VDI master images / Systems that are unable to use the PUSH
mechanism: manual installation

Installation using Sapience Updater

Sapience Updater is a micro-installer that pulls the data from a Sapience-specified location and starts
Sapience Buddy installation as a background process. A system admin can push the SapienceUpdater.msi
using their push mechanism and skip the following installation procedure.
To install Sapience Buddy app using Sapience Updater:
1. Run the SapienceUpdater.msi. As this installation requires admin privileges, right-click the .msi, and
then click Run as administrator.

2. In the Welcome wizard window, click Next.

3. In the Select Installation Folder window, click Next.

Confidential © Sapience Analytics 2010-17 www.sapience.net Page 4 of 15

4. In the Confirm Installation window, click Next.

5. The Installing Sapience Updater window displays the installation progress.

Confidential © Sapience Analytics 2010-17 www.sapience.net Page 5 of 15

6. In the Sapience Updater information window, click Next.

7. In the Installation Complete window, click Close.

8. After Sapience Updater is installed, confirm that the Sapience Updater service is running on the system.

Confidential © Sapience Analytics 2010-17 www.sapience.net Page 6 of 15

9. The Sapience Updater downloads Sapience Buddy app automatically and starts the installation as a back
ground process. On completion of this installation, the Sapience Buddy icon is added to Desktop.

Manual installation
1. Install the Sapience Updater.

2. Run the Setup.exe. As this installation requires admin privileges, right-click the .exe, and then click
Run as administrator.

3. In the User Account Control message, click Yes.

4. Sapience setup verifies the pre-required components and prompts to install the missing
components. To install the missing components:

Confidential © Sapience Analytics 2010-17 www.sapience.net Page 7 of 15

 a. Read the license agreement, and then click Accept.

b. Review the list of components that will be installed on the system, and then click Install.

Confidential © Sapience Analytics 2010-17 www.sapience.net Page 8 of 15

 c. Select I have read and accept the license terms, and then click Install.

d. The Installation Progress window displays the installation progress.

e. In the Installation Is Complete window, click Finish.

Confidential © Sapience Analytics 2010-17 www.sapience.net Page 9 of 15

 f. Accept the Agreement, and then click Install.

g. In the Installation Is Complete window, click Finish.

5. After the missing components are installed, the wizard installs Microsoft Visual Studio 2010 Office
RunTime application.

Confidential © Sapience Analytics 2010-17 www.sapience.net Page 10 of 15

 6. In the Sapience Buddy Setup wizard window, click Next.

7. In the Select Installation Folder window, click Next.

8. In the Confirm Installation window, click Next.

Confidential © Sapience Analytics 2010-17 www.sapience.net Page 11 of 15

 9. In the Sapience Server and Proxy Information window, the preconfigured server name is
automatically shown. If this field is blank, type the Server Name as
HTTPS:<SapienceServerName>:443. Click Next.

10. In the Installation Complete window, click Close.

Confidential © Sapience Analytics 2010-17 www.sapience.net Page 12 of 15

Sapience User Registration
After installing the Sapience Buddy app for the first time, Sapience Buddy automatically establishes
connection with the Sapience Server and auto registers itself. If the auto registration fails, check this FAQ. If
you get an “Invalid user ID” error, check this FAQ.
On successful registration, Sapience Buddy user interface opens.

To view the Sapience Buddy usage, click .

FAQ
Unable to access Sapience web login page
 Port issue

Ensure port 443 is open on User desktop and sapience server

 Server side issue

Sapience server is rejecting the connection or blocking the inbound request. Request the IT team to
check proxy, Firewall, or sub-netting details.

 VLAN issue

From user VLAN is unable to access Sapience server due to blockage at firewall or proxy settings.
Request the IT team to unblock the firewall and allow access to server IP address.

Confidential © Sapience Analytics 2010-17 www.sapience.net Page 13 of 15

Auto registration of Sapience Buddy with Sapience server fails
1. If the auto registration fails, double-click Sapience Buddy icon on the Desktop.

2. In the Register this machine with your Sapience Account window, type the Sapience user
credentials, and then click Register.

How to resolve the “Invalid user ID” error

Registration process identifies the user for which the information sourced by the client is accounted. The
user credentials entered have to be for a valid Sapience user. If you get an “Invalid user id” error, then it
could mean either of the following:
 Incorrect e-mail id and password has been given. Please re-enter with the correct e-mail id
and password.

 The user does not exist as a valid Sapience user. Please add this user as a Sapience User (via
Sapience Web Client’s Add users facility in Administration), and then continue with the
registration.

How to install Microsoft .Net framework 4.5.2

1. Run the Setup for Microsoft .Net Framework 4.5.2. As this installation requires admin privileges,
right-click the .exe, and then click Run as administrator.

Confidential © Sapience Analytics 2010-17 www.sapience.net Page 14 of 15

 2. Extracting files windows will apprears.

3. Accept the Terms and Condition, and then click Install.

4. To close the application that are running during the .Net 4.5.2 installation, click Yes.

5. The .Net Framework installation progress is displayed.

6. In the Installation is complete window, click Exit.

7. Restart the system.

Confidential © Sapience Analytics 2010-17 www.sapience.net Page 15 of 15