BUSINESS DEVELOPMENT SUITE MOBILE INSTALLATION GUIDE. Version 14R2

Size: px

Start display at page:

Download "BUSINESS DEVELOPMENT SUITE MOBILE INSTALLATION GUIDE. Version 14R2"

Adela Wood
6 years ago
Views:

1 BUSINESS DEVELOPMENT SUITE MOBILE INSTALLATION GUIDE Version 14R2

2 COPYRIGHT INFORMATION 2015 Thomson Reuters Elite. All rights reserved. Proprietary and confidential information of Thomson Reuters Elite. Disclosure, use or reproduction without the written authorization of Thomson Reuters Elite is prohibited. The Thomson Reuters Elite product names used throughout are registered trademarks and belong to Thomson Reuters Elite. All other trademarks and registered trademarks are the property of their respective owners. 2

3 TABLE OF CONTENTS ABOUT THIS DOCUMENT... 1 INSTALLATION PRE-REQUISITES... 2 Required Server Setup Options... 3 Application Server Software Requirements... 3 MOBILE ARCHITECTURE OVERVIEW... 5 INSTALLING BUSINESS DEVELOPMENT SUITE MOBILE... 6 Install the Thomson Reuters Elite Site... 6 Verify the Installation... 8 Install and Set Up the Elite Website Package... 9 Install the Root Website Install the Elite Integration Framework Install the Framework Package Verify Framework Request Service Install the Mobile Gateway Services Install the Mobile Gateway Pacakage Verify the Mobile Gateway Service Define your Law Firm for Elite Mobile Set Up Your Firm s Users ELITE MOBILE CONFIGURATION CHANGES Change the web config settings INSTALL ELITE MOBILE APP ON IPAD Open the App on Your ipad iii

4 ABOUT THIS DOCUMENT This guide is a straight-forward walkthrough to install all required components for BDS Mobile Gateway and the Server setup. The table below shows what changes have been made to this document, when they were made, and who made them. VERSION DATE UPDATED BY COMMENT /15/2015 Original Publication 1

5 INSTALLATION PRE-REQUISITES Note: Before you begin, verify that your firm has the correct licensing to install and use Business Development Suite Mobile. Your firm s contract with Thomson Reuters Elite is the authoritative document regarding site licensing. Recommended Configuration Physical Host Minimum Configuration Virtual / Physical Application Server Database Server x64 architecture or compatible dual-core 1.5 GHz processor 16 GB RAM 40 GB of available hard disk space x64 architecture or compatible dual-core 1.5 GHz processor 16 GB RAM 80 GB of available hard disk space Standalone Server (Application and Database) x64 architecture or compatible dual-core 1.5 GHz processor 16 GB RAM 80 GB of available hard disk space Installing Business Development Suite Mobile requires at minimum a virtual/physical host that meets these requirements: One standalone server that houses both the application and the database 64-bit architecture or compatible dual-core 1.5 GHz processor 16 GB RAM 80 GB available hard disk space The recommended configuration is a physical host composed of two servers: SERVER PURPOSE SERVER REQUIREMENTS Application 64-bit architecture or compatible dual-core 1.5 GHz processor 16 GB RAM 40 GB available hard disk space Database 64-bit architecture or compatible dual-core 1.5 GHz processor 16 GB RAM 80 GB available hard disk space 2

6 REQUIRED SERVER SETUP OPTIONS REQUIRED SERVER SETUP OPTIONS The platform is ideally installed upon a Windows Server with the Web Server Role (Internet Information Server (IIS) version 7.x - preferred 7.5). The items below are required options, which must be to be selected in addition to the default settings included in the installation of Windows Server 2008 R2 Web Edition. Ensure the Server Roles listed below are added to the Windows Server Installation. SETUP OPTION Server Roles Common HTTP Features Application Development REQUIRED SETTINGS Web Server (IIS) Minimum requirements in IIS: Static Content Default Document Directory Browse (this setting is optional) HTTP Errors HTTP Redirection ASP.NET (will auto-select required roles).net Extensibility ISAPI Extensions ISAPI Filters Security Basic Authentication Windows Authentication (if providing Windows Domain Login STS) Digest Authentication (if providing Windows Domain Login STS useful if installed inside your domain) Request Filtering Performance Static Content Compression Dynamic Content Compression (optional based on available CPU but utilization is highly recommended for remote connections) APPLICATION SERVER SOFTWARE REQUIREMENTS Install the following on your application server: Microsoft.NET Framework 4.5. Download this from: ASP.NET After downloading Microsoft.NET Framework, run the ASP.NET IIS registration tool: 1. Open the command prompt by running as administrator. 2. Navigate to the folder C:\Windows\Microsoft.NET\Framework64\v Run this command: aspnet_regiis.exe i. 3

