Microsoft Dynamics CRM 2011 Implementation Guide Installing
Microsoft Dynamics CRM 2011 Implementation Guide Installing
5.0.0
Copyright
This document is provided "as-is". Information and views expressed in this document, including URL and other Internet Web site references, may change without notice. You bear the risk of using it. Some examples depicted herein are provided for illustration only and are fictitious. No real association or connection is intended or should be inferred. This document does not provide you with any legal rights to any intellectual property in any Microsoft product. You may copy and use this document for your internal, reference purposes. 2010 Microsoft Corporation. All rights reserved. Microsoft, Active Directory, Excel, Hyper-V, Internet Explorer, Microsoft Dynamics, Microsoft Dynamics logo, MSDN, Outlook, Notepad, SharePoint, Silverlight, Visual C++, Windows, Windows Azure, Windows Live, Windows PowerShell, Windows Server, and Windows Vista are trademarks of the Microsoft group of companies. All other trademarks are property of their respective owners.
Table of Contents
Copyright ....................................................................................................................... 2 Overview ........................................................................................................................ 3
Microsoft Dynamics CRM editions and licensing ..................................................................................... 3
Microsoft Dynamics CRM E-mail Router Installation Instructions .......................... 32 Microsoft Dynamics CRM for Outlook Installation Instructions .............................. 32 Language Pack Installation Instructions ................................................................... 33
Overview -- Language Pack Installation ................................................................................................ 33 Install and deploy a Language Pack ...................................................................................................... 33 Step1: Install the Language Pack in the deployment ........................................................................ 33 Step 2: Provision the Language Pack in your Microsoft Dynamics CRM deployment ..................... 34 Step 3: Select the language to display the user interface and help .................................................. 34 Upgrade and deploy a Language Pack .................................................................................................. 35 Language Pack installation issues ......................................................................................................... 35 You receive a "Setup could not install Language Pack Name" error message ................................ 35
Use the Command Prompt to Install Microsoft Dynamics CRM .............................. 43 Post-Installation and Configuration Guidelines ....................................................... 45
Make Microsoft Dynamics CRM client-to-server network communications more secure ...................... 45 Add or remove sample data ................................................................................................................... 46 Instructions for removing the Resource Center ..................................................................................... 46
ii
Chapter 1
Overview
This guide is part of the Microsoft Dynamics CRM Implementation Guide, which consists of the following three documents: Planning Guide: Use this guide to determine what you have to plan for Microsoft Dynamics CRM. It includes coverage in the following areas: Technical. These topics focus on supported topologies, system requirements, and technical considerations to address before installation. Implementation Methodology. Learn about the business management, system requirements, and project management aspects that are needed when you deploy a CRM system. In addition, there are several documents that you can use as tools to plan the implementation of Microsoft Dynamics CRM. These tools are available for download at Planning Tools (http://go.microsoft.com/fwlink/?LinkID=189326). Installing Guide: Use this guide to learn about how you install Microsoft Dynamics CRM applications. This guide includes step-by-step instructions for running Setup, command-line installation instructions, and guidance about how to remove Microsoft Dynamics CRM. Operating and Maintaining Guide: You can read this guide to learn how to back up, restore, and perform system recovery for Microsoft Dynamics CRM data. Also, this guide has troubleshooting steps for known issues.
In This Chapter
Microsoft Dynamics CRM editions and licensing.......................................................................... 3 ..................................................................................................................................................... 4
Editions
Microsoft Dynamics CRM 2011 Server. There is no user limit for this edition. Additional features include support for multiple organizations, multiple server instances, and separate role-based service installation. Role-based services let you increase performance by installing component services on different computers. Microsoft Dynamics CRM Workgroup Server 2011. This edition is limited to five, or fewer, users. This version is limited to a single organization and a single computer that is running Microsoft Dynamics CRM Server 2011.
Licensing
A Microsoft Dynamics CRM deployment operates by using a single product key. Microsoft Dynamics CRM 2011 does not require additional product keys to be added when changes are made, such as adding a client access license (CAL). The single product key contains the Microsoft Dynamics CRM version, server license, and the CALs. You can view and upgrade a license in Deployment Manager. Deployment Manager is a Microsoft Management Console (MMC) snap-in that system administrators can use to manage organizations, servers, and licenses for deployments of Microsoft Dynamics CRM.
3 Downloaded from www.sonomapartners.com
Chapter 1: Overview
Chapter 2
Microsoft Dynamics CRM Server 2011 Installation Instructions
This section explains how to install Microsoft Dynamics CRM Server 2011. In addition, there is installation troubleshooting information and procedures to uninstall Microsoft Dynamics CRM Server 2011. Important For up-to-date information, see the Microsoft Dynamics CRM Server 2011 Readme (see Readme - http://go.microsoft.com/fwlink/?LinkID=144915).
In This Chapter
Components installed during Microsoft Dynamics CRM Server Setup ........................................ 5 Microsoft Dynamics CRM Server 2011 installation ...................................................................... 8 Upgrade from Microsoft Dynamics CRM 4.0 .............................................................................. 14 Troubleshooting installation and upgrade .................................................................................. 21 Install Microsoft Dynamics CRM Server 2011 on multiple computers ....................................... 22 Install Microsoft Dynamics CRM Server 2011 to use a Microsoft SQL Server cluster environment ................................................................................................................................ 26 Configure an organization database for SQL Server 2008 database mirroring ......................... 29
Folder CRM\CRMWeb SystemDrive:\Program Files\Microsoft Dynamics CRM\CRMWeb\CRMReports The following Web components are added. Component Application Pool Name CRMAppPool
Description Microsoft Dynamics CRM Server Setup creates a separate application pool for the Microsoft Dynamics CRM application. Microsoft Dynamics CRM Server Setup creates a separate application pool for the Deployment Web Service.
Application Pool
CRMDeploymentService AppPool
Microsoft Dynamics CRM Web site for Microsoft Dynamics CRM. XRMDeployment Help Facilitates the implementation of xRM deployments. Services the Microsoft Dynamics CRM Help system for the application.
The following Active Directory groups are added. When the Active Directory domain is set to Native Mode, this group must be of the type Domain Local Security or Universal Security. Group PrivReportingGroup Description Privileged Microsoft Dynamics CRM user group for reporting functions. This group is created during Microsoft Dynamics CRM Server Setup and configured during Microsoft Dynamics CRM Reporting Extensions Setup. Privileged Microsoft Dynamics CRM user group for special administrative functions; including CRMAppPool identity (domain user or NetworkService). The users who configure Microsoft Dynamics CRM Server 2011 must be added to this group. All server processes/service accounts that require access to SQL Server; including CRMAppPool identity (domain user or NetworkService). Members of this group have db_owner permission on the Microsoft Dynamics CRM databases. All Microsoft Dynamics CRM users are included in this group. This group is updated automatically as users are added and removed from Microsoft Dynamics CRM. By default, all Microsoft Dynamics CRM Reporting Services reports grant Browse permission to this group.
PrivUserGroup
SQLAccessGroup
ReportingGroup
The following services are added. Service Microsoft Dynamics CRM Asynchronous Processing Description Services asynchronous processes such as bulk e-mail and workflow.
6
Service Service Microsoft Dynamics CRM Asynchronous Processing Service (maintenance) Microsoft Dynamics CRM Unzip Service
Description
Services asynchronous maintenance such as encryption key generation for authentication and database deletion clean up. Handles the uncompressing of zipped files for data import. This service is installed as part of the Web Application Server role.
The Sandbox Processing Service server role enables an Microsoft Dynamics CRM Sandbox Processing Service isolated environment to allow for the execution of custom code, such as plug-ins. The following SQL Server components are added. Component Databases Name MSCRM_CONFIG OrganizationName_MSC RM Description Microsoft SQL Server Setup creates the SystemDrive:\Program Files\Microsoft SQL Server\MSSQL<ver>\MSSQL\Data\ folder and Microsoft Dynamics CRM Server Setup installs the Microsoft Dynamics CRM configuration database and organization databases in it.
OrganizationName_MSC Microsoft Dynamics CRM Server Setup RM.CreateAuditPartition creates three SQL Server jobs that are used MSCRM_CONFIG.HardD for maintenance. elete MSCRM_CONFIG.SiteWi deCleanup PrivReportingGroup ReportingGroup SQLAccessGroup Microsoft Dynamics CRM Server Setup creates several SQL Server logins for the Active Directory groups that are created.
Logins
Windows Presentation Foundation Windows Communication Foundation (required by Microsoft Dynamics CRM Server 2011) Microsoft Chart Controls for Microsoft .NET Framework Windows Azure platform AppFabric SDK Windows PowerShell Microsoft URL Rewrite Module for IIS File Server Resource Manager
Install Microsoft Dynamics CRM 2011 Server on a server without Microsoft Dynamics CRM installed
To install the Microsoft Dynamics CRM Server 2011 software, follow these steps:
1. Meet all requirements specified in the "System Requirements and Required Components" section of this guide. 2. Log on to the domain as a user who has administrator-level privileges where Microsoft Dynamics CRM will be installed and who is a member of the Administrators group on the local computer. You cannot install the application as a member from a trusted domain. 3. See the Microsoft Dynamics CRM 2011 Server Readme (http://go.microsoft.com/fwlink/?linkid=144915) file to determine the location of the Microsoft Dynamics CRM installation files. 4. In the folder where the Microsoft Dynamics CRM files are located, move to the Server\amd64 folder, and then double-click SetupServer.exe. 5. On the Welcome to Microsoft Dynamics CRM Setup page, we recommend that you click Get updates for Microsoft Dynamics CRM, to make sure that Setup has the most recent installation files. Click Next. 6. On the Product Key Information page, type your product key in the Product key boxes, and then click Next. 7. On the License Agreement page, review the information and if you accept the license agreement, click I accept this license agreement, and then click I Accept. 8. If Setup detects that components are missing, the Install Required Components page appears. If you have already installed the required components, this page will not appear.
8
If you have not installed the required components listed, you can install them now. Click Install. When the components are installed, the status column will change from Not Installed to Installed, and you can click Next to continue. Note If you are prompted to restart the computer, do so, and then start Setup again. 9. On the Select Installation Location page, accept the default location or enter a different file installation location, and then click Next. 10. If you are installing Microsoft Dynamics CRM Server 2011, the Specify Server Roles page appears. By default, Full Server is selected and will install all server roles on the computer. Alternatively, you can select a predefined group of server roles or one or more individual server roles. Notice that all server roles must be deployed on the network in the same Active Directory domain for Microsoft Dynamics CRM to operate correctly. For more information, see "Planning Deployment" in the Microsoft Dynamics CRM 2011 Planning Guide. Click Next. Important When you select a server role other than Full Server, Microsoft Dynamics CRM Server Setup does not create an organization database during the installation. If the deployment does not have an organization database, you must use Deployment Manager to create a new organization. For information about how to create a new organization, see the Deployment Manager Help. 11. On the Specify Deployment Options page, if Setup detects an existing deployment, you can select whether you want to create a new deployment or connect to an existing deployment. In the Enter or select the name of the computer that is running SQL Server to use with the deployment box, type or select the instance of SQL Server that will be used to store the Microsoft Dynamics CRM database (MSCRM_CONFIG). Important When you select Create a new deployment, Setup creates a new organization database using the name that you specified and a configuration database by using the name MSCRM_CONFIG. An error message will appear if an MSCRM_CONFIG database already exists. You must delete this database to create a new MSCRM_CONFIG database. Only on deployment is supported for each instance of SQL Server. When you select Connect to, and if necessary, upgrade an existing deployment, Setup requires that a configuration database (MSCRM_CONFIG) already exist on the computer that is running SQL Server. An error message will appear if an MSCRM_CONFIG database does not already exist. 12. On the Select the Organizational Unit page, click Browse to display your Active Directory structure. Select the location where you want the Microsoft Dynamics CRM organizational unit to be installed into, click OK, and then click Next. Microsoft Dynamics CRM security groups are created in this organizational unit. 13. On the Specify Service Accounts page, select the security accounts for the Microsoft Dynamics CRM services, and then click Next. The services are described below. For more information, see Minimum permissions required for Microsoft Dynamics CRM Setup, service and components in the Planning Guide. Application Service. This service runs the Microsoft Dynamics CRM Web application that is used to connect users to CRM data. Deployment Web Service. Manages the deployment by using the methods described in the Microsoft Dynamics CRM 2011 Deployment Software Development Kit, such as create an organization or remove a Deployment Administrator role from a user. Sandbox Processing Service. Enables an isolated environment to allow for the execution of custom code, such as plug-ins. This isolated environment reduces the possibility of custom code affecting the operation of the organizations in the Microsoft Dynamics CRM deployment. Asynchronous Processing Service. Processes queued asynchronous events, such as bulk e-mail or data import. Important We strongly recommend that you select a low-privilege domain account that is dedicated to running these services and is not used for any other purpose. Additionally, the user account
9
that is used to run a Microsoft Dynamics CRM service cannot be a Microsoft Dynamics CRM user. This domain account must be a member of the Domain Users group. Additionally, if the Asynchronous Service and Sandbox Processing Service roles are installed, such as in a Full Server or a Back End Server installation, the domain account must a member of the Performance Log Users security group. If you select to run the ASP.NET service under a domain user account that is not a domain administrator or a local administrator, you must set a local security policy after you install Microsoft Dynamics CRM Server 2011 for the ASP.NET service to work correctly. Also, depending on the password policies that you have implemented for your organization, the password for the user may expire. For more information, see the Microsoft Knowledge Base article 329290, How to use the ASP.NET utility to encrypt credentials and session state connection strings (http://go.microsoft.com/fwlink/?linkid=53266). 14. On the Select a Web Site page, click Create a new Web site or click Select a Web Site and select a Web site from the list. By default, Setup will use the default Web site. Important We strongly recommend that you verify the status of the existing Web site before you specify Setup to use an existing Web site. We strongly recommend that the Web site you select is configured for SSL. For more information, see the IIS documentation. During the installation, Setup will bind the Microsoft Dynamics CRM application to the HTTPS Web site. If you select a network port other then a default port ensure that the firewall does not block the port. When you select the Create a new Web site option, Setup creates a new Web site for Microsoft Dynamics CRM Server 2011. You can specify the following option: Port Number. Type the TCP port number that Microsoft Dynamics CRM clients will use to connect to the Microsoft Dynamics CRM Server 2011. The default port number is 5555. 15. Click Next. 16. On the Specify E-mail Router Settings page, in the E-mail Router server name box, type the name of the computer where the E-mail Router will be installed. This computer route Microsoft Dynamics CRM email messages. If you will not install the E-mail Router you can leave this box blank. However, if you install the E-mail Router later you must add the computer where the E-mail Router is installed to the PrivUserGroup security group. Click Next. 17. On the Specify the Organization Name page, specify the following information. a. In the Display Name box, type the name of your organization. b. In the Name box, you can keep the name that is automatically generated or you can type a unique name that must be limited to 30 characters. Spaces and extended characters are not allowed. c. Under ISO currency code, click Browse, select the ISO currency code that you will use as the base currency for the organization in the list, and then click OK. You can change the currency's symbol, name, or precision. d. In the Base Language list, select the base language for the organization. In Microsoft Dynamics CRM 2011, only the base language of the first organization is tied to the language of the server installation. All other organizations can have different base languages, but you must first install Language Packs for the other language. For instructions about how to install Language Packs, see Language Pack Installation Instructions http://go.microsoft.com/fwlink/?LinkId=199560. e. In the SQL collation list, keep the default selection or select a different database collation that the organization database will use to sort and compare data characters. The default SQL collation changes based on the base language selection. For more information, see SQL Server Collation Fundamentals (http://go.microsoft.com/fwlink/?LinkID=202029). f. Click Next.
10
Important After Setup is complete, you cannot change the database collation, base ISO currency code, or the organization unique name. However, you can change the base currency name and base currency symbol. 18. On the Specify Reporting Services Server page, type the Report Server URL. Make sure that you use the Report Server URL, not the Report Manager URL. To verify that you are using the correct URL, in a browser, type the Report Server URL as the address. You should see a page titled <server>/ReportServer - /: with text that displays the version number: Microsoft SQL Server Reporting Services Version <version number>. Click Next. 19. On the Help Us Improve the Customer Experience page, select whether you want to participate in the Customer Experience Improvement Program, and then click Next. Note For more information, see Microsoft Customer Experience Improvement Program http://go.microsoft.com/fwlink/?LinkId=199851. On the Select Microsoft Update OptIn page, you must select either of the following options. For information about the legal terms and privacy with Microsoft Update licensing see Windows Update FAQ (http://go.microsoft.com/fwlink/?LinkID=196513). Use Microsoft Update when I check for updates (recommended). By selecting this option, Microsoft Dynamics CRM Server will use the Microsoft Update settings on the computer. I dont want to use Microsoft update. You should only select this option if the computer uses another method to install updates such as by using Microsoft Windows Server Update Services (WSUS). The System Checks page appears. This page is a summary of all requirements and recommendations for a successful installation. Errors must be resolved before installation can continue. If no errors, or only warnings appear, you can continue with the installation. To do this, click Next. The Service Disruption Warning page appears. This page lists all services that will be stopped or restarted during Setup. Review the Ready to Install Microsoft Dynamics CRM page, and then click Back to correct any warnings. When you are ready to continue, click Install. When Setup completes successfully, the Microsoft Dynamics CRM Server setup completed page appears. If the Reporting Server instance that you specified during this Setup points to the local computer where Microsoft Dynamics CRM is installed, Setup provides an option to invoke Microsoft Dynamics CRM Reporting Extensions Setup. To install Microsoft Dynamics CRM Reporting Extensions on the computer now, select the Launch Microsoft Dynamics CRM Reporting Extensions Setup check box. Click Finish. Important After you install Microsoft Dynamics CRM Server 2011, you must install the Microsoft Dynamics CRM Reporting Extensions to create, run, and schedule reports in Microsoft Dynamics CRM. For instructions, see the Install Microsoft Dynamics CRM Reporting Extensions section. You cannot install the Microsoft Dynamics CRM Reporting Extensions before you install or upgrade Microsoft Dynamics CRM Server 2011. By default, Setup turns on HTTP compression on the server that is running IIS where the Microsoft Dynamics CRM Server 2011 Web application is installed. If you use another method to compress HTTP communications, you may want to turn this feature off. To do this, start Internet Services (IIS) Manager, click the Web site, double-click Compression, and then clear the compression check boxes. For an IFD deployment, after Microsoft Dynamics CRM Server Setup completes, you must configure Claims-based authentication and the relying parties on the STS server. Then, run the IFD Configuration Wizard to complete the configuration. For information about this configuration see the Post installation tasks topics in this guide.
20.
21.
22. 23.
24.
11
To install the CRM Reporting Extensions, locate the Microsoft Dynamics CRM installation files, and follow these steps:
1. In the /SrsDataConnector/ folder, double-click SetupSrsDataConnector.exe. 2. On the Welcome to Microsoft Dynamics CRM Reporting Extensions Setup page, select whether you want to update Microsoft Dynamics CRM Server Setup. We recommend that, if updates are available, you let Setup download the latest version. To do this, click Update installation files, wait until the update process is complete, and then click Next. 3. On the License Agreement page, review the information and, if you accept the license agreement, click I accept this license agreement, and then click I Accept. 4. If Setup detects that components are missing, the Install Required Components page appears. If you have already installed the required components, this page will not appear. If you have not installed the required components listed, you can install them now. Click Install. When the components are installed, the status column will change from Missing to Installed, and you can click Next to continue. 5. On the Specify Configuration Database Server page, if you are using the default instance of the SQL Server, enter the name of the computer that is running SQL Server and contains the Microsoft Dynamics CRM configuration database that is named MSCRM_CONFIG, and then click Next. Note If you are not using the default SQL Server instance, enter <machine-name>\<instance-name>. On the Specify SSRS Instance Name page, select a Microsoft SQL Server Reporting Services instance that will be used for Microsoft Dynamics CRM reporting, and then click Next. On the Select Microsoft Update OptIn page, select whether you want to use Microsoft Update for checking for updates for your Microsoft products, and click Next. We recommend that you use the Microsoft Update to check for updates because this keeps your computer up-to-date and secure. On the Select Installation Location page, click Browse, and select a path where you want to install CRM Reporting Extensions, and then click Next. The System Checks page appears. This page is a summary of the requirements for a successful CRM Reporting Extensions installation. Errors must be corrected before installation can continue. All errors must be resolved. If no errors or only warnings appear, you can continue with the installation. To do this, click Next.
6. 7.
8. 9.
12
10. Review the Ready to Install Microsoft Dynamics CRM Reporting Extensions page, and then click Back to correct any errors. When you are ready to continue, click Install. 11. When Setup completes successfully, the Microsoft Dynamics CRM Reporting Extensions Setup Completed page appears. Click Finish. The reports will be published for the default organization. Important The reports will not be published if: The user running CRM Reporting Extensions Setup does not have appropriate permissions on the organization database. CRM Reporting Extensions are installed for an SQL Server Reporting Services instance that is different from the one that is being used by the organization. The base language of the organization is different from the language in which CRM Reporting Extensions are being installed.
Other software components installed during Microsoft Dynamics CRM Report Authoring Extension Setup
If not already installed, the following components are installed during Microsoft Dynamics CRM Report Authoring Extension Setup: Microsoft Application Error Reporting Tool Windows Live ID Sign-in Assistant
13
7. On the System Checks page, a summary of all requirements and recommendations for a successful installation is shown. Errors must be corrected before installation can continue. If no errors, or only warnings appear, you can continue with the installation. To do this, click Next. 8. Review the Ready to Install Microsoft Dynamics CRM Report Authoring Extension page, and then click Back to correct any errors. When you are ready to continue, click Install. When Setup successfully completes, the Microsoft Dynamics CRM Report Authoring Extension Setup Completed page appears. Click Finish.
Upgrade options
There are three different upgrade options: Migrate by using a new instance of SQL Server. We recommend this option for upgrading from Microsoft Dynamics CRM 4.0 to Microsoft Dynamics CRM 2011. Although this option requires a different computer for Microsoft Dynamics CRM 2011 Server and a different instance of SQL Server, it provides the least amount of potential downtime for Microsoft Dynamics CRM users since the Microsoft Dynamics CRM 4.0 deployment can remain functioning until the upgrade is completed and verified. Migrate by using the same instance of SQL Server. This option requires a different computer for Microsoft Dynamics CRM 2011 Server, but will upgrade in-place the configuration and default organization databases using the same instance of SQL Server. If issues occur during the upgrade, you must roll back to Microsoft Dynamics CRM 4.0 to avoid significant downtime. In-place upgrade. Although this option does not require a different computer for Microsoft Dynamics CRM 2011 Server or a different instance of SQL Server, it poses the greatest risk if upgrade issues occur because a roll back and reinstall of Microsoft Dynamics CRM 4.0 Server will be required to avoid potential downtime. Important You cannot upgrade versions of Microsoft Dynamics CRM that are earlier than Microsoft Dynamics CRM 4.0 to Microsoft Dynamics CRM 2011. Because Microsoft Dynamics CRM 2011 Server is only available in 64-bit editions, you cannot perform an in-place upgrade with 32-bit versions of Microsoft Dynamics CRM 4.0 Server. For more information see the "Migrate from 32-bit versions of Microsoft Dynamics CRM 4.0 Server to Microsoft Dynamics CRM 2011 Server" topic later in this section.
Software prerequisites
We recommend that you install the following components on the Microsoft Dynamics CRM Server 2011 or the computer where Microsoft Dynamics CRM 4.0 will be migrated to before you run the upgrade: Windows Identity Foundation (WIF) Framework
Microsoft .NET Framework 4.0 SQL Server Native Client Microsoft Application Error Reporting Tool Microsoft URL Rewrite Module for IIS If these components are not present when you run the upgrade, Setup will install them. However, to reduce the upgrade processing time, consider installing these components in advance. These components can be found in the redist folder of the Microsoft Dynamics CRM installation media.
Uninstall Microsoft Dynamics CRM 4.0 Connector for SQL Server Reporting Services if it is installed on the same computer where Microsoft Dynamics CRM Server 2011 is installed. See the Microsoft Dynamics CRM 2011 Server Readme (http://go.microsoft.com/fwlink/?linkid=144915) file to determine the location of the Microsoft Dynamics CRM installation files.
6. 7.
8. 9.
10.
11. 12.
13. To install Microsoft Dynamics CRM Reporting Extensions on the computer now, select the Launch Microsoft Dynamics CRM Reporting Extensions Setup check box. Click Finish. Important After you install Microsoft Dynamics CRM Server 2011, you must install the Microsoft Dynamics CRM Reporting Extensions to create, run, and schedule reports in Microsoft Dynamics CRM. For instructions, see the Install Microsoft Dynamics CRM Reporting Extensions section. You cannot install the Microsoft Dynamics CRM Reporting Extensions before you install or upgrade Microsoft Dynamics CRM Server 2011. By default, Setup turns on HTTP compression on the server that is running IIS where the Microsoft Dynamics CRM Server 2011 Web application is installed. If you use another method to compress HTTP communications, you may want to turn this feature off. To do this, start Internet Services (IIS) Manager, click the Web site, double-click Compression, and then clear the compression check boxes. For an IFD deployment, after Microsoft Dynamics CRM Server Setup completes, you must configure Claims-based authentication and the relying parties on the STS server. Then, run the IFD Configuration Wizard to complete the configuration. For information about this configuration see the Post installation tasks topics in this guide.
Migrate from 32-bit versions of Microsoft Dynamics CRM 4.0 Server to Microsoft Dynamics CRM 2011 Server
To migrate a 32-bit version of Microsoft Dynamics CRM 4.0 Server to Microsoft Dynamics CRM 2011 Server, first establish a different instance of SQL Server, run Microsoft Dynamics CRM Server Setup on a new 64-bit computer to create a new Microsoft Dynamics CRM 2011 deployment, and then run the Import Organization Wizard to import one or more Microsoft Dynamics CRM 4.0 organizations to the newly installed Microsoft Dynamics CRM 2011 system. During the import the Microsoft Dynamics CRM 4.0 organization database will be upgraded.
3. After the installation completes, disable the Microsoft Dynamics CRM 4.0 deployment by running Deployment Manager on the Microsoft Dynamics CRM 4.0 server. For more information, see the Deployment Manager Help. 4. On the SQL Server that is maintaining the existing Microsoft Dynamics CRM 4.0 databases, start Microsoft SQL Server Management Studio and back up the MSCRM_CONFIG and OrganizationName_MSCRM databases. 5. Restore the organization databases to the SQL Server that will be maintaining the Microsoft Dynamics CRM 2011 databases. 6. Start Deployment Manager on the Microsoft Dynamics CRM 2011 Server and run the Import Organization Wizard to import and upgrade one or more Microsoft Dynamics CRM 4.0 organizations into the new Microsoft Dynamics CRM 2011 deployment. 7. Verify that the new deployment functions as expected. 8. Make the appropriate DNS and IIS modifications to make sure users are able to connect to the new system. If issues occur that will cause significant downtime, enable the Microsoft Dynamics CRM 4.0 deployment while the issues are worked on. For more information, see the Deployment Manager Help.
1.
2.
3.
4.
5.
Migrate from Microsoft Dynamics CRM 3.0 Server to Microsoft Dynamics CRM 2011 Server
In-place upgrade from versions of Microsoft Dynamics CRM 3.0 is not available. However, you can migrate your Microsoft Dynamics CRM 3.0 deployment to Microsoft Dynamics CRM 2011 by using a Microsoft Dynamics CRM 4.0 trial version as an interim step in the migration process. To migrate your 32-bit version of Microsoft Dynamics CRM 3.0 Server to Microsoft Dynamics CRM 2011 Server, perform the following tasks. Important Microsoft Dynamics CRM 4.0 Server and Microsoft Dynamics CRM 2011 Server have different component requirements than Microsoft Dynamics CRM 3.0 Server. Therefore, you must make sure that your hardware and software environment will support the migration. For more information about the hardware and software requirements for Microsoft Dynamics CRM 4.0, see the Microsoft Dynamics CRM 4.0 Implementation Guide. For more information about Microsoft Dynamics CRM 2011 hardware and software requirements, see the System Requirements topic in the Planning Guide. 1. Upgrade to Microsoft Dynamics CRM 4.0 Server by downloading and installing the Microsoft Dynamics CRM 4.0 90-day trial versions (http://go.microsoft.com/fwlink/?LinkID=153783) available on the Microsoft Download Center. Or, you can migrate your Microsoft Dynamics CRM 3.0 organization to a trial 64-bit version of Microsoft Dynamics CRM 4.0. Important Trial versions of Microsoft Dynamics CRM 4.0 can be used within a 90-day period before you must enter a valid commercial product key to continue use. To make sure the latest updates to the Setup program are applied that help ease upgrading to Microsoft Dynamics CRM 2011, we strongly recommend that you click Get updates for Microsoft Dynamics CRM during the installation or upgrade to Microsoft Dynamics CRM 4.0. 2. Migrate the newly installed Microsoft Dynamics CRM 4.0 trial version by following the steps in the previous topic. Or, if you migrated your Microsoft Dynamics CRM 3.0 organization to a 64-bit version of Microsoft Dynamics CRM 4.0, you can perform an in-place upgrade of Microsoft Dynamics CRM 2011 Server. 3. Install Microsoft Dynamics CRM Reporting Extensions. 4. Install additional components, such Microsoft Dynamics CRM 2011 E-mail Router, as necessary.
Upgrade Microsoft Dynamics CRM Connector for SQL Server Reporting Services
In-place upgrade of the Microsoft Dynamics CRM 4.0 Connector for SQL Server Reporting Services is not supported. If Microsoft Dynamics CRM 4.0 Connector for SQL Server Reporting Services is already installed, you must first uninstall it and then run Microsoft Dynamics CRM Reporting Extensions Setup. 1. Uninstall Microsoft Dynamics CRM 4.0 Connector for SQL Server Reporting Services. 2. Meet all requirements as specified under the Planning Guide System Requirements and Required Components topic. 3. Upgrade from Microsoft Dynamics CRM 4.0 to Microsoft Dynamics CRM 2011. 4. At the computer where Microsoft Dynamics CRM 4.0 Connector for SQL Server Reporting Services was installed, log on to your domain as a user who has administrator-level privileges. 5. See the Readme file to review important information and determine the location of the Microsoft Dynamics CRM Reporting Extensions installation files. 6. In the SrsDataConnector folder, double-click SetupSrsDataConnector.exe. 7. Follow the instructions on the screen or see Install Microsoft Dynamics CRM Reporting Extensions in this guide.
Post-upgrade steps for servers For each of your Microsoft Dynamics CRM Server 2011 deployments, follow these steps:
1. If you have additional servers, upgrade or uninstall and reinstall Microsoft Dynamics CRM on those servers as described in the "Upgrading multiple servers" section of this guide. 2. Install the Microsoft Dynamics CRM Reporting Extensions for SQL ServerReporting Services. If you are migrating to Microsoft Dynamics CRM 2011, you must install Microsoft Dynamics CRM Reporting Extensions for SQL ServerReporting Services before you can import and upgrade a Microsoft Dynamics CRM 4.0 organization. 3. Install the latest Microsoft Dynamics CRM 2011 Update Rollup package or server hotfixes. 4. In Microsoft SQL Server Reporting Services Report Manager, re-create any custom data sources under the OrganizationName_MSCRM folders. 5. Verify that the system jobs and workflows are running. 6. Although not required, we recommend that you register Microsoft Dynamics CRM. For information, see the topic Register Microsoft Dynamics CRM later in this section. Verify intranet Web addresses for in-place or connect to existing deployment upgrades During an in-place upgrade or connect to existing deployment upgrade, Microsoft Dynamics CRM Server Setup may overwrite the Web addresses (AD root domain) that exist in the Microsoft Dynamics CRM 4.0 deployment. The issue occurs when the first local computer that is running Microsoft Dynamics CRM 4.0 Server is upgraded. If the Web addresses are not using the name of the local computer, the change to the address may not be desired and can cause unexpected results. To work around this potential issue, verify that the intranet Web addresses are correct. For more information about how to view or change the Web addresses, see the Deployment Manager Help. This issue will not occur when you perform a migration upgrade. For more information about migration upgrades, see Upgrade from Microsoft Dynamics CRM 4.0 Server 32-bit editions (on page 17).
Log files
Setup creates log files that can be reviewed and used for troubleshooting. By default, the location of the log files, where User is the account of the user who ran Setup, is as follows: SystemDrive:\Users\User\AppData\Roaming\Microsoft\MSCRM\Logs\
Microsoft Dynamics CRM Server 2011 cannot connect to Microsoft SQL Server
This issue can occur when Windows Firewall does not include an exception for the TCP port used by Microsoft SQL Server. By default, the TCP port used by Microsoft SQL Server is 1433. For more information, see Configuring the Windows Firewall to Allow SQL Server Access (http://go.microsoft.com/fwlink/?LinkID=197464).
'Login failed for DomainName\ServerName$" error message after Microsoft Dynamics CRM Server 2011 install, repair, or configure
You may receive this error message when you try to sign-in to Microsoft Dynamics CRM after you install, upgrade, repair, or configure Microsoft Dynamics CRM Server 2011. This issue occurs when the following conditions are true:
The server where you perform the installation,upgrade, repair, or configure action is located in a domain that is operating at a Windows Server 2003 domain functional level. One or more Microsoft Dynamics CRM service accounts are configured to use Network Service. To work around this issue, restart the server where Microsoft Dynamics CRM Server 2011 is installed.
Protocols. Both Affinity. Single For information about procedures for loading and administering NLB on Windows Server, see the Network Load Balancing Manager Help on the Windows Server computer. For information about how to configure NLB in Windows Server 2008, see Network Load Balancing Deployment Guide (http://go.microsoft.com/fwlink/?LinkID=194401).
3. 4. 5. 6. 7.
8. In the Value to add box, type HTTP/CRMNLBName.FQDN and then click Add. Where, CRMNLBName, is the NLB cluster name and FQDN is the fully qualified domain name. For example, the CRMNLBName.FQDN name might be CRMNLBCluster.contoso.com. Important Note this NLB cluster name. You must use this name in the following step when you create the NLB cluster and when you update the configuration database. Tip Use the setspn command line tool to determine if the SPN is already in use. 9. In the Value to add box, type HTTP/CRMNLBName and then click Add. 10. Click OK two times. 11. Close ADSI Edit.
Important Depending on how you deployed the Microsoft Dynamics CRM Server 2011 role group or separate server role installation, and the configuration of each server in the NLB cluster, the Web Application Server, Organization Web Service, Discovery Web Service, or Deployment Web Service Web addresses may be different. For example, if you installed the Front End Server role group on a server in an NLB cluster that is named crmcluster1 in the contoso domain but installed the Deployment Administration Server role group on a different server in a different NLB cluster such as crmcluster2 in the same domain, the name of the Web Application Server, Organization Web Service, Discovery Web Service Web addresses will be different from the Deployment Web Service Web address. For a Full Server role deployment, all Web addresses will use the same computer name or FQDN of the cluster. If you are using a TCP port other then 80 (non-secure HTTP) or 443 (secure HTTP or SSL), you must specify the port number by appending the FQDN name with :5555, where 5555 is the port number, such as crmcluster:5555.
Install Microsoft Dynamics CRM Server 2011 to use a Microsoft SQL Server cluster environment
You can install Microsoft Dynamics CRM Server 2011 so that it can use a clustered Microsoft SQL Server environment that uses Microsoft Cluster Service (MSCS). Important Failover clustering is not supported with Microsoft SQL Server 2008 Workgroup.
Base configuration
This topic describes the options that are available to configure Microsoft Dynamics CRM to use a clustered SQL Server environment. The base configuration for a Microsoft Dynamics CRM Server 2011 system is described previously in this guide. The instructions in this topic expand on the base configuration by installing Microsoft Dynamics CRM Server 2011 so that it has a connection to a cluster of computers that are running SQL Server. The configuration described here involves a single deployment of Microsoft Dynamics CRM Server 2011 accessing a cluster of two computers that are each running an instance of Microsoft SQL Server 2008. The typical Microsoft Dynamics CRM deployment creates and uses the following Microsoft Dynamics CRMspecific databases on SQL Server: OrganizationName_MSCRM. This is the organization database where Microsoft Dynamics CRM data is stored, such as all records and activities. MSCRM_CONFIG. This database contains Microsoft Dynamics CRM metadata, such as configuration and location information that is specific to each organization.
Note Although you can install Microsoft Dynamics CRM Server 2011 to a SQL Server cluster that is configured for either active-active or active-passive clustering, the cluster will function in an active-passive manner. For more information about SQL Server failover clustering, see High Availability with SQL Server R2 (http://go.microsoft.com/fwlink/?LinkID=194563).
Step 2: Install Microsoft Dynamics CRM Server 2011 Install Microsoft Dynamics CRM Server 2011 by using the procedures in the previous section and perform the following tasks during Setup:
1. On the Select SQL Server page, type the virtual server name that you specified when you created the SQL Server cluster. 2. On the same page, select the Create a new deployment option, and then complete Microsoft Dynamics CRM Server Setup.
Option 2: Rehome or configure an existing Microsoft Dynamics CRM Server 2011 deployment that connects to a SQL Server cluster that stores only the organization database
To configure your existing Microsoft Dynamics CRM Server 2011 to use the SQL Server cluster that contains only the organization database, follow these steps:
1. Follow the procedure in the previous section to create the SQL Server cluster. 2. Back up the MSCRM_CONFIG and OrganizationName_MSCRM databases that are on the existing SQL Server. 3. Restore the OrganizationName_MSCRM database to the SQL Server cluster. For more information about how to restore databases, see Backing Up and Restoring Databases in SQL Server (http://go.microsoft.com/fwlink/?linkid=100249). 4. On the computer that is running the Deployment Tools server role, start Deployment Manager. To do this, click Start, point to All Programs, point to Microsoft Dynamics CRM, and then click Deployment Manager. 5. Expand the Deployment Manager node, and then click Organizations. 6. Right-click the organization, and then click Disable. Warning When you disable an organization, users will no longer be able to access Microsoft Dynamics CRM for that organization. Click Yes to disable the organization. In the list of organizations, right-click the organization, and then click Edit Organization. In the Edit Organization Wizard, in the SQL Server box, type the virtual SQL Server name for the SQL Server cluster that you created earlier, and then click Next. On the System Requirements page, after a successful diagnostics check, click Next, and then click Apply. Click Finish. Enable the organization. To do this, right-click the organization, and then click Enable. Reset the IIS services on the computer that is running IIS where the Microsoft Dynamics CRM Server 2011 Web application is installed. To do this, click Start, click Run, type iisreset in the Open box, and then click OK.
Option 3: Rehome or configure an existing Microsoft Dynamics CRM Server 2011 deployment that connects to a SQL Server cluster that stores both the configuration and organization databases
Configure your existing Microsoft Dynamics CRM Server 2011 to use the SQL Server cluster that contains both the configuration and organization databases.
Warning Serious problems might occur if you modify the registry incorrectly. These problems might require you to reinstall the operating system and Microsoft Dynamics CRM. We cannot guarantee that these problems can be resolved. Modify the registry at your own risk. 5. Update the configdb registry subkey on the computer that is running Microsoft Dynamics CRM Server 2011. To do this, follow these steps: a. On the computer that is running the Microsoft Dynamics CRM Web application, click Start, click Run, type regedit in the Open box, and then click OK. b. Locate the following registry subkey: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSCRM c. Right-click configdb, and then click Modify. d. In the Value data box, change the data source to the name of the new virtual SQL Server name, and then click OK. For example, the string value in the Value data box should resemble the following: Data Source=NewSQLServer;Initial Catalog=MSCRM_CONFIG;Integrated Security=SSPI Note If multiple Microsoft Dynamics CRM Server 2011 Roles are in your deployment, you must update the registry keys for all the server roles.
If you use the Microsoft Dynamics CRM Reporting Extensions and if you are not moving the Microsoft SQL Server Reporting Services server, you must update the configdb subkey on the computer on which the Microsoft Dynamics CRM Reporting Extensions is installed. 6. Configure Microsoft Dynamics CRM Server 2011 to connect with the new instance of SQL Server where the organization database is now located. To do this, follow these steps: a. On the computer that is running the Microsoft Dynamics CRM Server 2011 Web application, start Deployment Manager. To do this, click Start, point to All Programs, point to Microsoft Dynamics CRM, and then click Deployment Manager. b. Expand the Deployment Manager node, and then click Organizations. c. Right-click the organization, and then click Disable. When you disable an organization, users will no longer be able to access Microsoft Dynamics CRM for that organization. d. Click Yes to disable the organization. e. In the list of organizations, right-click the organization, and then click Edit Organization. f. In the Edit Organization Wizard, in the SQL Server box, type the virtual SQL Server name for the SQL Server cluster that you created earlier, and then click Next. g. On the System Requirements page, after a successful diagnostics check, click Next, and then click Apply. h. Click Finish. i. Enable the organization. To do this, right-click the organization, and then click Enable. 7. Reset the IIS services on the computer that is running IIS where the Microsoft Dynamics CRM Server 2011 Web application is installed. To do this, click Start, click Run, type iisreset in the Open box, and then click OK.
Disable an organization
1. On the computer that is running the Microsoft Dynamics CRM Server 2011 Web application, start Deployment Manager. To do this, click Start, point to All Programs, point to Microsoft Dynamics CRM, and then click Deployment Manager. 2. Expand the Deployment Manager node, and then click Organizations. 3. Right-click the organization, and then click Disable. When you disable an organization, users will no longer be able to access Microsoft Dynamics CRM for that organization. 4. Click Yes to disable the organization.
e. On the Principle Server Instance window, in the Principal server instance list, select the instance of SQL Server (MSCRM_Primary) where the Microsoft Dynamics CRM organization database is located. In addition, you can change the default settings for the listener port, encryption, and endpoint name. Click Next. f. On the Mirror Server Instance window, in the Mirror server instance list, select the instance of SQL Server (MSCRM_Mirror) where you restored the Microsoft Dynamics CRM organization database in the previous step. You can change the default settings for the listener port, encryption, and endpoint name, if it is necessary. Click Next. g. On the Witness Server Instance window, in the Witness server instance list, select the computer that you want to designate as the Witness (MSCRM_Witness). At this point, you can change the default settings for the listener port, encryption, and endpoint name. Click Next. If you are connecting to an instance of SQL Server that is running Microsoft SQL Server 2008 Express Edition, verify that remote connections are supported. To do this, on the computer where Microsoft SQL Server 2008 Express Edition is installed start SQL Server Configuration Manager and make sure that the remote-connections feature is enabled. h. On the Service Accounts window, enter the Active Directory service account for each instance. We recommend that you specify the same service account for all three partners in the mirroring session. Click Next. i. Click Finish. The wizard runs through a list of verification checks. Upon completion, click Start Mirroring. 6. If you want to mirror the configuration database (MSCRM_CONFIG) you must complete similar steps to establish the mirror and update the SQL Server connection string in the registry. To do this, follow these steps. Warning Serious problems might occur if you modify the registry incorrectly by using Registry Editor or by using another method. These problems might require you to reinstall the operating system and Microsoft Dynamics CRM. We cannot guarantee that these problems can be resolved. Modify the registry at your own risk. a. On the computer that is running Internet Information Services (IIS), where the Microsoft Dynamics CRM Web application is installed, start Registry Editor and locate the following registry subkey: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\MSCRM\ b. Right-click configdb, and then click Modify. Insert Failover Partner=MSCRM_Mirror; into the connection string, after the DataSource value. The complete connection string will appear similar to the following example, where MSCRM_Primary is the primary SQL Server\instance name and MSCRM_Mirror is the mirrored SQL Server\instance name: Data Source=MSCRM_Primary\SQL1;Failover Partner=MSCRM_Mirror\SQL2;Initial Catalog= MSCRM_CONFIG;Integrated Security=SSPI c. Click OK, and then close Registry Editor. 7. Create the SQL logins for the Microsoft Dynamics CRM security groups on the Mirror server (MSCRM_Mirror). To do this, follow these steps. a. On the SQL Server (MSCRM_Primary) start SQL Server Management Studio, and connect to the Primary database. b. Expand Databases, expand the OrganizationName_MSCRM database where OrganizationName is the name of your organization, expand Security, and then double-click Users. c. Copy and paste the names, including the domain name and the GUIDs, (the GUIDs are located at the end of the name) for the following groups: PrivReportingGroup ReportingGroup SQLAccessGroup To do this, right-click the SQL user name, click Properties, in the User name box, right-click the whole value, and then click Copy. Then, in a text editor such as Notepad, paste the contents. Repeat these steps for each group until you have the contents for all three groups. d. In SQL Server Management Studio, connect to the SQL Server Mirror instance (MSCRM_Mirror).
e. Expand Databases, expand Security, right-click Logins, and then click New Login. f. Switch to the text editor in which the SQL users were previously pasted, and copy the contents of one of the groups. g. Switch to the Login New form that was opened in step e. In the Login name box, paste the contents into the box, and then click OK. The SQL user contents should resemble the following example. DomainName\SQLAccessGroup {859409f6-c4a5-4cb6-86f2-af264520ea10} h. Repeat steps e through g to create SQL logins for the remaining groups. 8. Update the configuration database to specify the mirror. To do this, follow these steps. Important Back up the Microsoft Dynamics CRM configuration database (MSCRM_CONFIG) before you run these update statements. a. Run the following update statement against the configuration (MSCRM_CONFIG) database.
Update Organization set ConnectionString = 'Provider=SQLOLEDB;Data Source=MSCRM_Primary\SQL1;Failover Partner=MSCRM_Mirror\SQL2;Initial Catalog=Organization_MSCRM;Integrated Security=SSPI' where DatabaseName = 'Organization_MSCRM'
Replace MSCRM_Primary\SQL1 with the name of the Primary instance of SQL Server. If you are using the default instance, do not designate the instance such as \SQL1. Replace MSCRM_Mirror\SQL2 with the name of the Mirrored instance SQL Server. If you are using the default instance, do not designate the instance such as \SQL2. Replace Organization_MSCRM with the name of the organization database. b. Run the following update statement against the configuration (MSCRM_CONFIG) database.
Chapter 3
Language Pack Installation Instructions
The Microsoft Dynamics CRM 2011 Language Pack enables users to change the language of the user interface or Help that is displayed in the application. For example, your multinational organization might have standardized on an English user interface to simplify internal training and troubleshooting, but if you prefer to read Help in your native language of German, you can specify that Microsoft Dynamics CRM display Help in German.
In This Chapter
Overview -- Language Pack Installation...................................................................................... 33 Install and deploy a Language Pack ........................................................................................... 33 Upgrade and deploy a Language Pack ....................................................................................... 35 Language Pack installation issues .............................................................................................. 35
<proc_type> specifies the type of processor the server is running. (For example, "amd64.") 4. On the End User License Agreement page, review the information and, if you accept the license agreement, click I accept the terms in the license agreement, and then click Install. Setup copies the Language Pack files to the correct locations in the Microsoft Dynamics CRM deployment. By default, the Language Pack files are copied to drive:\Program Files\Microsoft CRM\LangPacks\<loc_ code>, where <loc_ code> is the locale code for the Language Pack that you are installing. 5. To complete the installation, click Finish. Repeat the process for each Language Pack that you want to install.
Step 2: Provision the Language Pack in your Microsoft Dynamics CRM deployment
Before users can start using a Language Pack to display a language, the Language Pack must be provisioned in your Microsoft Dynamics CRM deployment.
8.
Step 3: Select the language to display the user interface and help
Each User can select the language to display in both the Microsoft Dynamics CRM Web client and Microsoft Dynamics CRM for Outlook applications.
34
Note In Microsoft Dynamics CRM for Outlook, the user language settings only apply to Microsoft Dynamics CRM for Outlook features, such as the user interface display of the CRM menu, and do not affect other areas of Microsoft Office Outlook. To be able to display all the Microsoft Dynamics CRM for Outlook user interface or Help in multiple languages, you must install one or more Office Language Packs. For more information about Office Language Packs, see the Microsoft Dynamics CRM for Outlook Help.
You receive a "Setup could not install Language Pack Name" error message
This issue can occur when the Microsoft Dynamics CRM Server 2011 or Microsoft Dynamics CRM for Outlook applications are not installed on the computer before you run MUISetup_<loc_code>_<proc_type>.msi to install a Language Pack. To resolve this issue, you must perform the following procedures: If you are installing the Language Pack for the Microsoft Dynamics CRM deployment, you must install the Language Pack on the computer where Microsoft Dynamics CRM Server 2011 is installed. If you are installing the Language Pack for Microsoft Dynamics CRM for Outlook, you must install the Language Pack on the computer where Microsoft Dynamics CRM for Outlook is installed.
----------------------- Send Feedback About This Chapter ---------------------We appreciate hearing from you. To send your feedback, click the following link and type your comments in the message body. Note The subject-line information is used to route your feedback. If you remove or modify the subject line, we may be unable to process your feedback. Send Feedback (http://go.microsoft.com/fwlink/?LinkID=200692)
35
Chapter 4
Uninstall, Repair, and Change Instructions
This section describes how to uninstall, repair, or change a Microsoft Dynamics CRM application. Uninstalling Microsoft Dynamics CRM and purging the computer system of all Microsoft Dynamics CRM data and system changes involves a series of automated and manual procedures. These procedures are the same whether the Microsoft Dynamics CRM installation involves one computer or several. These procedures also involve working in the following areas: Microsoft Dynamics CRM Internet Information Services (IIS) Microsoft SQL Server Microsoft SQL Server Reporting Services Active Directory
In This Chapter
Uninstall, change, or repair Microsoft Dynamics CRM Server 2011 .......................................... 37 Uninstall or repair Microsoft Dynamics CRM Reporting Extensions .......................................... 38 Uninstall or repair Microsoft Dynamics CRM Report Authoring Extension ................................ 39 Uninstall, change, or repair E-mail Router.................................................................................. 39 Uninstall or repair Microsoft Dynamics CRM for Outlook ........................................................... 40 Uninstall or repair a Language Pack ......................................................................................... 40
Note Repairing a Microsoft Dynamics CRM Server 2011 installation reinstalls the program files. It has no effect on the databases. To recover from Microsoft Dynamics CRM database problems, you must restore the MSCRM_CONFIG and OrganizationName_MSCRM databases. For information about database backup and failure recovery, see "Backing up SQL Server, including Reporting Services" in the Microsoft Dynamics CRM 2011 Operating and Maintaining Guide.
Components not removed during a Microsoft Dynamics CRM Server 2011 uninstall
The following system components, although installed during Microsoft Dynamics CRM Server Setup, are not removed when you uninstall Microsoft Dynamics CRM Server 2011. Windows role services: Web Server Role Services Static Content Default Document Directory Browsing HTTP Errors ASP.NET Microsoft .NET Framework Extensibility ISAPI Extensions ISAPI Filters HTTP Logging Request Monitor Windows authentication Request Filtering Static Content Compression Dynamic Content Compression IIS Management Console IIS 6 Metabase Compatibility
File services role services: Indexing Service Windows features: Microsoft .NET Framework HTTP Activation Windows Powershell Windows Process Activation
38
Uninstall. To remove (uninstall) the CRM Reporting Extensions, go to Programs and Features, right-click Microsoft Dynamics CRM Reporting Extensions, click Uninstall/Change, select Uninstall, and then click Uninstall. Follow the instructions on the screen. Repair. To repair the CRM Reporting Extensions, right-click Microsoft Dynamics CRM Reporting Extensions, click Uninstall/Change, select Repair, and then click Next. Follow the instructions on the screen.
39
Notes During Microsoft Dynamics CRM Server Setup, the computer where the E-mail Router is installed is added to the Active Directory PrivUserGroup security group. However, if the Email Router is uninstalled, the computer is not removed from the security group, and therefore has an unnecessary permission. If you uninstall the E-mail Router and decide not to reinstall it on the same computer, we recommend that you manually remove the computer from the PrivUserGroup security group. In Microsoft Dynamics CRM 4.0, the following configuration files were not deleted from the Drive:\Microsoft CRM Email\Service directory: EncryptionKey.xml, Microsoft.Crm.Tools.EmailAgent.Configuration.bin, and Microsoft.Crm.Tools.EmailAgent.xml. In Microsoft Dynamics CRM 2011 these files are removed if you uninstall the E-mail Router.
40
Log on to the computer where the Microsoft Dynamics CRM application is installed. Then, click Start, type Programs and Features, and then click Programs and Features in the Programs list. Important Rather than uninstall a Language Pack that is installed on the Microsoft Dynamics CRM server, you can disable a Language Pack in the organization. After you do this, users will no longer be able to see the Microsoft Dynamics CRM user interface and Help in the language that you disabled. Later, you can enable the Language Pack by clicking the language in the Language Settings list. When a Language Pack is removed or disabled, users who have that Language Pack language selected on the Personal Preferences form will have to use the base language. For example, consider the following scenario. A Microsoft Dynamics CRM deployment has English as the base language, but the Spanish Language Pack was used in the organization. Then, when the system administrator disables (or uninstalls) the Spanish Language Pack, users who selected the user interface to be in Spanish will see it in English. To disable a Language Pack, see the Microsoft Dynamics CRM Help. Uninstall. Selecting this option will remove the selected Language Pack from the computer. If you uninstall a Language Pack, you must reinstall and then enable it before it is available to users again.
----------------------- Send Feedback About This Chapter ---------------------We appreciate hearing from you. To send your feedback, click the following link and type your comments in the message body. Note The subject-line information is used to route your feedback. If you remove or modify the subject line, we may be unable to process your feedback. Send Feedback (http://go.microsoft.com/fwlink/?LinkID=200732)
41
Chapter 5
Use the Command Prompt to Install Microsoft Dynamics CRM
You can install Microsoft Dynamics CRM, Microsoft Dynamics CRM Reporting Extensions, Microsoft Dynamics CRM for Microsoft Office Outlook, and the Microsoft Dynamics CRM E-mail Router from their respective installation disks or file download location by using the command prompt. For more information see Use the Command Prompt to Install Microsoft Dynamics CRM (http://go.microsoft.com/fwlink/?LinkID=207601).
43
Chapter 6
Post-Installation and Configuration Guidelines
This chapter describes several of the Microsoft Dynamics CRM components and tasks that the administrator should configure after installing the application. Because Microsoft Dynamics CRM has a rich feature and functionality set, this chapter is not meant to be an exhaustive resource used to configure any and all deployments. Instead, use this chapter as a guideline to determine what components to configure, based on your organization's needs.
In This Chapter
Make Microsoft Dynamics CRM client-to-server network communications more secure ........... 45 Add or remove sample data ........................................................................................................ 46 Instructions for removing the Resource Center .......................................................................... 46
45
/ImportExportXml/SiteMap/SiteMap/Area Id="ResourceCenter"
6. Comment the area by using <!-- and -- > tags where the Id attribute is set to "ResourceCenter" as follows:
<!--<Area Id="ResourceCenter" ResourceId="Area_ResourceCenter" Icon="/_imgs/resourcecenter_24x24.gif" DescriptionResourceId="ResourceCenter_Area_Description"> <Group Id="ResourceCenter"> <SubArea Id="nav_lc_overview" ResourceId="Homepage_LearningOverview" DescriptionResourceId="LearningOverview_SubArea_Description" Icon="/_imgs/ico_18_129.gif" Url="/resourcecenter/overview.aspx" AvailableOffline="false" /> <SubArea Id="nav_lc_customization" ResourceId="Homepage_LearningCustomization" DescriptionResourceId="LearningCustomization_SubArea_Description" Icon="/_imgs/area/18_settings.gif" Url="/resourcecenter/customization.aspx" AvailableOffline="false"> <Privilege Privilege="CreateEntity" />
46
<Privilege Entity="solution" Privilege="Create" /> <Privilege Privilege="ImportCustomization" /> </SubArea> </Group> </Area>-->
Note By commenting the Resource Center area you preserve the capability to restore it in the future by repeating this procedure and removing the comment tags. 7. Save your changes to the customizations.xml file. 8. Create a new compressed zip file using all the extracted solution files, including your edited customizations.xml. Tip In Windows Explorer, select all the files, then right-click, and in the context menu, click Send To and Compressed (zipped) folder. 9. Import the new solutions file. a. In the Microsoft Dynamics CRM application Navigation Pane, click Settings, click Customization, and then click Solutions. b. Click Import. c. Click Browse, locate your modified solutions .zip file created in step 8, click Next, and then click Import. d. When the import completes, click Publish All Customizations. e. Click Close to close the Import Solutions dialog box. 10. Verify that the Resource Center area was removed. The import process performs validations on the Site Map. However, it is still possible that some errors might occur. If errors occur, the default Site Map will be applied and an error message will be displayed. You must fix the errors in the Site Map and import it again.
----------------------- Send Feedback About This Chapter ---------------------We appreciate hearing from you. To send your feedback, click the following link and type your comments in the message body. Note The subject-line information is used to route your feedback. If you remove or modify the subject line, we may be unable to process your feedback. Send Feedback ( http://go.microsoft.com/fwlink/?LinkId=200737)
47