Application Server Installation

Transcription

1 Application Server Installation Guide ARGUS Enterprise /25/2015 ARGUS Software An Altus Group Company

2 Application Server Installation ARGUS Enterprise Version /25/2015 Published by: ARGUS Software, Inc. 750 Town and Country Blvd Suite 800 Houston, TX Telephone (713) Facsimile (713) Information in this document is subject to change without notice and represents no commitment on the part of ARGUS Software, Inc. This document is copyright 2015, ARGUS Software, Inc. All rights reserved. This document is a confidential and proprietary trade secret of ARGUS Software, made available only under a license agreement and or other agreements containing obligations of confidentiality. "ARGUS" and ARGUS Enterprise are trademarks of ARGUS Software, Inc. All other trademarks and registered trademarks are property of their respective companies ARGUS Software, Inc.

3 Table of Contents Introduction... 1 Purpose... 1 Before You Begin... 1 Getting Additional Assistance... 6 Overview of ARGUS Application Server... 7 Enterprise Services... 7 Database Server Components... 7 Installation of Business Services... 8 Enterprise Server Installation... 8 Single Server Installation... 8 Multiple Server Installation Configuration Tool System AE 11.0 Database Reporting Deployment Types Process Service Application Service Data Service Licensing ARGUS Enterprise Server Manual Configuration of Windows Services General Tab Log On Tab Recovery Tab (Recommended) Dependencies Tab Change, Repair, or Remove Installation Change Installation Repair Installation Remove Installation Appendix: Manual Database Upgrade AE 11.0 Database SQL Server Database Options Generating Database Scripts to perform a manual upgrade Manually Executing the Database Upgrade Scripts Attachments Hardening Requirement for ARGUS Enterprise ARGUS Software, Inc.

4 Purpose Introduction This document is intended to facilitate the deployment of ARGUS Enterprise by providing the following: An overview of the Windows component service and other components used by ARGUS Enterprise Application Server Step-by-step instructions for installing each of these components, regardless of deployment scale Directions for configuring each of the Windows services Before You Begin Before starting to install ARGUS Enterprise, please take a moment to make sure that you have fulfilled the following prerequisites. Desktop Requirements Note: Pay particular attention to the SQL server requirements if you are performing an upgrade to an existing database. Modifications to the database structure will cause the upgrade process to take much longer than normal, especially on large databases. 1. Confirm that your system meets the requirements outlined in the appropriate Small, Medium, or Large Enterprise Planning guide. 2. You need to have administrator rights to proceed with the installation. Application Server Requirements 1. Confirm that your server meets the requirements outlined in the appropriate Small, Medium, or Large Enterprise Planning guide. 2. Make sure you have fully downloaded the ARGUS Enterprise installation program ARGUS Software, Inc.

5 Services Account Setup for Application and Processing Servers. The configuration will default to NT Authority\Local Service account on install. This will only work for AE services installed on the same machine as the SQL Server database. For most scenarios other than trial systems, this is not the recommended server setup. See Planning guides for more information. For most server deployment scenarios the following is recommended. 1. Create a Domain Service Account to run the core ARGUS Enterprise services (Application and Processing Services). It is good practice to set the following: Password never expires User cannot change password 2. For added security, optionally remove the service account from the domain users group by performing the following steps: Create a domain group (e.g., AE Service Accounts). Assign this group to the primary group of the service account. Change the service accounts primary group to the new domain group that you created. Remove the service account from domain users. This limits the security footprint of the account by limiting access to other machines in the domain. Thus, if this account becomes compromised, the exposure is limited. Add this new group to the users local group of the service machines. Note: This account will also be used to run the ARGUS Enterprise SQL Server Reporting Services (SSRS) component and additional permissions may need to be applied. (See the Reporting section.) In all cases, the selected service account or service accounts group will need to be added to the AE Users role in the ARGUS Enterprise database order to limit access rights to just those needed by the service. Service Account Special Considerations Set up your service account according to the following recommendations: 1. TCP/IP protocol only: Note: If you are running windows firewall, ensure that the TCP/IP service ports are opened on the firewall. You may also need to check any virus scanning software you have installed as some of them have firewalls as well. Note: If you are upgrading from an earlier version of ARGUS Enterprise, it should be noted that the Service Account is no longer required to be part of the Local Admin Group ARGUS Software, Inc.

