Install Microsoft Dynamics AX Enterprise Search

Applies To: Microsoft Dynamics AX 2012 R2, Microsoft Dynamics AX 2012 Feature Pack, Microsoft Dynamics AX 2012

This topic describes how to install Microsoft Dynamics AX Enterprise Search. You install and deploy the files that are required to run searches for Microsoft Dynamics AX clients and Enterprise Portal for Microsoft Dynamics AX. You must complete the installation procedure on each search server.

  • Read about Microsoft Dynamics AX Enterprise Search architecture and security before you deploy Search. For more information, see Enterprise Search architecture and Enterprise Search security and protection.

  • Install the Microsoft Dynamics AX client, database, and Application Object Server (AOS) in the environment before you install Enterprise Search, and then complete the initialization checklist. If you attempt to install Enterprise Search before you complete these other tasks, the installation fails. For more information, see Install Microsoft Dynamics AX 2012.

  • Create a domain account for Enterprise Search. This account must be configured as a Microsoft Dynamics AX user. The user account must be assigned to the Search crawler role before you install search. For more information, see Configure the Search Crawler account.

  • Verify that the SharePoint Web application used for Microsoft Dynamics AX Enterprise Search is configured for NTLM authentication. Also verify that the Web application is not configured for anonymous authentication.

  • On the computer where you will install Enterprise Search, run the prerequisite validation utility to verify that system requirements have been met. For information about how to run the prerequisite validation utility, see Check prerequisites.

    For more information about the hardware and software requirements for Microsoft Dynamics AX, see the system requirements.

  • If you are setting up Enterprise Search in a SharePoint server farm, verify that the Business Data Connectivity service (BDC) is only running on the Enterprise Search server. You must stop this service an all Web front-end servers in the farm. If you do not stop the service on all Web front-end servers, Enterprise Search fails to install.

  • If you are installing Enterprise Search on Microsoft Search Server 2010 Express, you must install the SharePoint Server 2010 hotfix package dated August 31, 2010. If you do not install the hotfix, you receive the following error message when you install Enterprise Search: “The trial period for this product has expired.” For more information and to download the hotfix package, see Microsoft Knowledge Base article number 2276336.

  • Search is not supported in an environment with multiple AOS servers on the same server, unless all AOS servers point to the same database. Limitations in the Search server configuration (mssdmn.exe.config) and the Microsoft Dynamics AX client configuration prevent support for a topology with multiple AOS servers on the same server.

Use this procedure to install Enterprise Search. If you are installing other Microsoft Dynamics AX components at the same time, the installation pages vary, based on the components that you are installing.

  1. Start Microsoft Dynamics AX Setup. Under Install, select Microsoft Dynamics AX components.

  2. Advance through the first wizard pages.

  3. If the Setup Support files have not yet been installed on the computer, the Select a file location page is displayed. The Setup Support files are required for installation. Enter a file location or accept the default location, and then click Next. On the Ready to install page, click Install.

  4. On the Select installation type page, click Custom installation, and then click Next.

  5. On the Select components page, select Enterprise Search, and then click Next.

  6. On the Prerequisite validation results page, resolve any errors. For more information about how to resolve prerequisite errors, see Check prerequisites. When no errors remain, click Next.

  7. On the Select a file location page, select the location where you want to install 32-bit versions of Microsoft Dynamics AX files, and then click Next.

  8. On the Specify a location for configuration settings page, specify whether you want Enterprise Search to access configuration information from the registry on the local computer or from a shared configuration file. If you select to use a shared configuration file, you must enter the network location of the file. Click Next.

  9. On the Connect to an AOS instance page, enter the name of the computer that is running the Application Object Server (AOS) instance that you want to connect to. You can optionally specify the name of the AOS instance, the TCP/IP port number, and the WSDL port for services. Click Next.

    Uwaga

    If you entered AOS connection information for other Microsoft Dynamics AX components that are installed on this computer, this screen is not displayed. Subsequent installations on this computer reuse the existing AOS connection.

  10. On the Specify Business Connector proxy account information page, enter the password for the proxy account that is used by the .NET Business Connector. Click Next.

  11. On the Specify the search crawler account page, enter the account information, and then click Next.

  12. On the Prerequisite validation results page, resolve any errors. When no errors remain, click Next.

  13. On the Ready to install page, click Install.

  14. After the installation is complete, click Finish to close the wizard.

Post-install configuration

If you installed Enterprise Search on a computer separate from the AOS, you must specify the Search server url in the Enterprise Portal parameters form. If you do not specify the URL, Search does not retrieve data.

  1. Click System administration > Setup > Enterprise Portal > Enterprise Portal parameters.

  2. Click Search.

  3. In the Search server url field, enter the URL to the SharePoint Search service where you just installed Search. Replace server_name with the name of the server where you installed Search: http:// server_name/sites/DynamicsAXClientSearch/_vti_bin/search.asmx

  4. Click Close to save changes.

Verify membership in the SQL db_owner role

After you install Enterprise Search by using Setup, use SQL Server Management Studio to verify that the Business Connector proxy account and the search service application pool account (if different than the Business Connector proxy account) are members of the db_owner role for the following databases: Search Service_Application_CrawlStoreDB_<GUID>, Search_Service_Application_DB_<GUID>, Search_Service_Application_PropertyStoreDB_<GUID>.

Ważne

If you installed FAST Search Server 2010 for SharePoint each role is prefaced with the word FAST. For example, FAST_Search Service_Application_CrawlStoreDB_<GUID>

Post-install validation

Data, metadata, and documents can only be crawled and indexed for search if the database table is included in a Microsoft Dynamics AX AOT query. After the table is specified in a query, the query must be configured for Search. You configure a query for Search by setting the Searchable property to True in the AOT. By default, only the following queries are configured for Search. These queries are automatically published and indexed after you install Enterprise Search:

  • BdcDocuRef

  • CustTableListPage

  • EcoResProductPerCompanySearch

  • HcmWorkerListPage

  • SecurityRoleAllTasks

  • smmBusinessRelations_NoFilter

  • VendorEnterpriseSearch

Use SharePoint Central Administration to verify that the crawl for these queries has finished running.

  1. In SharePoint Central Administration, click Manage service applications > Search Service Application.

  2. Under Content Source, verify that Microsoft Dynamics AX and Microsoft Dynamics AX Metadata show a crawl end time and no errors.

  3. After the crawl complete, open an Microsoft Dynamics AX client and verify that the Search box appears in the upper-right corner. Also search on a term such as Sales and verify that the system returns results that are shown in both the middle pane (the data, metadata, and documents pane) and the Help Topics pane.

For information about how to make data, metadata, and documents available in Search, see Add AOT queries to the Search configuration. After you have specified which queries should be available in Search, you must publish the queries to SharePoint. For more information, see Configure Enterprise Search by using the Search Configuration wizard.

SharePoint Search stops working after you install Enterprise Portal

If you install Enterprise Portal on a server that hosts a SharePoint Team site, the default Search settings for the team site can change. SharePoint Search returns errors. To restore Search for the SharePoint team site, reset the SharePoint Search settings to their default values.

  1. Open the Search Settings page. By default, the URL is: http://< server_name>/_layouts/enhancedSearch.aspx

  2. Under Site Collection Search Center, click Do not use custom scopes.

  3. Under Site Collection Search Dropdown Mode, click Do not show scopes dropdown, and default to contextual scope.

  4. Under Site Collection Search Results Page, click /_layouts/OSSSearchResults.aspx, and then click OK.

See also

Checklist: Deploy Microsoft Dynamics AX Enterprise Search