Asta Development. Product Installation Guide

Transcription

1 Asta Development Product Installation Guide Asta Development plc Kingston House Goodsons Mews Wellington Street Thame Oxfordshire OX9 3BX United Kingdom Tel: +44 (0) Fax: +44 (0)

2 Trademarks Asta Powerproject is a registered trademark of Asta Development plc. ios is a trademark or registered trademark of Cisco in the United States and other countries. Android is a trademark of Google Inc. Microsoft, ActiveX, Active Directory, SQL Server, Terminal Server, Windows and Windows PowerShell are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Citrix is a registered trademark or trademark of Citrix Systems Inc in the United States and/or other countries. Wi-Fi is a registered trademark of Wi-Fi Alliance Asta Group Ltd

3 Table of Contents Table of Contents Overview of this document Notes on operating systems and database types Installing the Asta Powerproject Enterprise system Creating a Microsoft SQL Server database Creating a Microsoft SQL Server database user Specifying the Microsoft SQL Server authentication mode Installing Asta Powerproject Enterprise Installing the Asta Name Server and the Enterprise server to run as services Installing the Asta Name Server to run as a service Installing the Enterprise server to run as a service Configuring the Asta Name Server and Enterprise server services Configuring Asta Powerproject Enterprise registry settings Specifying whether baselines are pre-mounted completely Specifying whether projects are recalculated at mount time Specifying database timeout settings Installing an Oracle driver Creating a data source in Asta Serveradmin Configuring Asta Powerproject Enterprise using Asta Serveradmin Specifying the server location method in Asta Serveradmin Specifying the server temporary folder Specifying the audit logs folder and enabling audit logging Enabling users to log in automatically using Active Directory Configuring firewalls to work with Asta Powerproject Enterprise Setting firewall rules for the Asta Name Server and Enterprise server Setting firewall rules for specific ports Installing an Asta licence server and Asta Licence Manager Choosing a computer on which to install an Asta licence server Installing the Asta Licence Manager application Obtaining your licences from Asta Development Configuring Asta licensing in a Windows domain environment Configuring Asta licensing in a Windows workgroup environment Configuring the Asta licence server machine Mirroring Windows user account details for each Asta user Configuring firewalls to work with the Asta licence server Installing the Asta Powerproject client application Preliminary steps if installing onto a Terminal Server or Citrix server Asta Group Ltd

4 4.2 Installing an Asta Powerproject Enterprise client Activating the Asta Powerproject client application Activating Asta Powerproject using a named user licence Activating Asta Powerproject using a concurrent licence Configuring file locations in the Asta Powerproject client Specifying the server location method in the Asta Powerproject client Checking that the client can connect to the Enterprise server Additional steps if installing onto a Terminal Server or Citrix server Specifying that projects and their baselines should be pre-mounted Installing Asta Archive Manager Installing the latest version of Asta Powerproject Enterprise Configuring your Asta services to work with Asta Archive Manager Installing the Asta Archive Manager application Setting up proxy exceptions for the archiving web services Configuring Windows to enable the use of distributed transactions Configuring the distributed transaction timeout setting Installing Time Sheet for Asta Powerproject Installing and configuring Microsoft Internet Information Services Configuring Windows to allow ASP pages to run Installing necessary role services for the Web Server (IIS) Installing the Asta Developers Toolkit Creating a Microsoft SQL Server database for use with Time Sheet Creating a Microsoft SQL Server database user Installing Time Sheet Registering Time Sheet with Microsoft Internet Information Services Additional configuration in Internet Information Services version Creating an application pool for Time Sheet Specifying the server location method in the Asta Developers Toolkit Noting server and project information and mounting projects Creating tables in the Time Sheet database Granting the IIS_IUSRS user full control over Time Sheet configuration files Enabling Time Sheet to connect to the database Registering the project(s) to be used with Time Sheet Updating Asta Powerproject with the Time Sheet connection string Configuring the Time Sheet mail agent service Verifying that Time Sheet has been installed correctly Configuring Time Sheet s settings Accessing the Time Sheet login pages Asta Group Ltd

5 6.22 Notes on running Time Sheet Installing Web Access for Asta Powerproject Installing and configuring Microsoft Internet Information Services Configuring Windows to allow ASP pages to run Installing necessary role services for the Web Server (IIS) Installing the Asta Developers Toolkit Installing Web Access Additional configuration in Internet Information Services version Creating an application pool for Web Access Specifying the server location method in the Asta Developers Toolkit Noting server and project information and mounting projects Granting the IIS_IUSRS user full control over Web Access configuration files Registering the project(s) to be used with Web Access Verifying that Web Access has been installed correctly Configuring Web Access s settings Accessing the Web Access login page Installing Site Progress for Asta Powerproject Installing the Asta Developers Toolkit Specifying the server location method in the Asta Developers Toolkit Installing the Site Progress Manager application Entering your company details into Site Progress Manager Configuring Site Progress Manager Configuring projects for use with Site Progress Create a code library for Site Progress users Configure tasks to make them appear in the Ticksheet screen Configure tasks to make them appear in the Turnaround screen Recording details of Site Progress users Recording details of your projects in Site Progress Manager Associating users with their tasks within projects Downloading Site Progress Mobile onto mobile devices Installing Business Intelligence for Asta Powerproject Installing the Asta Developers Toolkit Specifying the server location method in the Asta Developers Toolkit Installing Business Intelligence Creating the Asta_Reporter database Configuring Business Intelligence Upgrading an Asta Powerproject Enterprise installation to the latest version Stopping the Asta Name Server and Enterprise server services Asta Group Ltd