7 APPLICATION SERVER SOFTWARE REQUIREMENTS If you are using SQL Server 2008 R2 SP1, you need to apply the following installs on the application server: o SQL 2012 System CLR Types Navigate to the tools prerequisites folder and run SQLSysClrTypes.msi. o SQL 2012 Report Viewer Navigate to the tools prerequisites folder and run ReportViewer.msi. Note: You do NOT need to install these SQL Server prerequisites if you are running SQL Server 2012 or higher. Business Development Suite 14R2 or higher. 4

8 MOBILE ARCHITECTURE OVERVIEW Below is a graphical overview of the Business Development Suite Mobile architecture. See the Business Development Suite Product System Requirements, version 14R2, for suggested mobile server layouts in relation to its placement inside or outside the firm s firewall. 5

INSTALLING BUSINESS DEVELOPMENT SUITE MOBILE INSTALL

Reuters Elite site, follow the steps below. 1.

$C:\BDSMobileInstaller.$

9 INSTALLING BUSINESS DEVELOPMENT SUITE MOBILE INSTALL THE THOMSON REUTERS ELITE SITE To install the Thomson Reuters Elite site, follow the steps below. 1. Copy setup.exe in the ISO image into a local folder, such as C:\BDSMobileInstaller. Your folder should look like this: 2. Run setup.exe. Click Yes on the confirmation pop-up[mg1]. 6

10 INSTALL THE THOMSON REUTERS ELITE SITE 3. Follow the instructions on the Configuration ToolInstaller wizard. There should be no text prompts, etc. 4. After setup.exe finishes, the InstallShield Wizard Completed message is displayed: 5. Click Finish. 7

$INSTALL THE THOMSON REUTERS ELITE SITE Navigate to C:\Program Files\Elite to$ VERIFY THE INSTALLATION After the installation is finished, use the shortcut

VERIFY THE INSTALLATION After the installation is finished, use the shortcut

11 INSTALL THE THOMSON REUTERS ELITE SITE Navigate to C:\Program Files\Elite to view your folder structure, which should look similar to the one shown below. VERIFY THE INSTALLATION After the installation is finished, use the shortcut icon on the desktop to open the Elite Configuration Tool. Here is the initial view: 8

INSTALL AND SET UP THE ELITE WEBSITE PACKAGE Click File to view the About Thomson Reuters Elite Configuration Tool page. You can also exit the application from this page.

12 INSTALL AND SET UP THE ELITE WEBSITE PACKAGE Click File to view the About Thomson Reuters Elite Configuration Tool page. You can also exit the application from this page. INSTALL AND SET UP THE ELITE WEBSITE PACKAGE After you open the application for the first time, click the Install tab to view the available package categories. The available categories are: Website Packages within this section will install a full website into IIS. Web Application These packages install a web app into a pre-installed website. Standalone These packages have no web dependencies and can be installed on their own. 9

13 INSTALL AND SET UP THE ELITE WEBSITE PACKAGE INSTALL THE ROOT WEBSITE To install a web application, a root website must be available. 1. Click Website on the Install tab to display the packages in that category. 2. Click the EliteWebSite package to see the available package versions. 3. Click the 1.0 package, then click Install. 4. On the Browse For Folder pop-up, click Make New Folder and: a. Create a C:\Elite folder b. Create a subfolder of C:Elite called C:\Elite\EliteWebSite. c. Click C:\Elite\EliteWebSite, then click OK. 10

14 INSTALL AND SET UP THE ELITE WEBSITE PACKAGE 5. Complete the initial page of the wizard by providing the website address, name, and the login details for the App Pool as shown below. 6. Click Next to create or select your SSL certificate. 11