6 2. HTTP/HTTPS protocol: Either: For http run netsh http add urlacl url= user="domain\username", or for https run netsh http add urlacl url= user="domain\username" from an administrator command line. Change the parts in red to match your installation port and service account username minus the outside quotes. Or: Add the service account to the local administrators. Although this is a simpler solution, consult your security guidelines before implementing this as this increases the security footprint. 3. If the system is required to Import/Export DCF files: Either: Add the argus.exe and reaplengine32.exe files in the Shared Components folder of the installation path into DEP if they are not there already. Grant the service account launch for the following two components in Component Services : APLW, and 56388E5E EB6-808C-6E C6. Contact support for help configuring if errors occur. Or: Add the service account to the local administrators. Although this is a simpler solution, consult your security guidelines before implementing this as this increases the security footprint SQL Server Database Upgrade Requirements Note: The upgrade of a database to ARGUS Enterprise version 10.5 and subsequent versions from a pre-10.5 database will require a significantly longer time to accomplish than previous versions due to some underlying technical changes. Please expect upgrade times that may last up to several hours for very large databases. Ensure that you have a current backup before proceeding with an upgrade. Before executing the database upgrade through the configuration utility or by manually running the upgrade scripts (See Appendix), ensure that the following steps are taken to prepare and secure the database from unintended access during the upgrade process. Ensure that a database backup has been taken so that the log file is truncated as the log file can grow very large during the database upgrade. Also, in the unlikely event that a problem is encountered with the upgrade that cannot be rectified without starting over, the original database can be restored and the process repeated. In order to reduce the size the log file can grow to and potentially fail the upgrade due to disk space issues, it is recommended you switch the database recovery model from Full Recovery to Bulk Logged as per the advice in the Configuration Utility Database Upgrade Wizard. For an upgrade of a pre-10.5 database, it is recommended you pre-grow the database and log files prior to the upgrade as the database can grow by as much as 60% due to the need to move data when making structural changes to the Results Tables necessary in order to enhance performance. Pre-sizing the files will ensure that there is sufficient disk space and also will be less time consuming ARGUS Software, Inc.

7 than repeated auto grow extensions of the database. Leave Auto Grow enabled in case the estimated growth is insufficient. Pre-10.5 Database SQL Server Database Interface/Report Customization Requirements By far the biggest change a to pre-10.5 database was the addition of the ScenarioId column as part of the primary key for all results tables. This change was carried out to improve the performance of scenario/portfolio level reporting within ARGUS Enterprise. CalculatedKPIs FinancialLineItems FinancialLineItemValues KPIItems KPIItemValues ModeledEntities ModeledEntityDetails ModeledEntityReportData OtherItems OtherItemValues UKTVAcquisitionCost UKTVCapitalExtras UKTVGroundLease UKTVGroundLeaseRentSlice UKTVOperatingExtra UKTVProperty UKTVPropertyCapitalCosts UKTVPropertyRunningYields UKTVRevExes UKTVTenant UKTVTenantRentSlice IMPORTANT NOTE: It should be noted that this may have an adverse effect on the performance of any Custom Reporting or data extract that relies on the primary key indexes that were present prior to 10.5 as these indexes will no longer be present. Those queries are now liable to cause table scans which will perform poorly on large databases where results records can run into the tens of millions. It is recommended that custom reports and data extracts be modified to include the Scenario Id as part of the filter criteria of queries to these tables. If this is not immediately possible, ARGUS Support can provide an optional script that will create indexes to replicate the old indexes and give similar read performance to that prior to 10.5, with two significant warnings: This may degrade write performance and will have a big impact on the space taken up by the database, increasing the size of the data files by as much as 20%. For these reasons, it is recommended that queries be modified to include ScenarioId rather than apply this script. If it proves necessary to apply the indexes as an interim fix to the system, ARGUS Support can also provide a script to remove the indexes once all custom modifications have been made ARGUS Software, Inc.

8 SQL Server Requirements 1. Confirm that your server meets the requirements in the Small, Medium, or Large Enterprise Planning guides. 2. Confirm that SQL Server is installed and functional. 3. Associate the service account created for the application service with the AE User role in order to limit access rights to just those needed by the service. This can be done after the ARGUS Enterprise database has been created. SQL Server Reporting Services configuration 1. Utilize the AE Service Account for accessing SSRS Report content via the Connection String. 2. Define an AD group containing each user, who will be accessing the content defined in SSRS, as a BROWSER role. Network Connectivity Requirements 1. Note that the Application Server Endpoint makes use of the Net TCP, or HTTP protocols. By default, our application uses the Net TCP port number Add port number 8102 to any firewall exceptions. 3. Add default SQL Server port to any firewall exceptions. 4. Make sure that SQL Server services are running. 5. Enable TCP/IP connection. Note: If your enterprise will be exporting and importing models to and from ARGUS Valuation DCF, additional security might need to be granted to the APLW com object in the Distributed Component Object Model (DCOM) Config section of Component Services. If the service account used as the login for the Application and Process services is not a local administrator on the server, then that account needs to be granted Launch and Activation permissions and Access permissions. Note: When importing a.sf file on a machine that contains the Application Service and/or the Process Service and the database, the service(s) will need to logon using a local machine account or a domain account (recommended.) Be aware that the use of NT Authority\Local Service will not work in this scenario ARGUS Software, Inc.