6 10.2 Installing the latest version of Asta Powerproject Enterprise Installing the latest version of Asta Developers Toolkit Creating a new database for the new version of the software Configuring a Microsoft SQL Server database user to be the database owner Creating a new data source that connects to the new database Converting data from the old data source into the new data source Specifying that the projects in the new data source should be pre-mounted Unregistering the old data source Installing the latest version of the Asta Powerproject Enterprise client Upgrading an existing Asta Archive Manager installation to the latest version Uninstalling the existing Asta Archive Components Installing the latest version of Asta Powerproject Enterprise Installing the latest version of the Asta Archive Manager application Upgrading an existing Time Sheet installation to the latest version Copying your existing Time Sheet configuration files Uninstalling the existing Time Sheet software Installing the latest version of Time Sheet Checking that the IIS_IUSRS user still has full control over configuration files Merging existing configuration settings into the new version Upgrading the Time Sheet database Re-registering your Asta Powerproject project(s) in Time Sheet Upgrading an existing Web Access installation to the latest version Copying your existing Web Access configuration file Uninstalling the existing Web Access software Installing the latest version of Web Access Checking that the IIS_IUSRS user still has full control over configuration files Implementing existing configuration settings in the new version Re-registering your Asta Powerproject project(s) in Web Access Moving Asta Powerproject Enterprise to a different server machine Installing Asta Powerproject Enterprise onto the new server machine Installing the Asta Name Server and the Enterprise server to run as services Configuring the Asta Name Server and Enterprise server services Configuring Asta Powerproject Enterprise registry settings Re-registering a data source in Asta Serveradmin Configuring Asta Powerproject Enterprise using Asta Serveradmin Configuring firewalls to work with Asta Powerproject Enterprise Asta Group Ltd

7 1 Overview of this document This document describes how to install the Asta Powerproject Enterprise system and the following companion products: Asta Licence Manager. Asta Archive Manager. Time Sheet for Asta Powerproject. Web Access for Asta Powerproject. Site Progress for Asta Powerproject. Business Intelligence for Asta Powerproject. As well as describing the installation process for each product, this document describes any additional steps that you must take in order for the installation to be successful. For example, if you need to create a database to use with the product, this document describes the necessary steps. This document also describes how to upgrade existing installations of Asta s software to the latest version and how to move an installation of Asta Powerproject Enterprise from one server machine to another. 1.1 Notes on operating systems and database types The instructions in this document assume that you are installing Asta Powerproject Enterprise and its companion products onto a server machine that is running the Microsoft Windows 2012 Server operating system and that you are using Microsoft SQL Server 2012 Express to create and manage your databases. It is possible to use other operating systems and other types of database. Where instructions differ between operating systems, this document outlines the different steps that you must take. If you choose to use a different type of database, you will need to identify and carry out the equivalent steps in the database management application that you are using. The instructions in this document that involve working with Microsoft SQL Server describe one possible way of working, not the only way of working. For example, the instructions in sections 2.1, Creating a Microsoft SQL Server database and 2.2, Creating a Microsoft SQL Server database user, describe one possible way of creating a database and a user to administer the database. It is important to note that while these instructions will achieve the desired result, the protocols in place in your own organisation may mean that you will need to follow slightly different procedures. For example, you may want to use an existing user to administer the database, or your Microsoft SQL Server password policies may necessitate a different approach to the one described here. Before carrying out the steps in this document to install an item of Asta software, refer to the Asta Powerproject Enterprise Overview and System Requirements Guide for details of the hardware and software that must be in place prior to installation. If any of the required software listed in that document is not already installed on the computer on which you want to install an item of Asta software, install it before proceeding with the instructions in this guide Asta Group Ltd

8 2014 Asta Group Ltd