Click Choose SSL Certificate to view available certificates[mg2]. 8.

15 INSTALL AND SET UP THE ELITE WEBSITE PACKAGE If you do not have a certificate available, see the Create a Self-Signed Certificate section below to create a certificate, then return to this point in the procedure. 7. Click Choose SSL Certificate to view available certificates[mg2]. 8. Select a certificate or accept the certificate shown by clicking OK. The certificate details are displayed. 9. Click Finish to complete the installation and configuration of the EliteWebSite package. 12

16 INSTALL AND SET UP THE ELITE WEBSITE PACKAGE After the package installation is finished, a Success message is displayed and details are shown in the output box at the bottom of the window. Browse to to display the website. 13

17 INSTALL AND SET UP THE ELITE WEBSITE PACKAGE CREATE A SELF-SIGNED CERTIFICATE 1. Navigate to IIS Manager. 2. Click the Server (IIS). 3. Double-click the Server Certificates icon on the right to display the Server Certificates page. 4. Click Create Self-Signed Certificate in the Actions menu on the right (or right-click and select the option from the context menu). 14

18 INSTALL AND SET UP THE ELITE WEBSITE PACKAGE 5. Add a name for the certificate on the Specify Friendly Name page and click OK to create the certificate. The new certificate is now listed on the Server Certificates page. 15

INSTALL THE ELITE INTEGRATION FRAMEWORK INSTALL THE ELITE INTEGRATION FRAMEWORK Before installing the Elite Integration Framework package, you need to add http bindings

19 INSTALL THE ELITE INTEGRATION FRAMEWORK INSTALL THE ELITE INTEGRATION FRAMEWORK Before installing the Elite Integration Framework package, you need to add http bindings to the Elite website. 1. Go to IIS Manager and find the Elite site. 2. Right-click Elite and select Edit Bindings. 3. The Site Bindings page should look similar to this: 16

20 INSTALL THE ELITE INTEGRATION FRAMEWORK 4. Click Add and add an http binding with a different port (8080, for example). 5. Click OK on the Add Site Binding page to add your http binding to the site. 6. Click Close and exit IIS Manager. 17

INSTALL THE ELITE INTEGRATION FRAMEWORK INSTALL THE FRAMEWORK PACKAGE The main Framework package is in the Web Application category so return to the Install tab of the Configuration Tool: 1.

21 INSTALL THE ELITE INTEGRATION FRAMEWORK INSTALL THE FRAMEWORK PACKAGE The main Framework package is in the Web Application category so return to the Install tab of the Configuration Tool: 1. Click Web Application to display the available packages. 2. Click 1.0 under Q Framework. 3. Click Install to display the Browse For Folder pop-up. 4. Click Make New Folder and add a folder named QFramework under the Elite folder. 18

22 INSTALL THE ELITE INTEGRATION FRAMEWORK 5. Select the Framework folder, then click OK. 6. If there are multiple websites installed on the system, you are prompted to select the site on which to install the application. Select Elite. 7. Select c:\elite\qframework as the folder to extract the files to. 8. Use the Windows Prerequisites page to verify that the necessary Windows roles and features are installed. Depending on whether you have a server or desktop operating system, this check may be automatic or manual. If you are on a server operating system, you can perform an automated check. a. Click Check to automatically perform the validation on the current server setup. 19

the missing components. If the button is not available, contact your local server administrator.

23 INSTALL THE ELITE INTEGRATION FRAMEWORK You can follow the progress of the validation check. b. After the check finishes, if there are any necessary roles or features that are not installed, click Install to install the missing components. If the button is not available, contact your local server administrator. If you are on a desktop operating system, the automated check cannot be carried out. You must manually verify that the appropriate roles and features are installed. 20

24 INSTALL THE ELITE INTEGRATION FRAMEWORK 9. After you finish verifying the Windows roles and features, complete the Q Main Web Application page. FIELD Address App Pool Name App Pool Identity DESCRIPTION The Alias used within IIS for the application. The App Pool you want to run the application in. If a pool already exists, the application is added to that pool by default. No other app pool is created. The credentials to run the application under. Note: If you use an existing App Pool, the identity for that pool and all its applications will be changed to this identity. 21