9 Getting Additional Assistance The ARGUS Support Team is available for questions throughout the day. If you have questions regarding these instructions, please contact Technical Support: Online Visit our support page at By Telephone Support Hours of Operation Americas Europe 7:30am to 6:30pm GMT-6 Monday to Thursday 7:30am to 6:00pm GMT-6 Friday excluding USA public holidays 9:00am to 5:30pm GMT Monday to Friday excluding UK public holidays Middle East/Africa: 9:00am to 5:30pm GMT +8 Monday to Friday excluding public holidays Asia/Pacific 9:00am to 5:30pm GMT+8 Monday to Friday excluding Singapore public holidays ARGUS Software, Inc.

10 Enterprise Services Overview of ARGUS Application Server The ARGUS Server component consists principally of the three Windows services described below. A Windows service is a long-running executable that performs specific functions and does not require user intervention. Windows services can be configured to start when the operating system is booted and to run in the background as long as Windows is running. Application Services Application services represent the principal business logic layer for the ARGUS Enterprise Solution. Requests from the ARGUS Enterprise client application and Excel Add-in component are handled by the application service. Typically, a single application service is deployed, but the solution can be scaled by deploying multiple application services behind a load balancer. The subject of load balancing is outside the scope of this document. Process Service The ARGUS Enterprise Process Service operates as the bulk data management and manipulation component of the application. The process service manages communication between the business logic layer and the database. The solution can be scaled by deploying multiple process services, each requiring its own server. Data Service (Optional) The Data Service provides specialized data integration facilities. It is an optional part of ARGUS Enterprise 11.0 and should only be installed and configured if data integration is required. Database Server Components The ARGUS Database Server comprises two components: the ARGUS Data Warehouse (ADW) and the SQL Server Reporting Services (SSRS) for Repertoire Reporting. These components store all data for the entire ARGUS Enterprise Application Suite and provide report generation services via a separate, secure server. The ARGUS Database Server may follow two paths for installation: Standalone or Cluster. The appropriate path for your installation varies based on your organization s needs and the scale of your deployment. See the three documents for Large, Medium, and Small Enterprise Planning for more information on how to select the most appropriate installation path for your deployment of ARGUS Enterprise. System Requirements Before installing the ARGUS Enterprise core business services, the installation of the ARGUS Enterprise Database Server should be completed and verified. Please refer to the ARGUS Enterprise Server System Requirements to determine the hardware and software requirements that match the scale of your deployment. Installed Components Upon successful completion of the tasks described in this document, the following components will be installed: ARGUS Enterprise 11.0 database SSRS for Repertoire Reporting Application Service Process Services (Optional) Data Service ARGUS Software, Inc.

11 Enterprise Server Installation Installation of Business Services ARGUS Enterprise core and optional business services are installed by a standard SETUP.EXE executable program. All services can be installed on a single server (i.e., single-server installation). However, it is recommended that each service be individually installed on different servers for medium or large deployments (i.e., multiple-server installation, see below). In either case, it is recommended that SQL Server be installed on a separate server. Single Server Installation The single server installation process will: Install the business service software. Create Windows Services. Create uninstall information. 1. Begin by downloading the installation program from the ARGUS support download site at 2. When prompted, Run or Save the installation program, Setup.exe. Run: Choose Run to run the installation program if it is located on a local network. Save: Choose Save if the installation program is being downloaded from the ARGUS support site. Remember to note the file location for future reference. 3. Navigate to the location of the installation program and double click the file to launch the installer. Click Run. The installer launches automatically. 4. Click Next to launch the Setup Wizard ARGUS Software, Inc.

12 5. The system displays which components need to be installed and which ones (if any) are already installed. The installation program automatically detects whether your computer has Microsoft.NET Framework Version 4.0 installed. If it is not found, the installation program launches the Microsoft.NET installation. Click Accept to install Microsoft.NET Framework Version 4.0 and follow the instructions on-screen. Click Next to launch the Setup Wizard ARGUS Software, Inc.

13 6. Read and accept the End-User License Agreement. Click Next to continue. 7. Select which type of ARGUS Enterprise Installation will be performed. When you click the icon, the setup automatically continues. For a single server installation, select the Server Installation option to automatically install all three services (application services, process services, and data integration services) ARGUS Software, Inc.

14 8. To change the default installation folder, enter the name of the new folder, or click Change to browse for another folder. Click Next to proceed. 9. Click Install to install the software or click Back to review or change settings ARGUS Software, Inc.

15 10. The Setup Wizard displays a status bar to indicate progress installing the program. If prompted by Windows User Account Control (UAC), click Yes to allow the program to make changes to this computer. 11. Click Finish. Note: If upgrading from an earlier release of ARGUS Enterprise, the system displays the database selection screen. Select the database server with your prior version ADW database ARGUS Software, Inc.

16 12. This screen does not appear if you are installing to a server that has never had any version of ARGUS Enterprise. Click OK. 13. The ARGUS Enterprise configuration utility runs automatically to configure Services and the ARGUS Data Warehouse database. 14. For each machine on which you have installed a service, set the connection strings for any installed service by clicking AE 11.0 Database. For example, if the services are installed on only one machine, click AE 11.0 Database and runs the Database Wizard once. If the services are installed on three machines, you will need to repeat this process once for each machine. If this is the first service you are configuring, AE 11.0 Database installs or upgrades your existing prior version database. Refer to the Configuration Utility>AE 11.0 section ARGUS Software, Inc.