9 2 Installing the Asta Powerproject Enterprise system This section of the document describes how to install the Asta Powerproject Enterprise system, including the additional steps that you need to take in order to create a database for use with Asta Powerproject Enterprise. The installation of the Asta Powerproject Enterprise system comprises the following steps: Creating a Microsoft SQL Server database. Creating a Microsoft SQL Server database user. Specifying the Microsoft SQL Server authentication mode. Installing Asta Powerproject Enterprise. Installing the Asta Name Server and the Enterprise server to run as services. Configuring the Asta Name Server and Enterprise server services. Configuring Asta Powerproject Enterprise registry settings. Installing an Oracle driver. Creating a data source in Asta Serveradmin. Configuring Asta Powerproject Enterprise using Asta Serveradmin. Configuring firewalls to work with Asta Powerproject Enterprise. 2.1 Creating a Microsoft SQL Server database Before you install the Asta Powerproject Enterprise system, you must create a database in which to store the Asta Powerproject data. To create a Microsoft SQL Server database: 1. On the server machine on which Microsoft SQL Server is installed, launch the Microsoft SQL Server Management Studio and connect to your server. 2. Within the SQL Server Management Studio, right-click the Databases folder in the Object Explorer and select New Database: The New Database dialog appears. 3. On the General page of the dialog, in the Database name field, enter a suitable name for the database, as illustrated below: 4. There is no need to change any of the default settings for this database; click OK to create it Asta Group Ltd

10 All of your Asta Powerproject Enterprise data will be stored in this database. For this reason, you must ensure that the database is backed up regularly, preferably as part of an automatically-scheduled backup process. Some database backup mechanisms take the database offline temporarily while the backup is in process. If this is the case with your backup mechanism, you must stop the Enterprise server service before the database is taken offline, then restart it once the backup is complete. By default, Microsoft SQL Server 2012 Express places the database files that must be backed up in the following location: C:\Program Files\Microsoft SQL Server\MSSQL11.SQLEXPRESS\MSSQL\DATA\ By default, it places backup files in the following location: C:\Program Files\Microsoft SQL Server\MSSQL11.SQLEXPRESS\MSSQL\BACKUP\ Depending on the type and version of database that you are using, and the way in which the database software has been installed onto your server machine, these locations may be different for you. 2.2 Creating a Microsoft SQL Server database user Once you have created the Microsoft SQL Server database, you must create a new user to access it. To create a Microsoft SQL Server user: 1. Within the Microsoft SQL Server Management Studio Object Explorer, expand the Security folder, right-click the Logins folder and select New Login: The Login New dialog appears. 2. On the General page of the dialog, in the Login name field, enter a suitable name for the user, for example Asta. 3. Click the SQL Server authentication radio button. A number of fields below this radio button become available. 4. Enter a password for the user in the Password field, then re-enter it in the Confirm password field. 5. Clear the Enforce password policy check box: 6. In the Default database field, select the database that you have created: 2014 Asta Group Ltd

11 7. In the Select a page section of the dialog, click Server Roles. 8. On the Server Roles page of the dialog, select the bulkadmin check box: 9. In the Select a page section of the dialog, click User Mapping. 10. On the User Mapping page of the dialog, in the Users mapped to this login group, select the check box to the left of the database that you have created: 11. The name of your database should now be appended to the title of the Database role membership role for group. In this group, select the db_owner check box: 12. Click OK. It is necessary to assign the bulkadmin server role to the database user in order to create data sources in Asta Serveradmin that use the optimise transaction data facility (see section 2.9, Creating a data source in Asta Serveradmin for details). If you are using an Oracle database rather than Microsoft SQL Server, you must ensure that you create a database user with sufficient privileges to use the SQL*LOADER database utility. This can be achieved by giving the user the role of CONNECT (Default) and DBA (Admin and default). 2.3 Specifying the Microsoft SQL Server authentication mode In order for Asta Powerproject Enterprise to work with Microsoft SQL Server, you must set the server authentication mode to SQL Server and Windows Authentication mode. To set the server authentication mode: 1. At the top of the Microsoft SQL Server Management Studio Object Explorer, rightclick the SQL server and select Properties: 2014 Asta Group Ltd

12 The Server Properties dialog appears. 2. In the Select a page section of the dialog, click Security. 3. On the Security page of the dialog, click the SQL Server and Windows Authentication mode radio button: 4. Click OK. 2.4 Installing Asta Powerproject Enterprise Now that you have created your database and a user in Microsoft SQL Server, you can install Asta Powerproject Enterprise. You can install Asta Powerproject Enterprise onto the server machine on which your database is located, or onto another server machine. The instructions in this document assume that you are installing it onto the server machine on which your database is located. The Asta Powerproject Enterprise installation routine installs the following applications: Asta Enterprise server an application that controls access to data sources (eg the database that you created earlier) and enables more than one user to access data sources simultaneously. Asta Name Server an application that holds details of all of the Enterprise servers that are currently running. The name server publishes details of these Enterprise servers to the Asta Powerproject client applications, without the clients having to connect to the servers individually. Asta Serveradmin a server administration utility. Controller an application that you use to operate the Enterprise server using a command prompt Asta Group Ltd

