IBM Endpoint Manager Version 9.2. Software Use Analysis Upgrading Guide

IBM Endpoint Manager Version 9.2 Software Use Analysis Upgrading Guide

IBM Endpoint Manager Version 9.2 Software Use Analysis Upgrading Guide

Upgrading Guide This edition applies to IBM Endpoint Manager for Software Use Analysis application update 9.0.1.1 (product number 5725-F57) and to all subsequent releases and modifications until otherwise indicated in new editions. Copyright IBM Corporation 2002, 2014. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

Contents Upgrading.............. 1 Upgrading from Software Use Analysis 9.0 and 9.0.0.1................. 1 Upgrading the server in interactive mode.... 1 Upgrading the server in silent mode..... 2 Upgrading the server with a fixlet...... 2 Migrating from License Metric Tool 9.0.1..... 3 Migrating the server in interactive mode.... 3 Migrating the server in silent mode...... 4 Validating the upgrade from License Metric Tool 9.0.1................ 5 Reusing computers from Software Use Analysis 2.2. 7 Notices.............. 11 Trademarks.............. 12 Privacy policy considerations..... 13 Copyright IBM Corp. 2002, 2014 iii

iv

Upgrading Note: Upgrading from Software Use Analysis 1.3 and 2.x is not supported because of differences in supported platforms and databases. In Software Use Analysis 1.3 and 2.x the Software Use Analysis server is installed on a Windows platform, and in Software Use Analysis application update 9.0.1.1 it is installed on a Linux platform. In Software Use Analysis 1.3 and 2.x the database uses SQL Server, and in Software Use Analysis application update 9.0.1.1 it is DB2. Tip: To learn more about the new product versioning scheme, visit the Software Use Analysis wiki page. The following are the available options for upgrading to Software Use Analysis application update 9.0.1.1. Upgrading from Software Use Analysis 9.0 and 9.0.0.1 You can upgrade to Software Use Analysis application update 9.0.1.1 from the following versions: Software Use Analysis 9.0 and Software Use Analysis 9.0.0.1, including the released patches. You can upgrade in interactive or silent mode, or with a fixlet. Upgrading the server in interactive mode Run a wizard to interactively upgrade to Software Use Analysis application update 9.0.1.1. Before you begin v Copy the compressed installer file SUA-server-9.1-tar.tgz to a temporary directory and uncompress it. v Back up the Software Use Analysis database and the server files. Procedure 1. Start the command-line interface and change to the directory where you uncompressed the installer files. 2. Run the script./setup-server-linux-x86_64.sh. A welcome panel opens. 3. Click Next. 4. Read the terms of the license agreement carefully. Select I accept both the IBM and the non-ibm terms. and click Next. A preinstallation summary panel opens. 5. Click Next. When the upgrade is finished, a post installation summary panel opens. What to do next 1. Complete the upgrade by configuring the Software Use Analysis server. If you want to complete the configuration later, access the following URL: https://hostname:9081. 2. Run a data import to be able to see complete infrastructure information in Software Use Analysis. Copyright IBM Corp. 2002, 2014 1

3. If you upgraded from Software Use Analysis 9.0, the default Java heap size is not sufficient for the current version. Increase the Java heap size to 1536 megabytes (Xmx1536m). Upgrading the server in silent mode Use a response file to silently upgrade to Software Use Analysis application update 9.0.1.1. Before you begin v Copy the compressed installer file SUA-server-9.1-tar.tgz to a temporary directory and uncompress it. v Back up the Software Use Analysis database and the server files. Procedure 1. Start the command-line interface and change to the directory where you uncompressed the installer files. 2. Read the license agreement in the license.txt file. The file is in the directory /license/your_language. 3. In the directory where you uncompressed the installer files, edit the response file upgrade_response_lmt.txt. Ensure that the RSP_LICENSE_ACCEPTED parameter is uncommented and set to true. 4. Run the following command to start the silent upgrade: Linux./setup-server-linux-x86_64.sh -i silent -f /response_file_path/upgrade_response_lmt.txt Where response_file_path is the absolute path to the response file that you are using. Example: setup-server-linux-x86_64.sh -i silent -f /tmp/images/upgrade_response_lmt.txt What to do next 1. Complete the upgrade by configuring the Software Use Analysis server. If you want to complete the configuration later, access the following URL: https://hostname:9081. 2. Run a data import to be able to see complete infrastructure information in Software Use Analysis. 3. If you upgraded from Software Use Analysis 9.0, the default Java heap size is not sufficient for the current version. Increase the Java heap size to 1536 megabytes (Xmx1536m). Upgrading the server with a fixlet You can run a fixlet from the IBM Endpoint Manager console to upgrade the server to Software Use Analysis application update 9.0.1.1. Procedure 1. Log on to the IBM Endpoint Manager console. 2. In the navigation tree, click Sites > External Sites > IBM Endpoint Manager for Software Use Analysis v9 > Fixlets and Tasks. 3. Select Upgrade to the newest version of Software Use Analysis, and then in the lower pane, click Take Action. 4. Select the computer on which you want to upgrade the server and click OK. 2