17 Multiple Server Installation Each service can be individually installed on different servers. In larger implementations, the Process Service can be installed on multiple servers to provide scalability of batch processing services. Consult the appropriate Medium or Large Enterprise Planning guide. The installation process: Installs the selected business service software. Creates Windows Service(s). Creates uninstall information. 1. Begin by downloading the installation program from the ARGUS support download site at 2. When prompted, Run or Save the installation program, Setup.exe. Run: Choose Run to run the installation program if it is located on a local network. If you select this option, continue with Step 2. Save: Choose Save if the installation program is being downloaded from the ARGUS support site. Remember to note the file location for future reference. 3. Navigate to the location of the installation program and double click the file to launch the installer. Click Run. The installer launches automatically. Click Next to launch the Setup Wizard ARGUS Software, Inc.

18 4. The installation program automatically detects whether your computer has Microsoft.NET Framework Version 4.0 installed. If it is not found, the installation program launches the Microsoft.NET installation. Click Accept to install Microsoft.NET Framework Version 4.0 and then follow the instructions on-screen. 5. Click Next ARGUS Software, Inc.

19 6. Read and accept the license agreement. Click Next. 7. Select Custom Installation to install the server components. When you click the item, the setup automatically continues to the next step ARGUS Software, Inc.

20 8. The Custom Setup window allows you to choose specific software components and a location for installation. Select only the ARGUS Enterprise server you wish to install (e.g.., the application service, the process service, the data integration service). Click Browse to change the installation path or to install one or more of the services on a different drive. To remove a component from installation, de-select the component. Click Next. Note: Some Administrators also install clients (e.g., Excel 4 ADW, Enterprise Client) if they want to test directly on this same server. This is recommended. 9. Click Install to begin the installation of the software, or click Back to review or change your settings ARGUS Software, Inc.

21 10. The installation automatically begins. 11. If upgrading from an earlier release of ARGUS Enterprise, the system displays the database selection screen. Select the database server with your prior version ADW database. Click OK. This screen does not appear if you are installing to a server that has never had any version of ARGUS Enterprise ARGUS Software, Inc.

22 12. Once the installation is complete, the system displays the above screen. Click Finish. 13. The system displays the ARGUS Enterprise 11.0 Configuration screen. For each machine on which you have installed a service, set the connection strings for any installed service by clicking Database Wizard in the AE 11.0 Database page selector. Note: If this is the first service you are configuring, Update or Change Database installs or upgrades your existing prior version database. Refer to the Configuration Utility>AE 11.0 section ARGUS Software, Inc.

23 System Configuration Tool The System option enables you to create and save a Diagnostics system report that contains the configuration of ARGUS Enterprise 11.0 along with basic information about your operating system (no persona information is included). This report may help ARGUS Software support to assist you with any issue you encounter. Diagnostics Click Diagnostics Report and select an option from the pick list. You may choose from the following options: Copy to Clipboard Save to File System Health Read any error or warning messages in this section. On the right side of the window, you can click on any of the Click here to fix hypertext links to launch the Data Service for each issue. Click Refresh to refresh the window ARGUS Software, Inc.

24 AE 11.0 Database The AE 11.0 Database option enables you to manually launch the Database Wizard. The SQL Server Instance options can be updated or changed as often as necessary by clicking Database Wizard. Read any error or warning messages in the Status section. You can also click on any of the Click here to fix hypertext links to launch the Database Wizard window. Click Refresh at the bottom to refresh the window. Upgrading an Existing Database There are two ways to upgrade your existing database: The configuration tool: Recommended Generate scripts and execute them manually: Go to the Appendix: Manual Database Upgrade now for instructions. 1. Click Database Wizard on the right side of the screen to launch the Database Wizard ARGUS Software, Inc.

25 Important Note: The upgrade of a database to AE version 11.0 and subsequent versions from a pre-11.0 database will require a significantly longer time to accomplish than previous versions due to some underlying technical changes. Please expect upgrade times that may last up to several hours for very large databases. Ensure that you have a current backup before proceeding with an upgrade. 2. Click Next to start preparing your database ARGUS Software, Inc.

26 SQL Server Database Options The SQL Server Installation window offers two options: Use Existing Local SQL Server Express LocalDB Use an Existing SQL Server Instance: Choose this option for the Application Server setup. 3. Select Use an Existing SQL Server Instance ARGUS Software, Inc.