13 All of these applications are available on the Windows Start screen once you have installed Asta Powerproject Enterprise. To install Asta Powerproject Enterprise: 1. Log into the server machine as a user with Administrator privileges. 2. Insert the Asta Powerproject Enterprise installation CD into the server s CD drive. 3. Browse the CD in Windows Explorer and locate the setup.exe file. If you have downloaded the installation files for Asta Powerproject Enterprise, setup.exe will be located in the folder into which you unzipped the installation files, not on a CD. 4. Right-click the setup.exe file and select Run as administrator from the menu that appears. 5. Follow the steps in the installation wizard to install Asta Powerproject Enterprise, clicking Next to move between the various screens of the wizard. If Microsoft.NET Framework 4 is not present on the server machine, the installation wizard will install it automatically. The installation of.net Framework 4 will take some time and may require you to reboot the server machine; if so, the Asta Powerproject installation wizard will carry on automatically after the reboot. 6. Enter your user name, the name of your organisation and your Asta Powerproject Enterprise serial number in the fields on the following screen: Asta Powerproject Enterprise is installed into the following folder by default: C:\Program Files\Asta\Asta Powerproject enterprise\ (32-bit systems). C:\Program Files(x86)\Asta\Asta Powerproject enterprise\ (64-bit systems). 7. If you want to install Asta Powerproject Enterprise to a location other than the default, click the Custom radio button on the following screen, which will give you access to an additional page of the wizard in which you can specify an installation folder: 2014 Asta Group Ltd

14 8. On the above screen, leave the Install server as a service check box cleared. Although you can use this check box to install the server as a service automatically, it is preferable to install the server as a service manually after the initial installation following the steps in the next section of this document as this gives you the ability to configure the name of the service, as well as a number of other variables. 9. Click Install on the final screen of the wizard to install Asta Powerproject Enterprise. 10. When the installation routine is complete, click Finish to exit the wizard. 11. Reboot the server machine on which you have installed Asta Powerproject Enterprise. 2.5 Installing the Asta Name Server and the Enterprise server to run as services Now that you have installed Asta Powerproject Enterprise, you can install the Enterprise server (AstaEnterprise.exe) and the Asta Name Server (AstaNameServer.exe) to run as services, so that they are loaded automatically when Windows starts and run in the background. You should install the Asta Name Server as a service first, followed by the Enterprise server Installing the Asta Name Server to run as a service To install the Asta Name Server to run as a service: 1. On the server machine on which you have installed Asta Powerproject Enterprise, launch a command prompt, ensuring that you run it as Administrator. A command prompt window appears: 2. In the command prompt window, change the directory location to the folder in which Asta Powerproject Enterprise has been installed, which is, by default: 2014 Asta Group Ltd

15 C:\Program Files\Asta\Asta Powerproject enterprise\ (32-bit systems). C:\Program Files(x86)\Asta\Asta Powerproject enterprise\ (64-bit systems). 3. Type AstaNameServer.exe install and press ENTER. You see a confirmation that the service has been installed successfully: If you are planning to use Asta Archive Manager to archive historic data from your projects, instead of entering AstaNameServer.exe install, enter AstaNameServer.exe web install. This turns on web services that Asta Archive Manager requires to operate Installing the Enterprise server to run as a service You can install the Enterprise server to run as a service in a number of ways, each of which is described below. Choose the way that best fits the manner in which you want to use Asta Powerproject Enterprise and follow the instructions in that section. If you are not carrying on directly from the previous section, start by launching a command prompt on the server machine on which you have installed Asta Powerproject Enterprise, ensuring that you run it as Administrator, then change the directory location to the folder in which Asta Powerproject Enterprise has been installed (as described in the previous section). As with the installation of the Asta Name Server, if you are planning to use Asta Archive Manager to archive historic data from your projects, add web to whichever command you use to install the Enterprise server, to turn on web services that Asta Archive Manager requires to operate Installing the Enterprise server to run as a standard service If you install the Enterprise server to run as a standard service, it runs as a service with a name of <user name>_<machine name>, where <user name> is the name of the person who has logged onto the server machine and <machine name> is the name of the server machine itself. For example, if user JSMITH has logged onto a server machine called MAINSRV, the Enterprise server is run as a service on this machine with a name of JSMITH_MAINSRV. To install the Enterprise server to run as a standard service, enter the following at the command prompt: AstaEnterprise.exe install Installing the Enterprise server to run as a service with a specific name To install the Enterprise server to run as a service with a specific name, enter the following at the command prompt: AstaEnterprise.exe install <server name> Where <server name> is the name with which you want the service to run. The name must be a single word, with no spaces or punctuation. For example, to install the Enterprise server as a service so that it runs with the name AstaServer, enter: AstaEnterprise.exe install AstaServer 2014 Asta Group Ltd

