Version 6.1 Release Notes and Installation Guide

Transcription

1 Version 6.1 Release Notes and Copyright 2013 Metalogix International. All Rights Reserved. This software is protected by copyright law and international treaties. Unauthorized reproduction or distribution of this software, or any portion of it, may result in severe civil and/or criminal penalties and will be prosecuted to the maximum extent possible under the law.

2 Contents Introduction... 3 Features... 3 Reorganize for Site Owners... 3 Other Fixes and Enhancements... 4 Known Issues... 5 Requirements... 5 Planning Considerations... 6 Install, Upgrade or Repair... 6

3 Release Notes Introduction Metalogix continues to enhance and refine products based on customer demand and feedback. Content Matrix Web Components has been updated to reflect these and other changes. Features Below is a brief description of some of the main enhancements that are part of this release. Reorganize for Site Owners Site Owners can, with Administrator configuration, copy, delete or move entire sites, lists, libraries or folders within a SharePoint farm using a feature Reorganize. The tool can be accessed from a site actions menu. From the Reorganize page, the Site Owner can open any part of the site hierarchy in a new window, immediately see changes made within the site, queue copy, paste or delete content changes. When pasting content, site owners can rename folders, lists or sites on the destination, choose another template from the destination, paste only elements (users, content types, groups or web parts), and select other options to include. Copyright 2013 Metalogix International 3

4 Release Notes A highlight of this is that folders can be promoted by pasting them to a Site, where they will become Lists or Libraries, making frequently accessed content more visible in the site s hierarchy. The Reorganize tool also has a Processing page to monitor progress The processing page has a View dropdown to filter the job summaries viewed. The links in each job summary open new browsers to that location. The job summaries can be exported to an excel sheet for archiving. Other Fixes and Enhancements The term Classify has been replaced with Apply Metadata. This will be seen on the buttons and context menu. During a copy from the Reorganize page, the number of versions to include can be specified. The Reorganize Page has been fixed to prevent overlapping of URLs. The main menu has been moved to Application Management page. Copyright 2013 Metalogix International 4

5 Release Notes Known Issues If a content type is added to a list or library as the result of copying or moving, (notably when the content type has managed metadata fields), and the content type was not added successfully, there may be issues trying to copy or move the content using this content type to other locations. For Reorganize, content types may not be applied if the copy is a List or Library. They will apply to the destination if the source is a folder, site or site collection. If a site collection is deleted, it may not immediately refresh in the tree view. An iisreset will take care of this. If you are using Metalogix Content Matrix and Metalogix StoragePoint, AND your storage profiles use asynchronous externalization, content that is copied or moved with Content Matrix will not be externalized to the final endpoint. The content remains in the system cache. The farm administrator will need to run the Unused BLOB cleanup job for the storage profile covering the destination, and then the Content Migrator job for the farm. This will externalize the BLOBs to their final endpoints. Administrators may not see all available Site Collections on the Reorganize page. Some SharePoint topologies may have been configured so that WebApps run under a different AppPool account or identity. This will isolate content between WebApps, and thus mean Content Matrix (by design) will security trim that part of the hierarchy. The resolution is to use the same AppPool account/identity for all WebApps, or grant the limited AppPool identity a login (with membership in the db_owner role) to any desired Content Databases in SQL. Occasionally the provisioning job on the install may get hung up. Restarting the timer service resolves this issue. If a field in a list has a unique value constraint, copying that content within the same list will present errors. Moving that content will also present errors. External Data that is selected during Apply Metadata or Upload is not retained. The content can be edited using the SharePoint interface. Requirements Content Matrix is installed as a SharePoint solution on a single SharePoint web front-end (WFE), making for simple installation and deployment to your SharePoint farm. This section will outline the necessary software and security prerequisites needed to install Content Matrix. Minimum Server Software Requirements SharePoint Foundation Server (SFS) or Microsoft SharePoint Server 2010 (MSS) o Operating System - Windows 2008 Server o SharePoint Server - SharePoint Foundation Server (SFS) - Microsoft SharePoint Server 2010 (MSS), Standard or Enterprise Copyright 2013 Metalogix International 5

6 Server Hardware Requirements Content Matrix does not have any hardware requirements beyond what is prescribed by Microsoft for WSS or MOSS. For your reference, those can be reviewed here: Minimum Browser Requirements Content Matrix follows the same minimum requirements as those for SharePoint You can find more detail on these specifications at Generally, these browsers are Internet Explorer 7.0, 8.0, 9.0 and Mozilla Firefox 3.6. Security Requirements The User Account used to perform the install must be a SharePoint Farm Administrator. Planning Considerations Content Matrix is designed to work on a SharePoint farm that has been carefully planned and architected. Users should be familiar with the layout and know where to find their most commonly used sites. Administrators and team leaders should be familiar with custom content types and custom columns that the team uses. Libraries must have Content Type Management enabled (Library settings>advanced Settings>Allow Management of Content Types=Yes) in order to best utilize the Copy and Move functionality. Install, Upgrade or Repair This section will walk you through the process of installing Content Matrix for the first time in your SharePoint farm, or upgrading or repairing an existing installation. If you have not done so already, please review the Getting Started Guide for Content Matrix Console document for steps prior to this installation. NOTE: If you have previously installed Content Matrix version 1 (no Reorganize or Processing pages) you will need to uninstall that version before upgrading or repairing version 6. NOTE: When installing the Metalogix Content Matrix Web Components users should note that an IIS Reset will need to be performed when the solution (WSP) file is deployed through the SharePoint farm. This is a requirement of SharePoint, and not of Metalogix. In most cases this IIS Reset is automatically done as part of the solution deployment. For more general information on this issue, please see the following Microsoft articles: Copyright 2013 Metalogix International 6