What to do next 1. Complete the upgrade by configuring the Software Use Analysis server. If you want to complete the configuration later, access the following URL: https://hostname:9081. 2. Run a data import to be able to see complete infrastructure information in Software Use Analysis. 3. If you upgraded from Software Use Analysis 9.0, the default Java heap size is not sufficient for the current version. Increase the Java heap size to 1536 megabytes (Xmx1536m). Migrating from License Metric Tool 9.0.1 You can migrate from License Metric Tool 9.0.1 to Software Use Analysis application update 9.0.1.1, in interactive or silent mode, or with a fixlet. Migrating the server in interactive mode Run a wizard to interactively migrate from License Metric Tool 9.0.1 to Software Use Analysis application update 9.0.1.1. Before you begin v Copy the compressed installer file SUA-server-9.1-tar.tgz to a temporary directory and uncompress it. v Back up the License Metric Tool database and the server files. Procedure 1. Start the command-line interface and change to the directory where you uncompressed the installer files. 2. Run the script./setup-server-linux-x86_64.sh. A welcome panel opens. 3. Click Next. 4. Read the terms of the license agreement carefully. Select I accept both the IBM and the non-ibm terms. and click Next. 5. Click Next. When the migration is finished, a post installation summary panel opens. After the wizard is completed, the database schema must be updated. 6. Update the schema, log in to Software Use Analysis, and click Update Schema. 7. Remap properties from the License Metric Tool site to the IBM Endpoint Manager for Software Use Analysis v9 site. You must remap UNIX package properties and package properties. The following steps show how to remap the default properties. Follow the same procedure for any other properties that are displayed in the upper pane. v To remap UNIX package properties: a. Click Management > Unix Package Properties, and select Unix Installed Packages, in the upper pane. b. Find and select the matching IBM Endpoint Manager for Software Use Analysis v9 Installed Unix Packages List property in the lower pane. c. Click Save. Upgrading 3

v Note: The corresponding License Metric Tool property is shown next to the IBM Endpoint Manager for Software Use Analysis v9 property in the list in the lower pane. To remap package properties: a. Click Management > Package Properties, and select Windows Installed Packages, in the upper pane. b. Find and select the matching IBM Endpoint Manager for Software Use Analysis v9 Installed Windows Application List property in the lower pane. c. Click Save. What to do next Complete the migration by configuring the Software Use Analysis server. If you want to complete the configuration later, access the following URL: https://<host>:9081. Note: Import software scan data from the IBM Endpoint Manager server to be able to see complete infrastructure information in Software Use Analysis. For more information, see Importing software scan data. Migrating the server in silent mode Use a response file to silently migrate from License Metric Tool 9.0.1 to Software Use Analysis application update 9.0.1.1. Before you begin v Copy the compressed installer file SUA-server-9.1-tar.tgz to a temporary directory and uncompress it. v Back up the License Metric Tool database and the server files. Procedure 1. Start the command-line interface and change to the directory where you uncompressed the installer files. 4