16 Installing the Enterprise server to run as a service with a specific identification number and name If you want to enable users to log in automatically using Active Directory, you must install the Enterprise server with a specific identification number and name. To install the Enterprise server to run as a service with a specific identification number and name, enter the following at the command prompt: AstaEnterprise.exe -server_id <server identification number> install <server name> Where <server identification number> is the number with which you want to identify the server and <server name> is the name with which you want the service to run. For example, to install the Enterprise server as a service so that it runs with the server identification number 1 and the name AstaProjectServer, enter: AstaEnterprise.exe -server_id 1 install AstaProjectServer Installing multiple Enterprise servers to run as services If you want to run more than one Enterprise server on a server machine, you must install each one with a specific identification number and name, as described in the previous section. For example, you could enter the following commands at the command prompt to install two Enterprise servers to run as services: AstaEnterprise.exe -server_id 1 install AstaServer1 AstaEnterprise.exe -server_id 2 install AstaServer Installing the Enterprise server to run as a service with specific dependencies Depending on which other services are installed on the server machine, you may experience problems in the following circumstances: If a service that is required for the Enterprise server or one of its components to operate does not run. If a service that prevents the Enterprise server or one of its components from operating does run. In particular, if you install the server to run as a service onto a server machine on which Oracle is installed, it is made dependent on all Oracle services (all services beginning with Ora ) by default. As well as potentially causing problems, this can degrade performance. You may want to install the Enterprise server to run as a service, while specifying the services on which it is dependent. To install the Enterprise server to run as a service and specify the services on which it is dependent, enter the following at the command prompt: AstaEnterprise.exe depend <dependencies> install Where <dependencies> is a comma-separated list of the services on which the service is dependent. For example, you could enter the following command at the command prompt to install the Enterprise server as a service that is dependent on the OracleServiceTEAMPLAN and MSSQLSERVER services: AstaEnterprise.exe depend OracleServiceTEAMPLAN,MSSQLSERVER install To incorporate a server identification number and server name into such a command, enter the following at the command prompt: AstaEnterprise.exe depend <dependencies> -server_id <server identification number> install <server name> 2014 Asta Group Ltd

17 For example, to install the Enterprise server as a service that is dependent on the MSSQLSERVER service and so that it runs with the server identification number 1 and the name AstaProjectServer, enter: AstaEnterprise.exe depend MSSQLSERVER -server_id 1 install AstaProjectServer 2.6 Configuring the Asta Name Server and Enterprise server services Once you have installed the Asta Name Server and Enterprise server to run as services, they appear in the list of services in Windows Control Panel. Initially, both services are set to be started manually. You must configure the services to start automatically. To configure the Asta Name Server and Enterprise server services: 1. On the server machine on which you have installed Asta Powerproject Enterprise, launch Control Panel. 2. Within Control Panel, select System and Security, then Administrative Tools. The Administrative Tools window appears. 3. Double-click the Services administrative tool. The Services window appears: 4. Locate the Asta Name Server and Asta Powerproject Enterprise Server services in the list (highlighted in the above illustration). If you have installed more than one Enterprise server to run as a service, a separate service will appear in the list for each Enterprise server. 5. Double-click one of the Asta services. The service s Properties dialog appears. 6. On the General tab of the dialog, select Automatic in the Startup type field: 7. Click OK to close the dialog Asta Group Ltd

18 8. Double-click the next Asta service in the list of services and repeat steps 6 and 7 to configure this service in the same way as the first. 9. If there are further Asta services in the list, configure these in the same way. 2.7 Configuring Asta Powerproject Enterprise registry settings There are a number of registry settings that affect the way in which Asta Powerproject Enterprise operates. Follow the instructions in this section to configure the registry settings in a way that suits your preferences Specifying whether baselines are pre-mounted completely Once you have created one or more projects in the Asta Powerproject Enterprise system, it is recommended that you specify that the projects and their baselines should be premounted each time the Enterprise server starts (see section 4.8, Specifying that projects and their baselines should be pre-mounted, for more details). This is in order to speed up the mounting of projects and baselines, to reduce the usage of memory when projects are mounted and to prevent projects from being dismounted automatically when all users have finished working with them. However, some users prefer to maintain a slightly longer mounting process, as this can mean that the runtime performance of the Enterprise server is improved. You can use a registry key to specify whether baselines are pre-mounted completely when the Enterprise server starts, or whether only key (index) fields are mounted into memory, thereby reducing the amount of time taken to pre-mount baselines. To specify whether baselines should be pre-mounted completely when the Enterprise server starts: 1. On the server machine on which you have installed Asta Powerproject Enterprise, launch Registry Editor. 2. In the left pane of Registry Editor, expand the registry to the following branch: HKEY_LOCAL_MACHINE\SOFTWARE\ASTA\PowerProject Teamplan\1.0\ DataSourceMount\ (32-bit systems). HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432node\Asta\PowerProject Teamplan\1.0\DataSourceMount\ (64-bit systems). 3. In the right pane of Registry Editor, locate the KeyFieldsOnly registry key. This key determines whether or not baselines that are set to be pre-mounted are mounted completely, or whether only key (index) fields are mounted into memory, thereby reducing the amount of time taken to mount baselines. The default, recommended value for this key is 2, which means that only key fields are mounted. 4. If you want to specify that baselines should be pre-mounted completely, edit the properties of this key and set its value to 0: 2014 Asta Group Ltd