27 4. If you know your server and database names, enter them in the appropriate fields. Otherwise, you can search for them in the pick lists. If installed on a cluster, the name of the SQL Server on which the ADW database is to be installed is the shared Instance Name. Click Next to continue. Server: If you know your server and database names, enter them in the appropriate fields. Otherwise, you can search for them in the pick lists. If installed on a cluster, the name of the SQL Server on which the ADW database is to be installed is the shared Instance Name. Authentication: The user credentials required to connect to the SQL Server. o o Windows Authentication: If this option is selected, the User ID and Password do not have to be entered. SQL Server Authentication: If this option is selected, the appropriate User ID and Password must be entered. Note: You should select the Windows Authentication option in most cases. You should only select the SQL Server Authentication option if you are a database administrator or a person who will be responsible for making regular user changes and monitoring user access to the ARGUS Enterprise database. User ID/Password: Enter the User ID and Password if needed. Database: The name of the ADW Database to be installed on the SQL Server ARGUS Software, Inc.

28 5. Upgrading an existing database, the wizard displays both the current and the upgraded database versions. Click Next to continue. 6. Select Run the database scripts now, and click Next to continue running the scripts. If you wish to inspect the scripts before applying them to the database, you can select the option Save the scripts so that I can run them later. Run the database scripts now: If this option is selected, the wizard connects to the MS SQL Server using the user credentials supplied earlier and creates the database immediately. Save the scripts so that I can run them later: Refer to the Appendix: Manual Database Upgrade ARGUS Software, Inc.

29 Warning: If you have never performed a SQL backup on your database, you will see the following screen. You may need to perform a SQL backup before proceeding with the database upgrade. 7. After you have backed up your database, select the box next to the message By checking this box you are agreeing Click Next to proceed with the database upgrade. Note: If you choose Run the database scripts now, we recommend performing a transaction log backup before clicking Next. If you select Run the database scripts now, you may see the following screen. If you don t see the following screen, continue to Step 8. Choose to alter the recovery model automatically to bulk logged (recommended) or to ignore the recovery model. Click Next to continue. Note: If you select bulk-logged recovery mode the wizard will switch back to full recovery on completion of the upgrade. It is highly recommended that you choose bulk logged mode to reduce the log file size increase during the upgrade process ARGUS Software, Inc.

30 Wait while the system executes the database scripts. 8. The wizard confirms the creation of the new database. Click Finish to close the installer and return to the configuration utility. The ARGUS Enterprise Configuration utility runs automatically to configure Services and the ARGUS Data Warehouse database. For details on database configuration, see the Configuration Utility>AE 11.0 section ARGUS Software, Inc.

31 Creating a New Database If you are creating a brand new database, follow the instructions in this section. 1. Click Database Wizard on the right side of the screen to launch the Database Wizard. 2. Click Next to start preparing your database ARGUS Software, Inc.

32 3. Select Use an Existing SQL Server Instance. 4. Enter the names of the existing SQL server and new database. Click Next. If you know your server and database names, enter them in the appropriate fields. Otherwise, you can search for them in the pick lists ARGUS Software, Inc.

33 5. Click Next to create the new database. 6. Select Run the database scripts now, and click Next to continue running the scripts. If you wish to inspect the scripts before applying them to the database, you can select the option Save the scripts so that I can run them later. Run the database scripts now (recommended): If this option is selected, the wizard connects to the MS SQL Server using the user credentials supplied earlier and creates the database immediately. Save the scripts so that I can run them later: Refer to the Appendix: Manual Database Upgrade. Note: If you choose Run the database scripts now, we recommend performing a transaction log backup before clicking Next. 7. Click Next ARGUS Software, Inc.

34 8. If you select Run the database scripts now, you may see the following screen. If you don t see the following screen, continue to Step 9. If you do see the following screen choose Alter the recovery model automatically to bulk logged or Ignore the recovery model. Click Next to continue. Wait while the system executes the database scripts ARGUS Software, Inc.

35 9. The wizard confirms the creation of the new database. Click Finish to close the installer and return to the configuration utility. The ARGUS Enterprise Configuration utility runs automatically to configure Services and the ARGUS Data Warehouse database. For details on database configuration, see the Configuration Utility>AE 11.0 section. Reporting The Reporting option allows you to deploy your reports according to the parameters set in the Report Mode and Report Location fields. Deploy to SSRS You can choose to deploy your reports to an existing Microsoft SSRS instance. SQL Server Setup ARGUS Enterprise uses Microsoft SSRS to generate reports within the ARGUS Enterprise Client. The presentation of these SSRS reports in the ARGUS Enterprise solution is referred to as Repertoire Reporting. It is assumed that SSRS 2008 (required) or SSRS 2008 R2 (recommended) installation has been completed and verified. To best support Repertoire Reporting, SSRS security should be configured in the following manner: Prerequisites Use the ARGUS Enterprise Service Account for accessing SSRS Report content via the Connection String. Define an AD group containing all users that will be accessing the content defined in SSRS as a BROWSER role. Before beginning the installation, ensure MS SQL Server 2008 R2 has been installed. If the database server is shared with other applications, database backups should be performed prior to installing. If SSRS is installed on the same cluster as ADW, the SSRS Reports for Repertoire Reporting installation must be run on each node of the cluster even though SSRS is not cluster-aware. If SSRS is running on a remote-hosted instance of SQL Server (different from the instance where ADW is installed) the SSRS Reports for Repertoire Reporting should be installed on the server hosting SSRS ARGUS Software, Inc.