25 INSTALL THE ELITE INTEGRATION FRAMEWORK 10. Click Next to display the Framework and Designer Settings page. The default values in the Q Install Directory and Storage Root fields should be accepted in most installations. 11. Click Next to display the Select Initial Configuration page. 22

26 INSTALL THE ELITE INTEGRATION FRAMEWORK Click Import and, on the Browse for Folder pop-up, navigate to the BDS folder under CustomConfig: Note: Be sure to select the BDS folder itself, not the CustomConfig folder. The custom dlls are in the lib and Shared folders as shown above. If you select CustomConfig, the installation will not complete successfully. 23

27 INSTALL THE ELITE INTEGRATION FRAMEWORK 12. Click Next to display the Framework Encryption Settings page, which lets you configure the unique Salt and Password values for communication with the adapters. You can add the values manually or click the GUID button on the right to set a unique GUID value. Click Finish to complete this process. The installer carries out the relevant tasks to install and configure the package and displays a Success prompt after a successful completion. 24

application windows Right click Request.

28 INSTALL THE ELITE INTEGRATION FRAMEWORK VERIFY FRAMEWORK REQUEST SERVICE Go to IIS Elite Site Framework application windows Right click Request.svc and select Browse. Check in the browser the request service is up and running: 25

INSTALL THE MOBILE GATEWAY SERVICES INSTALL THE MOBILE GATEWAY SERVICES INSTALL THE MOBILE GATEWAY PACAKAGE To install the Mobile Services package, return to the Install tab of the Configuration Tool

29 INSTALL THE MOBILE GATEWAY SERVICES INSTALL THE MOBILE GATEWAY SERVICES INSTALL THE MOBILE GATEWAY PACAKAGE To install the Mobile Services package, return to the Install tab of the Configuration Tool and select Web Application to display the available packages: 1. Click the version of the Mobile Services package that you want to install, then click Install at the bottom of the page. Note: If there are multiple websites installed on the system, a prompt requests you to select the site where you want to install the application. 26

30 INSTALL THE MOBILE GATEWAY SERVICES 2. In response to the next prompt, select a folder to extract the package files to. Note: If the installer finds multiple zip files containing the package files, you are prompted to select the correct zip file for the installation. 3. Complete the IIS Web Application Settings page. FIELD Address DESCRIPTION The Alias used within IIS for the application. 27

31 INSTALL THE MOBILE GATEWAY SERVICES FIELD App Pool Name App Pool Identity DESCRIPTION The App Pool you want to run the application from. If a pool already exists, the application is added to that pool by default. No other app pool is created. The credentials to run the application under. Note: If you use an existing App Pool, the identity for that pool and all its applications will be changed to this identity. 4. Click Next to display the Mobile Framework Settings page. You may optionally add a description for the Authentication, then add values for the Authentication Mode, Pin Complexity, and Pin Timeout. Finally, get the Security Key value from the Discovery Gateway and add it here. 28

32 INSTALL THE MOBILE GATEWAY SERVICES 5. Go to IIS and: a. Open the list of Application Pools and verify the identity of the Elite, MobileServices, and QFramework app pools. b. Change the authentication of QFramework. 29

33 INSTALL THE MOBILE GATEWAY SERVICES c. Add the URI that has been set up for the Q Service. To find the URI, browse to its location in IIS. For example: Add the URI on the Link to Q Framework page. 6. Click Finish. 30

INSTALL THE MOBILE GATEWAY SERVICES The installer carries out the relevant tasks to install and configure the package and displays a Success prompt

34 INSTALL THE MOBILE GATEWAY SERVICES The installer carries out the relevant tasks to install and configure the package and displays a Success prompt after a successful completion. VERIFY THE MOBILE GATEWAY SERVICE Go to IIS Elite MobileService. Right-click MobileFrameworkGateway.svc and select Browse. 31

35 INSTALL THE MOBILE GATEWAY SERVICES Check in the browser that the request service is up and running: DEFINE YOUR LAW FIRM FOR ELITE MOBILE Open your browser, navigate to and use the Elite Mobile admin credentials to log in. 32