19 Although changing the behaviour in this way results in longer mounting times and greater memory usage, it also results in faster baseline updates, as baseline data does not have to be read into memory as and when it is required Specifying whether projects are recalculated at mount time If you experience a server problem or crash that prevents associated objects from being updated in line with each other, associated values can become mismatched. For example, a link may become detached from one of the tasks it is supposed to link. You can use a registry key to specify whether or not the Enterprise server recalculates projects and baselines at mount time, to check that all associated values match up with each other. Recalculating projects and baselines as they are mounted solves any such problems, but it also results in longer mounting times. To specify whether projects and baselines are recalculated at mount time: 1. On the server machine on which you have installed Asta Powerproject Enterprise, launch Registry Editor. 2. In the left pane of Registry Editor, expand the registry to the following branch: HKEY_LOCAL_MACHINE\SOFTWARE\ASTA\PowerProject Teamplan\1.0\ DataSourceMount\ (32-bit systems). HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432node\Asta\PowerProject Teamplan\1.0\DataSourceMount\ (64-bit systems). 3. In the right pane of Registry Editor, locate the RecalcOnMount registry key. This key determines whether or not projects and baselines are recalculated at mount time. The default value for this key is 1, which means that projects and baselines are recalculated at mount time. 4. To specify that projects and baselines should not be recalculated at mount time, edit the properties of this key and set its value to 1. Although changing the behaviour in this way results in shorter mounting times, it may lead to problems that result from mismatched associated values Specifying database timeout settings You can use the following registry keys to specify how long the Enterprise server should wait for responses from your database: 2014 Asta Group Ltd

20 Use the ConnectionTimeout key to specify how long the Enterprise server should wait for a response from the database when connecting to it initially. If the value (in seconds) is exceeded, the Enterprise server assumes that the database is not available. Use the CommandTimeout key to specify how long the Enterprise server should wait for confirmation that a command that has been submitted to the database has been completed successfully. If the value (in seconds) is exceeded, the Enterprise server assumes that the command has failed. To specify database timeout settings: 1. On the server machine on which you have installed Asta Powerproject Enterprise, launch Registry Editor. 2. In the left pane of Registry Editor, expand the registry to the following branch: HKEY_LOCAL_MACHINE\SOFTWARE\ASTA\PowerProject Teamplan\1.0\ EntSrv\ (32-bit systems). HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432node\Asta\PowerProject Teamplan\1.0\EntSrv\ (64-bit systems). 3. In the right pane of Registry Editor, locate the ConnectionTimeout and CommandTimeout registry keys. 4. To specify different timeout settings, edit the properties of the keys and set their values to the required number of seconds. You may find that longer timeout values work better if you are working with extremely large volumes of data. 2.8 Installing an Oracle driver If you are using an Oracle database rather than Microsoft SQL Server, you must install a contemporary version of the Oracle Data Access Components for Oracle Client (ODAC) driver onto the server machine on which you have installed the Enterprise server. This driver must be installed in addition to the standard Oracle client software that is required in order to connect an Enterprise server to an Oracle data source. The earliest version of the driver that you must install is ODAC 11.2 Release 3 and Oracle Developer Tools for Visual Studio ( ) ; you can install a later version of this driver. The driver is freely available, with installation instructions, on Oracle s website. 2.9 Creating a data source in Asta Serveradmin You created a database when following the steps in section 2.1, Creating a Microsoft SQL Server database. You now need to create a corresponding data source in Asta Serveradmin, the application that you use to administer the Enterprises server. To create a data source in Asta Serveradmin: 1. On the server machine on which you have installed Asta Powerproject Enterprise, launch Asta Serveradmin. 1. Select the New command from the Datasource menu. The New Datasource wizard appears. 2. On the first screen of the wizard, click the Datasource direct connection radio button: 2014 Asta Group Ltd

21 3. Click Next. 4. On the second screen of the wizard, enter a suitable name and description for the data source in the Name and Description fields; it is a good idea to give the data source a description that describes the projects that it will contain. 5. If you have installed more than one Enterprise server on the server machine or if you want to enable users to log in automatically via Active Directory, enter a positive integer that links the data source to a particular server in the Server identification number field: If you only use a single server and you are not using Active Directory to enable automatic login, you can leave this number set to 1. You can make a data source inaccessible to all servers (ie take it offline), by setting this number to zero. 6. Click Next. 7. On the third screen of the wizard, click Build to access the Connection String Generation wizard, which you can use to create the ActiveX Data Objects (ADO) connection string that specifies the database provider and the data source to which the Enterprise server should connect. 8. On the first screen of the wizard, click the Microsoft SQL Server database radio button: 9. Click Next Asta Group Ltd