7 ca/library/cc262995(v=office.14).aspx#deployfarmsolutions and There are a number of methods that can be used to try and mitigate any downtime when deploying a SharePoint farm solution. One of these methods is to schedule the solution deployment for a time period that will have low impact to the environment's users. 1. You will receive a welcome with instructions on how to download the software. This will be sent after you register for a trial or make a software purchase. Follow the instructions and download the software to one of your SharePoint WFEs or download it to another location and copy it to one of your WFEs. 2. Once downloaded or copied to a WFE within your farm or single-server environment, simply doubleclick the executable to launch the installer. NOTE: For locked down instances of Windows 2008 or Windows 2008 R2, it may be necessary to right click on the executable and click Run as Administrator. 3. Click the Run Content Matrix Install button. Copyright 2013 Metalogix International 7

8 4. You will be presented with a welcome screen. Click Next. Copyright 2013 Metalogix International 8

9 5. The installer will now perform a series of system checks to make sure the system is ready for Content Matrix to be installed. If all system checks pass, click Next. NOTE: If a system check fails it will be denoted with a red X and you will not be able to continue with the installation process until the issue(s) is resolved. Copyright 2013 Metalogix International 9

10 6. INSTALL ONLY: You MUST read and agree to the terms and conditions of the METALOGIX SOFTWARE APPLICATIONS DOWNLOAD LICENSE AGREEMENT before you can proceed with the installation process. 7. Clicking the Save or Print button will open the document in PDF format. You will need Adobe Reader if you wish to save or print the agreement. 8. Click ACCEPT. Clicking DO NOT ACCEPT or ABORT will exit. Copyright 2013 Metalogix International 10

11 UPGRADE ONLY: Choose Upgrade and Click Next. Copyright 2013 Metalogix International 11

12 REPAIR ONLY: Choose Repair and Click Next. 9. Enter the license key. NOTE: You may have more than one registration key depending on what licenses you ve installed. Please make sure you are using the correct key. There are different keys for production and non-production licenses. NOTE: If you are activating a Trial license key, all Content Matrix features will stop working at the end of the trial period. 10. Verify the number of WFE servers in the farm. This can be less than the number requested with your license. You must enter an explanation in the Reason for Override field if you check the Override box. 11. Provide the credentials for an account that has local administrator rights on the WFE(s). The activation and provisioning job that runs requires this access to register certain components on each WFE. Copyright 2013 Metalogix International 12

13 12. Select the Activate Online option and click Next, (go to step 19.) or if your server does not have an Internet connection, click Activate Offline and go to the next step. Copyright 2013 Metalogix International 13

14 13. (OPTIONAL) If you ve selected the Active Offline option and clicked Next, you will see a screen with Activation Data generated. The data is already selected; copy the data. 14. Click the link or open a browser on a computer with access to the internet and navigate to Copyright 2013 Metalogix International 14

15 15. Paste the Activation Data in the top field and click the Activate button. 16. You will receive an error if you did not enter a valid registration key or Farm Id. If all values entered are valid you will receive a file download dialog. Save the file to a location that is accessible by the Copyright 2013 Metalogix International 15

16 server where you are performing the license activation. 17. Back on the Offline Activation window, upload the license key file that you received by clicking on the Browse button. a. Navigate to the location where you saved the file. b. Select the file and click Open. 18. Click Next. Copyright 2013 Metalogix International 16

17 19. INSTALL and UPGRADE ONLY: Provide the name of the database server where you want the Content Matrix configuration database installed or upgraded. You can also optionally change the database name and provide SA credentials if the currently logged on user does not have database and object create privileges on the specified SQL Server instance. 20. Click Test Connection to make sure the supplied values are valid. 21. Click Next. Copyright 2013 Metalogix International 17

18 22. INSTALL and UPGRADE ONLY: Provide the credentials that will be used to access the Content Matrix configuration database. We recommend using the default setting, which will access the database via the app pool account(s) that the SharePoint web application(s) run under. 23. Click Test Connection to test the connection based on selected authentication method. 24. Click Next. NOTE: You will see an error if you provided an invalid server/instance name or authentication credentials. Click Previous to go back and repair the error. Copyright 2013 Metalogix International 18

19 25. The solution file will now be installed on the local server and deployed to the all servers in the farm. If this is a Repair procedure, the solution file will now be removed from and re-deployed to all the servers in the farm. The page will periodically refresh to update the provisioning status. This process can take upwards of 5 minutes depending on the size of your farm. NOTE: If the deployment process fails for any reason the error will be presented in a dialog box. Click Next. Copyright 2013 Metalogix International 19

20 26. Upon completion of the deployment process the progress status will change to All operations successfully completed. Click Next. Copyright 2013 Metalogix International 20

21 27. The installation process is complete. Click Close. 28. Click Exit on the Installer. A browser window will be opened and you will be taken to the Content Matrix License Management page in SharePoint Central Administration. Copyright 2013 Metalogix International 21