2. Read the license agreement in the license.txt file. The file is in the directory /license/your_language. 3. In the directory where you uncompressed the installer files, edit the response file upgrade_response_lmt.txt. Ensure that the RSP_LICENSE_ACCEPTED parameter is uncommented and set to true. 4. Run the following command to start the silent migrate: Linux./setup-server-linux-x86_64.sh -i silent -f /response_file_path/upgrade_response_lmt.txt Where response_file_path is the absolute path to the response file that you are using. Example: setup-server-linux-x86_64.sh -i silent -f /tmp/images/upgrade_response_lmt.txt What to do next Complete the migration by configuring the Software Use Analysis server. If you want to complete the configuration later, access the following URL: https://<host>:9081. Note: Import software scan data from the IBM Endpoint Manager server to be able to see complete infrastructure information in Software Use Analysis. For more information, see Importing software scan data. Validating the upgrade from License Metric Tool 9.0.1 After you upgrade from License Metric Tool 9.0.1 to Software Use Analysis application update 9.0.1.1, you can verify that there are no discrepancies between the reports that are generated by the two applications. Procedure 1. Export the Software Installations and All IBM Metrics reports to CSV files. You will use them to verify that there are no discrepancies between the reports that are generated by License Metric Tool and Software Use Analysis. Restriction: Export the reports before you upgrade to Software Use Analysis or before you run the initial import. Otherwise, the report that was generated by License Metric Tool is overwritten and is no longer suitable for validating that there are no data discrepancies. 2. Validate whether all target computers are subscribed to the IBM Endpoint Manager for Software Use Analysis v9 site. a. Log in to the Endpoint Manager console. b. In the navigation bar, click Sites > External Sites > IBM Endpoint Manager for Software Use Analysis v9, and then click the Computer Subscriptions tab. c. Specify the same subscription criteria that you specified in the IBM License Reporting (ILMT) v9 site. Upgrading 5

3. Unsubscribe computers from the IBM License Reporting (ILMT) v9 site. a. In the navigation bar, click IBM License Reporting (ILMT) v9, and then click the Computer Subscriptions tab. b. To unsubscribe all computers from the site, select No computers. 4. Activate the analyses that are necessary to discover software and monitor its usage. a. In the navigation bar, click Sites > External Sites > IBM Endpoint Manager for Software Use Analysis v9 > Analyses. b. Select all analyses, and click Activate. 5. Verify that the data is successfully transferred from Endpoint Manager to Software Use Analysis. a. Log in to Software Use Analysis. b. In the top navigation bar, click Management > Data Imports, and then Import Now. 6. Verify that the software catalog is successfully updated. a. In the top navigation bar, click Management > Catalog Upload. b. Click Browse, select the file in a ZIP format, and click Upload. c. Run an import. d. Verify that the status of the catalog upload in the Upload and Import History is Success. 6

7. Verify that the latest version of the software catalog is distributed to the computers. a. Log in to the Endpoint Manager console. b. In the navigation bar, click Sites > External Sites > IBM Endpoint Manager for Software Use Analysis v9 > Analyses. c. Click the Software Scan Status analysis. d. In the lower pane, click the Results tab, and verify that the version of the catalog is the same as the version that is displayed in Software Use Analysis. 8. Schedule software scans. 9. Verify that the software scan was successfully run. a. In the navigation bar, click Sites > External Sites > IBM Endpoint Manager for Software Use Analysis v9 > Analyses. b. Click the Software Scan Status analysis. c. In the lower pane, click the Results tab, and verify that the status of the software scan is OK. 10. Run an import. a. Log in to Software Use Analysis. b. In the top navigation bar, click Management > Data Imports, and then Import Now. 11. Export the Software Installations and All IBM Metrics reports to CSV files. Compare these files with the files that you created in step 1. If there are no discrepancies between the reports, the upgrade was successful. Reusing computers from Software Use Analysis 2.2 Upgrading from Software Use Analysis version 2.2 to Software Use Analysis application update 9.0.1.1 is not supported. However, you can reuse the Endpoint Manager infrastructure that was set for Software Use Analysis 2.2. In this scenario, no data is migrated to Software Use Analysis application update 9.0.1.1. Upgrading 7