22 10. On the second screen of the wizard, enter the name of the server machine on which you created the Microsoft SQL Server database in the Please enter the name of the machine that is running SQL Server field, noting the following points: If you are using Microsoft SQL Server 2012 Express, enter <server machine name>\sqlexpress, where <server machine name> is the name of the server machine. For example, if the server machine is called Server1, enter Server1\SQLExpress. If you are using Microsoft SQL Server 2012 Express and you have installed Asta Powerproject Enterprise onto the server machine on which your database is located, enter.\sqlexpress. If you are using a version of Microsoft SQL Server 2012 other than Express, simply enter the name of the server machine. For example, if the server machine is called Server1, enter Server Enter the name that you applied to the Microsoft SQL Server database when you created it in section 2.1, Creating a Microsoft SQL Server database, in the Please enter the catalog (database) to use field: 12. Click Next. 13. On the third screen of the wizard, enter the user name and password of the Microsoft SQL Server user that you created in section 2.2, Creating a Microsoft SQL Server database user and leave the Use SSPI integrated security check box cleared; if you use Windows authentication (in which Microsoft SQL Server interrogates Windows and grants access only to user accounts that are specified by the database administrator), do not enter a user name and password, but select the Use SSPI integrated security check box: 14. Click Finish to close the Connection String Generation wizard and return to the New Datasource wizard, where a connection string containing the information you have provided appears in the Connection string field: 2014 Asta Group Ltd

23 15. Leaving the Optimise transaction data check box selected, select or clear the Server/database on same machine check box as appropriate depending on whether you have installed Asta Powerproject Enterprise on the server machine on which Microsoft SQL Server is installed. 16. If you have installed Asta Powerproject Enterprise onto a different server machine, create a folder on the server machine on which Microsoft SQL Server is installed and give the user account that is being used to run the Asta Powerproject Enterprise server Full Control access rights to the folder. Temporary files will be stored in this folder. You must then specify the location of the folder in the Server/database shared folder field, in the format \\<server name\<path and folder name>. For example, if the server machine is called Server1 and the folder is on the root of the server and called AstaTemp, enter \\Server1\AstaTemp. 17. Click Test to test that the connection to the database works correctly. A message appears informing you whether or not the connection string is valid. If the connection string is not valid, double-check the details of the database and user that you created, then create the connection string again. 18. Click Finish to close the New Datasource wizard. The new data source is created and appears in Asta Serveradmin: 2.10 Configuring Asta Powerproject Enterprise using Asta Serveradmin Once you have created a data source, you must follow the instructions in this section to use Asta Serveradmin to configure Asta Powerproject Enterprise. If the Enterprise server service is currently running, stop it before carrying out the steps described in this section, then restart it once you have finished configuring Asta Powerproject Enterprise using Asta Serveradmin Specifying the server location method in Asta Serveradmin You must specify the way in which you want the Asta Powerproject clients to locate the Enterprise server(s) that you have installed. To specify the server location method: 1. Within Asta Serveradmin, select the Set Locator command from the Server menu. The Server Location Method dialog appears Asta Group Ltd

24 2. Select the Asta Name Server check box, then enter either the IP address or the server name of the server machine on which you have installed the Asta Name Server. 3. Enter the number of seconds after which you want the Enterprise server to time out when it tries to connect to the Asta Name Server in the Asta Name Server timeout field. 4. The Asta Name Server pings for Enterprise servers every 20 seconds to determine which are available. Enter the number of minutes after which an unavailable Enterprise server should be removed from the Asta Name Server s list of servers in the Contact server timeout field. As servers may be unavailable temporarily as a result of network problems, for example entering a suitable timeout such as 5 minutes means that a server that is only unavailable temporarily is not removed unnecessarily from the Asta Name Server s list. 5. Click OK Specifying the server temporary folder You must specify a folder on the server machine on which you have installed Asta Powerproject Enterprise into which the Enterprise server can store temporary files as it works. The server stores work-in-progress for the Asta Powerproject clients in order to be able to restore a client s work if the client crashes. As you can have more than one Enterprise server running on a server machine, the temporary files for each Enterprise server are stored in subfolders, each one unique to an Enterprise server, within the temporary folder you that you specify here. To specify the server temporary folder: 1. Within Asta Serveradmin, select the Set Temporary Folder command from the Server menu. The Browse For Folder dialog appears. 2. Select a folder on the server machine on which you have installed Asta Powerproject Enterprise in which to store temporary files; click Make New Folder to create a new folder at this point in time if a suitable folder does not already exist Asta Group Ltd