36 INSTALL THE MOBILE GATEWAY SERVICES After logging in, click Home in the top right to display all the sites. 1. Click Create New and complete the fields as shown below. Substitute your organization s name for testmobile. In the URL field, type replacing localhost with your machine IP. Click Save. 2. Click Details for the law firm you just created. The Law Firm Details Page is displayed. 33

37 INSTALL THE MOBILE GATEWAY SERVICES 3. Click Display in the Installation Security Number Column and copy the Security Number. 4. Open the web.config file in C:\Elite\mobileservices (or wherever mobileservices is installed), and: Look for <add key= SecurityKey value= Replace the preexisting value with the Security Number you just copied. Note: Verify there are no leading/trailing spaces with the Security Number. Leading or trailing spaces will cause the application to fail! Save the file. 5. Return to the Law firm Details page. In the Law Firm Administrators section, click Create New. 6. Create a new admin user with a username and password. We will use this in the next step to log in to the firm. 7. Log off as the administrator. 34

38 INSTALL THE MOBILE GATEWAY SERVICES SET UP YOUR FIRM S USERS 1. Log in as the Law Firm Administrator you created in steps 5-6 above. After you log in, this screen is displayed: 35

INSTALL THE MOBILE GATEWAY SERVICES 2. Verify the Auto Accept Request checkbox is selected. 3. Click Users. 4. On the Manage Users page, click Create New. 5.

39 INSTALL THE MOBILE GATEWAY SERVICES 2. Verify the Auto Accept Request checkbox is selected. 3. Click Users. 4. On the Manage Users page, click Create New. 5. Create multiple users with addresses. Be sure each address is in the law firm s domain (lawfirmname.com). In our example, the address would be testmobile.com. 36

40 INSTALL THE MOBILE GATEWAY SERVICES ELITE MOBILE CONFIGURATION CHANGES CHANGE THE WEB CONFIG SETTINGS After installation, if you do not want to use SSL services, modify the web.config and service URI as shown below. Modify the web.config in the MobileServices endpoint as follows: <webhttpbinding> <binding transfermode="streamed"> <security mode="none" /> </binding> </webhttpbinding> <basichttpbinding> <binding transfermode="streamed"> <security mode="none" /> </binding> </basichttpbinding> <servicebehaviors> <behavior>  <servicemetadata httpgetenabled="true" httpsgetenabled="false" />  <servicedebug includeexceptiondetailinfaults="true" /> </behavior> </servicebehaviors> Update the serviceuri so it has no SSL and add the location of the Store to the storage root: <requests hostingtype="proxy" serviceuri=" /> <storage root="c:\elite\framework\store" /> 37

41 INSTALL ELITE MOBILE APP ON IPAD 1. Tap the App Store icon on your ipad to open the App Store. 2. In the App Store, tap the search textbox on the top right corner. Use the keyboard to type elite mobile in the search box, then tap Search. 38

42 INSTALL THE MOBILE GATEWAY SERVICES The keyboard disappears as your search results, including the Elite Mobile app, display. 3. Tap Free next to Elite Mobile to start downloading the app. After the download finishes, click Open. 39

OPEN THE APP ON YOUR IPAD Now that the app is installed on your ipad,

43 OPEN THE APP ON YOUR IPAD 4. Press the Home button on the ipad and find the Elite Mobile app. OPEN THE APP ON YOUR IPAD Now that the app is installed on your ipad, open the app. 1. Add an authorized address where requested, on the first screen. Add users on the Law Firm s admin site. 40

$domain\username format) and password on the sign-in screen: 3.$

44 OPEN THE APP ON YOUR IPAD 2. Add the BDS user s Windows authentication name (in the domain\username format) and password on the sign-in screen: 3. Finally, type a PIN on the Security PIN keypad that is displayed. For now, type 1111 as the PIN. 41

45 OPEN THE APP ON YOUR IPAD The app should now display, as shown below, on your ipad: 42

NBC-IG Installation Guide. Version 7.2

NBC-IG Installation Guide. Version 7.2 Installation Guide Version 7.2 2017 Nuance Business Connect 7.2 Installation Guide Document Revision History Revision Date August 8, 2017 Revision List Updated supported SQL Server versions June 14, 2017