About this task Restriction: The following scenario describes how to reuse the Endpoint Manager infrastructure that was set for Software Use Analysis version 2.2. No historical data is migrated to Software Use Analysis application update 9.0.1.1. Procedure 1. Stop or uninstall the Software Use Analysis version 2.2 server. 2. Unsubscribe all computers from the IBM Software Inventory site. a. Log in to the Endpoint Manager console. b. In the navigation bar, click Sites > External Sites > IBM Software Inventory, and then click the Computer Subscriptions tab. c. To unsubscribe all computers from the site, select No computers. 3. Stop all actions for fixlets and tasks from the IBM Software Inventory site. 4. Subscribe to the IBM Endpoint Manager for Software Use Analysis v9 site. a. In the lower left corner of the console, click BigFix Management. b. In the left navigation tree, click License Overview. c. In the pane on the right, locate the Software Use Analysis section. d. Enable the IBM Endpoint Manager for Software Use Analysis v9 site. 5. Subscribe all the target computers to the IBM Endpoint Manager for Software Use Analysis v9 site. a. In the navigation bar, click Sites > External Sites > IBM Endpoint Manager for Software Use Analysis v9, and then click the Computer Subscriptions tab. b. Specify the same subscription criteria that were specified in the IBM Software Inventory site. 6. Log in to Software Use Analysis to remap properties from the License Metric Tool site to the IBM Endpoint Manager for Software Use Analysis v9 site. You must remap UNIX package properties, package properties, and usage properties. The following steps show how to remap the default properties. Follow the same procedure for any other properties that are displayed in the upper pane. v To remap UNIX package properties: a. Click Management > Unix Package Properties, and select Unix Installed Packages, in the upper pane. 8

b. Find and select the matching IBM Endpoint Manager for Software Use Analysis v9 Installed Unix Packages List property in the lower pane. c. Click Save. v Note: The corresponding License Metric Tool property is shown next to the IBM Endpoint Manager for Software Use Analysis v9 property in the list in the lower pane. To remap package properties: a. Click Management > Package Properties, and select Windows Installed Packages, in the upper pane. b. Find and select the matching IBM Endpoint Manager for Software Use Analysis v9 Installed Windows Application List property in the lower pane. c. Click Save. v To remap usage properties: a. Click Management > Usage Properties, and select Windows Application Usage, in the upper pane. b. Find and select the matching IBM Endpoint Manager for Software Use Analysis v9 Application Usage property in the lower pane and click Save. 7. Install the scanner. Upgrading 9

10

Notices This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-ibm product, program, or service. IBM may have patents or pending patent applications covering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drive Armonk, NY 10504-1785 U.S.A. For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan, Ltd. 19-21, Nihonbashi-Hakozakicho, Chuo-ku Tokyo 103-8510, Japan The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some states do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improvements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-ibm Web sites are provided for convenience only and do not in any manner serve as an endorsement of those Web sites. The materials at those Web sites are not part of the materials for this IBM product and use of those Web sites is at your own risk. Copyright IBM Corp. 2002, 2014 11

IBM may use or distribute any of the information you supply in any way it believes appropriate without incurring any obligation to you. Licensees of this program who wish to have information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Corporation 2Z4A/101 11400 Burnet Road Austin, TX 79758 U.S.A Such information may be available, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this information and all licensed material available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement, or any equivalent agreement between us. Information concerning non-ibm products was obtained from the suppliers of those products, their published announcements or other publicly available sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-ibm products. Questions on the capabilities of non-ibm products should be addressed to the suppliers of those products. All statements regarding IBM's future direction or intent are subject to change or withdrawal without notice, and represent goals and objectives only. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. Trademarks IBM, the IBM logo, and ibm.com are trademarks or registered trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at Copyright and trademark information at www.ibm.com/legal/copytrade.shtml. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle and/or its affiliates. Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both. Microsoft, Windows, Windows NT, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. 12

Privacy policy considerations IBM Software products, including software as a service solutions, ( Software Offerings ) may use cookies or other technologies to collect product usage information, to help improve the end user experience, to tailor interactions with the end user or for other purposes. In many cases no personally identifiable information is collected by the Software Offerings. Some of our Software Offerings can help enable you to collect personally identifiable information. If this Software Offering uses cookies to collect personally identifiable information, specific information about this offering s use of cookies is set forth below. This Software Offering does not use cookies or other technologies to collect personally identifiable information. If the configurations deployed for this Software Offering provide you as customer the ability to collect personally identifiable information from end users via cookies and other technologies, you should seek your own legal advice about any laws applicable to such data collection, including any requirements for notice and consent. For more information about the use of various technologies, including cookies, for these purposes, See IBM s Privacy Policy at http://www.ibm.com/privacy and IBM s Online Privacy Statement at http://www.ibm.com/privacy/details the section entitled Cookies, Web Beacons and Other Technologies and the IBM Software Products and Software-as-a-Service Privacy Statement at http://www.ibm.com/software/info/product-privacy. Copyright IBM Corp. 2002, 2014 13

14

Printed in USA