36 1. Select Reporting in the left navigation pane. Click Deploy Reports. 2. The ARGUS Enterprise Report Deployment Wizard opens. 3. Click Next to continue ARGUS Software, Inc.

37 Deployment Types The Report Deployment Wizard offers two Deployment Types. You can choose to deploy your reports to either: SSRS, an existing Microsoft SQL Server Reporting Services instance A folder on your machine or on a network Deploy to SSRS You can choose to deploy your reports to a network. 1. Choose the Deploy to SSRS option. Click Next to continue. 2. Enter the URL of your SQL Server Reporting Services web service and base folder in the Report Server URL and Base Folder fields. Click Next to continue ARGUS Software, Inc.

38 3. Choose an authentication type: Windows Authentication SQL Server Authentication 4. Enter your user name and password in the User Name and Password fields. 5. Click Next to continue. 6. Click Next to continue ARGUS Software, Inc.

39 7. Wait while the Report Deployment Wizard deploys your reports. 8. The Report Deployment Wizard has finished deploying your reports. Click Finish to complete this process. The ARGUS Enterprise 11.0 Configuration Tool window automatically opens. 9. Click Reporting in the left navigation pane to view your report mode and location ARGUS Software, Inc.

40 Deploy to Folder You can choose to deploy your reports to a folder on your local machine or network. Prerequisites Before deploying the reports to a folder, the following prerequisites must be met: Reports must be deployed to a network share where users have access and full permissions. ARGUS Enterprise users must have direct access to the SQL Server. ARGUS Enterprise users must have read and write permissions to the ARGUS Enterprise database. 1. In the Configuration tool, click Reporting in the left navigation pane. 2. Click Deploy Reports. The ARGUS Enterprise Report Deployment Wizard starts ARGUS Software, Inc.

41 3. Click Next to continue. 4. Choose the Deploy to Folder option. Click Next to continue ARGUS Software, Inc.

42 5. The program prompts you to use the pre-selected folder. Click to select a different folder. Click Next to continue. The Report Deployment Wizard is now ready to deploy your reports. 6. Click Next to continue ARGUS Software, Inc.

43 7. The Report Deployment Wizard has finished deploying your reports. Click Finish to complete this process. 8. The ARGUS Enterprise 11.0 Configuration Tool window automatically opens. 9. Click Reporting in the left navigation pane to view your report mode and location ARGUS Software, Inc.

44 Process Service The Process Service option allows you access to the ARGUS Enterprise Process Service, which operates as the bulk data management and manipulation component between the core business services and the database. You may need to manually configure your services if the account you are using to run them has never been used for services before. The Process Services may be installed in one of three ways: Installed on the same server as the other ARGUS Enterprise services Installed on a single dedicated server Installed on multiple dedicated servers The configuration steps are the same for each method. If the Process Services have been installed on multiple servers, configuration needs to be run on each server. 1. Select ARGUS Enterprise 11.0 Configuration from the ARGUS Software\ARGUS Enterprise 11.0 folder in the Start>All Programs menu or run the application file ARGUS.ConfigurationUtility.UI.exe in the database folder from Windows Explorer. 2. Choose Process Service in the left navigation pane. 3. The service account used by the Process Service defaults to LocalSystem. To change the service account, first click to stop the service. Then click ARGUS Software, Inc.

45 4. If the Process Service is currently stopped, choose the hyperlink Click here to fix. 5. Select an account type for the Service Account: Account (only use if the database on same machine) Specific Account (see before you start section) 6. Enter the account name and password in the marked fields. Click OK to finish. Note: The service account will need to be associated with the AE User role in the ARGUS Enterprise database in order to limit access rights to just those needed by the service. 7. Click to start the Process Service. The Service Status changes to Running. You can also click to stop the Process Service 8. Update Simultaneous Tasks on the server dedicated to the Process Service to the number of server processor cores multiplied by 1.5. Note: The Performance Settings for Busy Wait Time and Empty Queue Wait Time should only be adjusted on the advice of the ARGUS Support Team ARGUS Software, Inc.

46 Application Service The Application Service option allows you access to the ARGUS Application Service, which is the principal business logic layer for handling requests from the Enterprise Client. You may need to manually configure your services if the account you are using to run them has never been used for services before. If you have difficulty getting the services to start, consult the Manual Configuration of Windows Services section. Note: The Configuration Utility does not have to be run immediately after installation; however, the system will need to be configured prior to using ARGUS Enterprise. 1. Select ARGUS Enterprise 11.0 Configuration from the ARGUS Software\ARGUS Enterprise 11.0 folder in the Start > All Programs menu or run the application file ARGUS.ConfigurationUtility.UI.exe in the database folder from Windows Explorer to display the ARGUS Enterprise 11.0 Configuration screen. 2. Click the Application Service option in the left navigation pane. 3. The Service Account defaults to Local Service. To change the Service Account, first click to stop the application service. Click next to the Service Account field ARGUS Software, Inc.