25 3. Click OK Specifying the audit logs folder and enabling audit logging You must specify a folder on the server machine on which you have installed Asta Powerproject Enterprise into which the Enterprise server can store audit logs as it works. The audit logs record which users perform which actions, the date and time on which the actions are performed, the applications that perform each action and the dates and times at which users log into and log out of projects. You can display audit logs from within Asta Serveradmin. If you have more than one data source, you can enable or disable audit logging for each one individually. Asta Serveradmin creates a subfolder for each data source for which audit logging is enabled. Every project in a data source has its own audit log file, <project name>.log, and its own usage log file, <project ID>_USAGE.LOG (where <project name> and <project ID> are the name and ID of the project respectively). Project audit logs continue to grow indefinitely, so if you edit a project regularly, you should delete the audit log files occasionally so that they do not take up too much disk space. To specify the audit logs folder: 1. Within Asta Serveradmin, select the Set Folder For Audit Logs command from the Server menu. The Browse For Folder dialog appears. 2. Select a folder on the server machine on which you have installed Asta Powerproject Enterprise in which to store audit logs; click Make New Folder to create a new folder at this point in time if a suitable folder does not already exist. 3. Click OK Asta Group Ltd

26 To enable audit logging for a data source: 1. Within Asta Serveradmin, select the data source for which you want to enable audit logging. 2. Select the Properties command from the Datasource menu. The Datasource Properties dialog appears. 3. Click the Auditing tab. 4. Select the Generate auditing log for datasource check box: 5. Click OK. 6. Repeat the above steps to enable audit logging for each data source Enabling users to log in automatically using Active Directory By default, users may have to enter their usernames and passwords once or twice to log in to a project in Asta Powerproject: Once to log in to the server (if there are server-level users defined). Once to log in to the project (if there are project-level users defined, and if the project-level username does not match the server-level username). Asta Powerproject Enterprise supports the Active Directory service, which catalogues information about all the objects on a network, including people, computers, and printers, and distributes that information throughout the network. Security is integrated with Active Directory through login authentication and access control. If you use Active Directory to manage the users on your network, you can configure Asta Powerproject Enterprise to allow users to log into servers and projects automatically, using the security and access control provided by Active Directory. This means that users do not have to enter user names and passwords when they log into their projects. To enable users to log in automatically using Active Directory: 1. Structure your users within Active Directory so that they belong to security groups which can be associated with specific Enterprise servers. For example, if you want one set of users (A) to have access to the data sources associated with server 1 and another set of users (B) to have access to the data sources associated with server 2, structure your Active Directory security groups so that the users belonging to set A are in one security group and the users belonging to set B are in another. 2. Associate each data source in Asta Serveradmin with a server identification number, so that when you link an Active Directory security group with a server identification number, the users within that security group will have access to the projects within the data sources that are associated with a particular server. Note that when using Active Directory to enable users to log in automatically, you must always start each Enterprise server with a unique name and identification number that corresponds to the server identification numbers you apply to your data sources. 3. Within Asta Serveradmin, select the Set Auto Login Information command from the Server menu. The List of Auto Login Information dialog appears: 2014 Asta Group Ltd

27 You use this dialog to specify the Active Directory security groups whose users you want to be able to log in automatically to each Enterprise server. 4. Click Add. The Add Active Directory Group dialog appears. 5. Select the domain on which the security group is located in the Domain field. The Active Directory security groups within the domain appear in the Group field, listed within their hierarchy. 6. Select the security group whose users you want to be able to log in automatically in the Group field. 7. Enter the identification number of the server to which you want the users of the selected security group to be able to log into automatically in the Server ID field. 8. Click OK to confirm your selection and return to the List of Auto Login Information dialog. 9. If you have more than one Enterprise server, follow steps 4 to 8 for each server. 10. Click OK to close the dialog. 11. Create projects within Asta Powerproject within the appropriate data sources. Within each of the projects, create project-level users that correspond precisely to the users that are defined within Active Directory. The user names of the users you create within your projects must be identical to the names of the corresponding user in Active Directory. 12. Within your Asta Powerproject projects, apply a unique password to each projectlevel user. The passwords, which do not have to correspond with anything within Active Directory, prevent users within the same security group from accessing projects using the user name of another user within the same security group. 13. Within your Asta Powerproject projects, select the Active Directory Filtering check box on the General tab of the Options dialog. 14. Within Asta Serveradmin, specify that the Asta Powerproject projects should be mounted each time the Enterprise server(s) starts (see section 4.8, Specifying that projects and their baselines should be pre-mounted, for details of how to do this). 15. Users within the selected security group can now log in automatically to the projects within the data sources that are associated with the specified Enterprise server. Note that you can select up to four separate security groups per server identification number, enabling their users to log in automatically. Although Asta Serveradmin contains additional configuration options, you have now completed the basic tasks that are required to configure Asta Powerproject Enterprise. Restart the Enterprise server service before continuing Asta Group Ltd