47 4. Select an account type for the Service Account. You may choose from the following options: Use Default Account: The Account Name and Password are auto populated. Use Specific Account: You must enter an Account Name and Password. 5. Enter the Account Name and Password in the appropriate fields. Click OK to finish. 6. In the Network Configuration section, click next to the TCP Endpoint field. 7. Enter the port number in the Port Number field. You may also increment/decrement the number using the arrows to the right. Click Set Default Port to set your selected port number as the default. 8. Make sure the Enabled option remains selected, so your changes take effect. Click OK when you are finished ARGUS Software, Inc.

48 Note: The service account will need to be associated with the AE User role in the ARGUS Enterprise database in order to limit access rights to just those needed by the service. 9. Click to start the Application Service. The Service Status changes to Running. 10. Repeat Step 3-8 for the HTTP Endpoint and HTTPS Endpoint fields ARGUS Software, Inc.

49 Data Service The Data Service option provides specialized data integration facilities. It is an optional part of ARGUS Enterprise 11.0 and should only be installed and configured if data integration is required. You may need to manually configure your services if the account you are using to run them has never been used for services before. If you have difficulty getting the services to start, consult the Manual Configuration of Windows Services section. 1. Select ARGUS Enterprise 11.0 Configuration from the ARGUS Software\ARGUS Enterprise 11.0 folder in the Start > All Programs menu or run the application file ARGUS.ConfigurationUtility.UI.exe in the database folder from Windows Explorer. 2. Click Data Service in the left navigation pane. 3. Run Steps 3-9 in the Application Service section above. Note: The service account will need to be associated with the AEUser role in the ARGUS Enterprise database in order to limit access rights to just those needed by the service ARGUS Software, Inc.

50 Licensing ARGUS Enterprise Server Adding a New License Adding a new license allows you to use the license and product key on the current computer. To add a new license, you need an Internet connection. 1. Navigate to Start>All Programs>ARGUS Software>ARGUS Enterprise 11.0>ARGUS Enterprise 11.0 Configuration. Alternatively, you can run the application file ARGUS.ConfigurationUtility.UI.exe in the database folder from Windows Explorer. 2. Select Licensing in the left navigation pane. 3. Click Add New License. 4. Select your Product from the pick list. 5. Enter Address, Company Name, and License Keys. 6. Select an area from Where are you? 7. Click Next to continue ARGUS Software, Inc.

51 Checking Out a License Checking out a license allows you to use the license and product key on the current computer. You need an Internet connection to check out a license. 1. Navigate to Start>All Programs>ARGUS Software>ARGUS Enterprise 11.0>ARGUS Enterprise 11.0 Configuration. Alternatively, you can run the application file ARGUS.ConfigurationUtility.UI.exe in the database folder from Windows Explorer. 2. Select Licensing in the left navigation pane. 3. Select the license from the right navigation pane. 4. Click Check Out Selected Licenses. Result: Launches the Check Out ARGUS Software License pop-up. 5. Select your Product from the pick list. 6. Enter Address, Company Name, and License Keys. 7. Select an area from Where are you? ARGUS Software, Inc.

52 8. Click Next to continue. Result: Launches Software License Agreement window 9. Select I accept the terms of the license agreement after you review the Software License Agreement. 10. Click Print to print a copy of the agreement. Access this agreement any time. 11. Click Next to continue. 12. Select your preferred method for check out: Check out my license over the Internet. Check out my license by telephone use this option if you do not have an Internet connection. 13. Click Finish to complete this process ARGUS Software, Inc.

53 Refreshing a License Refreshing your license allows you to retrieve license information from the IBL server and update the license information saved in the local store. To refresh your license, you need an Internet connection. 1. Navigate to Start>All Programs>ARGUS Software>ARGUS Enterprise 11.0>ARGUS Enterprise 11.0 Configuration. Alternatively, you can run the application file ARGUS.ConfigurationUtility.UI.exe in the database folder from Windows Explorer. 2. Select Licensing in the left navigation pane. 3. Select the license from the right navigation pane. 4. Click Refresh Selected Licenses. Checking In a License Checking in your license allows you to reuse the license and product key for a version upgrade or reinstall or to use them on a different computer. To check in your license, you need an Internet connection. Internet Check In 1. Navigate to Start>All Programs>ARGUS Software>ARGUS Enterprise 11.0>ARGUS Enterprise 11.0 Configuration. Alternatively, you can run the application file ARGUS.ConfigurationUtility.UI.exe in the database folder from Windows Explorer. 2. Select Licensing in the left navigation pane. 3. Select the license from the right navigation pane. 4. Click Check In Selected Licenses. 5. Select Check in my licenses over the Internet. 6. Click Next to continue 7. Click Finish to complete this process ARGUS Software, Inc.

54 Phone Check In 1. Select Licensing in the left navigation pane. 2. Select the license you want to check in from the right navigation pane. 3. Click Check In Selected License. 4. Select Check in my licenses by telephone. 5. Click Next to continue. 6. Select your region from Please tell us where you are located. 7. Click Next to continue. 8. Call the number displayed on the Telephone Check In window. 9. Give the ARGUS representative your license key and site code. (These fields are automatically populated). Enter the authorization code the representative gives you. 10. Click Next to continue. Removing a License Removing a license will prevent the license and product key from being used on the current computer. To remove a license, you need an Internet connection. 1. Navigate to Start>All Programs>ARGUS Software>ARGUS Enterprise 11.0>ARGUS Enterprise 11.0 Configuration. Alternatively, you can run the application file ARGUS.ConfigurationUtility.UI.exe in the database folder from Windows Explorer. 2. Select Licensing in the left navigation pane. 3. Select the license in the right navigation pane. 4. Click Remove Selected Licenses. Result: License is removed ARGUS Software, Inc.

55 Manual Configuration of Windows Services Basic configuration options for the Windows services, including starting the services, are provided by the ARGUS Enterprise 11.0 Configuration Utility. Advanced options are available from the Windows Services console. To access the Windows Service console, click Start>Control Panel>System and Security>Administrative Tools>Services. Then right click the server name (e.g., AE 11.0 Application Service), and select Properties ARGUS Software, Inc.

56 General Tab Click General for display information about your service properties. In the AE 11.0 Application Service Properties (Local Computer) window, the Startup type field is set to Automatic by default. This is the recommended setting and ensures the ARGUS Enterprise Services come back online whenever the machine is rebooted. You can click the hypertext link Help me configure service start up options to open the Microsoft Management Console window for additional information ARGUS Software, Inc.

57 Log On Tab Click Log On to access the account information. You can change the Log on as option by selecting either Local System account or This account and entering an account and password for the service account. You can click the hypertext link Help me configure user account log on options to open the Microsoft Management Console window for additional information. Note: A domain account with privileges to both the local application server and the ARGUS Enterprise Database Server is required to run the ARGUS Enterprise Core Services. Click Browse to enter object types, locations, and check names ARGUS Software, Inc.

58 Recovery Tab (Recommended) 1. To change the recovery process for when a service fails, click Recovery. 2. You can click the hypertext link Help me set up recovery actions to open the Microsoft Management Console window for additional information. 3. Select actions for First failure, Second failure, Subsequent failures Take No Action Restart the Service Run a Program Restart the Computer 4. Set the number of days for Reset fail count after. 5. Set the number of minutes for Restart Service after. 6. Select Enable actions for stops with errors to enable restart computer options. 7. Choose Browse to select the appropriate program to run. 8. Enter parameters in Command line parameters. 9. Choose whether to Append fail count to end of command line. 10. Click Apply when all service properties are configured ARGUS Software, Inc.

59 Dependencies Tab 1. Click Dependencies to review any system component dependencies that may be associated with the ARGUS Enterprise 11.0 Application Service. 2. Navigate back to the General tab, and click Start to start the service if it is not already started. 3. Click OK to close the Service Properties window. 4. Repeat these steps for each installed Server: AE 11.0 Process Service AE 11.0 Data Service (if installed) ARGUS Software, Inc.

60 Change Installation Change, Repair, or Remove Installation You can change installed features in the current installation. 1. Navigate to the location of the installation program, and double click the file to launch the installer. 2. Click Next to launch the Setup Wizard. 3. Select Change to alter the way that features are installed ARGUS Software, Inc.

61 4. The Custom Setup window allows you to choose specific software components and a location for installation. Select only the ARGUS Enterprise server you wish to install (e.g., the application service, the process service, or the data integration service). Click Browse to change the installation path or to install one or more of the services on a different drive. To remove a component from installation, deselect the component. Click Next to continue. Note: Some administrators also install clients (e.g., Excel 4 ADW, Enterprise Client) if they want to test directly on this same server. 5. Click Install to make your changes ARGUS Software, Inc.

62 6. Wait as the Setup Wizard repairs ARGUS Enterprise Click Finish to complete this process ARGUS Software, Inc.

63 Repair Installation You can fix missing or corrupt files from the current installation. 1. Navigate to the location of the installation program and double click the file to launch the installer. 2. Click Next to launch the Setup Wizard. 3. Select Repair to alter the way that features are installed. You can also click Back to return to the previous window or Cancel to stop this process ARGUS Software, Inc.

64 4. Wait while the Setup Wizard repairs ARGUS Enterprise You can also click Cancel to stop this process. 5. Click Finish to complete this process ARGUS Software, Inc.

65 Remove Installation You can remove the current installation. 1. Navigate to the location of the installation program and double click the file to launch the installer. 2. Click Next to launch the Setup Wizard. 3. Select Remove to remove ARGUS Enterprise from your computer. You can also click Back to return to the previous window or Cancel to stop this process ARGUS Software, Inc.

66 4. Click Remove to completely remove ARGUS Enterprise 11.0 from your computer. You can also click Back to return to the previous window or Cancel to stop this process. 5. Wait while the Setup Wizard removes ARGUS Enterprise ARGUS Software, Inc.