IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT...

38
IT Business Management Standard Edition Installation and Administration Guide VMware IT Business Management Suite 1.0.1 This document supports the version of each product listed and supports all subsequent versions until the document is replaced by a new edition. To check for more recent editions of this document, see http://www.vmware.com/support/pubs. EN-001248-01

Transcript of IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT...

Page 1: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

IT Business Management StandardEdition Installation and Administration

GuideVMware IT Business Management Suite 1.0.1

This document supports the version of each product listed andsupports all subsequent versions until the document isreplaced by a new edition. To check for more recent editionsof this document, see http://www.vmware.com/support/pubs.

EN-001248-01

Page 2: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

IT Business Management Standard Edition Installation and Administration Guide

2 VMware, Inc.

You can find the most up-to-date technical documentation on the VMware Web site at:

http://www.vmware.com/support/

The VMware Web site also provides the latest product updates.

If you have comments about this documentation, submit your feedback to:

[email protected]

Copyright © 2014 VMware, Inc. All rights reserved. Copyright and trademark information.

VMware, Inc.3401 Hillview Ave.Palo Alto, CA 94304www.vmware.com

Page 3: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

Contents

IT Business Management Standard Edition Installation and Administration Guide 5

1 Introduction to IT Business Management Standard Edition 7

Challenges Faced by the Manager of Cloud Operations 7IT Business Management Standard Edition Goals 7IT Business Management Standard Edition Architecture 8Supported Product Integrations 10

2 Installing IT Business Management Standard Edition 13

IT Business Management Standard Edition System Requirements 14IT Business Management Standard Edition Deployment Scenarios and Best Practices 15Deploy IT Business Management Standard Edition in vSphere 15Deploy IT Business Management Standard Edition in vCloud Director 16Start the IT Business Management Standard Edition Appliance 17Configure IT Business Management Standard Edition with vCloud Automation Center 18Create a Tenant in vCloud Automation Center User Interface 19Access IT Business Management Standard Edition by Using vCloud Automation Center 20Unregister IT Business Management Standard Edition from vCloud Automation Center 21Configure NTP Server 22Change SSL Certificates 22Change Root Password 23

3 Setting Up IT Business Management Standard Edition 25

IT Business Management Standard Edition Administration 25View and Update System Status 31

4 Troubleshooting IT Business Management Standard Edition 33

Error While Accessing Business Management Tab 33vCloud Automation Center Synchronization Job Fails 33Business Management tab does not appear 34IT Business Management Standard Edition and vCloud Automation Center Connection Failure 34IT Business Management Standard Edition Displays an Exception while Parsing XML Documents 35

Index 37

VMware, Inc. 3

Page 4: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

IT Business Management Standard Edition Installation and Administration Guide

4 VMware, Inc.

Page 5: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

IT Business Management Standard EditionInstallation and Administration Guide

The VMware® IT Business Management Suite™ Standard Edition Installation and Administration guide providesinformation about installing and configuring IT Business Management Standard Edition.

Intended AudienceThis information is intended for anyone who wants to install and configureIT Business Management Standard Edition. The information is written for administrators who are familiarwith virtual machine technology and data center operations.

VMware Technical Publications GlossaryVMware Technical Publications provides a glossary of terms that might be unfamiliar to you. For definitionsof terms as they are used in VMware technical documentation, go to http://http://www.vmware.com/support/pubs.

VMware, Inc. 5

Page 6: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

IT Business Management Standard Edition Installation and Administration Guide

6 VMware, Inc.

Page 7: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

Introduction toIT Business Management StandardEdition 1

VMware IT Business Management Standard Edition provides capabilities that allow users to gain greatervisibility into financial aspects of their infrastructure and let them optimize and improve these operations.

This chapter includes the following topics:

n “Challenges Faced by the Manager of Cloud Operations,” on page 7

n “IT Business Management Standard Edition Goals,” on page 7

n “IT Business Management Standard Edition Architecture,” on page 8

n “Supported Product Integrations,” on page 10

Challenges Faced by the Manager of Cloud OperationsThe manager of cloud operations in an organization constantly faces the following challenges regarding costvisibility and optimization in the delivery of Infrastructure as a Service (IaaS).

n What is the total spending and what is it comprised of?

n What is the cost of delivering a unit of IaaS?

n Who consumes these services and at what cost?

n What are these services used for and what is the cost allocation for each?

n How is my cost efficiency compared to that of other public cloud infrastructures?

n What is the cost of potential alternatives to delivering IaaS?

n How do I use the information above to optimize the cost of my existing and future operations?

n How do I create an accurate showback report to show it to the stake holders

IT Business Management Standard Edition GoalsIT Business Management Standard Edition is a part of vCloud Automation Center and provides businessmanagement and cost transparency capabilities to your virtual infrastructure.

n Determine pricing of vCloud Automation Center blueprints by using the current cost and utilizationlevels of virtual machines as a reference.

n Make decisions related to placement of workloads, either in the private or public clouds, based on thecost and the services that are available in your hybrid cloud environment.

n Provide showback cost of virtual machine and blueprints based on business unit, application groupacross the hybrid cloud environment.

VMware, Inc. 7

Page 8: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

n As infrastructure stakeholders, allows you to manage costs based on capital expenditure and operatingexpenditure.

n Get out-of-the-box accurate cost of virtual machines without performing any financial configuration.

IT Business Management Standard Edition ArchitectureIT Business Management Standard Edition provides users greater visibility into the financial aspects of theirIaaS delivery and lets them optimize and improve these operations.

The architecture illustrates the three main components of IT Business Management Standard Edition, theserver, data collector, and reference database.

Figure 1‑1. IT Business Management Standard Edition Architecture

IT Business Management Standard Edition ServerIT Business Management Standard Edition server is based on a tc Server instance, running Spring containerand communicating through a JPA and Hibernate (on top of JDBC) to vPostgress database that runsIT Business Management Standard Edition schema. vCloud data collector collects infrastructure events andusage statistics from the vCenter Server and places the infrastructure events and usage statistics into the

IT Business Management Standard Edition Installation and Administration Guide

8 VMware, Inc.

Page 9: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

local Postgres database. Then the server consumes the data from the Postgres database.IT Business Management Standard Edition server runs Quartz instance and schedules hourly, daily, andmonthly jobs. IT Business Management Standard Edition user interface and all its external APIs return thecosts calculated by the periodic jobs.

1 When a job starts, the job collects inventory, usage information, user changes to cost formulas that weremade prior to starting the job, and most current defaults from the reference database.

2 The job then invokes series of calculation steps on the data, without interfering with ongoing inventoryor user changes. When recalculation is finished, the costs are updated.

Table 1‑1. Server Components

Component Description

Inventory and Usage Service Receives information from data collector, stores the information, andprovides APIs for servers, virtual machines, other inventory elements,and their usage statistics.

Inventory Statistics Aggregates inventory information for cost calculation and allocation.

Cost Drivers Calculates costs that do not involve a usage parameter. The module has auser interface that lets you configure various parameters of costcalculation. IT Business Management Standard Edition has eight costdrivers, server, storage, operating system, maintenance, labor, network,facilities, and other.

Cost Allocation Calculates the cost of a virtual machine according to up-time and usage.You can also configure some allocation parameters.

Consumer Allocation Allocates costs according to tags of the virtual machine or according tomapping provided by the user.

Planning Calculates the expected cost of existing inventory from Amazon andAzure.

Public Cloud Report Provides you with a summary of the infrastructure that are deployed ona public cloud provider (for example Amazon).

Reference Database Holds known configurations and default costs for each configuration,vendor, and geography.

Data CollectorThis component is responsible for connecting to vCenter Server instances and retrieving both inventoryinformation (servers, virtual machines, clusters, storage devices, and associations between them) and usage(CPU and memory) statistics.

Reference DatabaseThis component is responsible for producing default, out-of-the-box costs for each of the supported costdrivers. References are updated periodically, and user can download the latest data set and import the dataset into IT Business Management Standard Edition. The new values affect cost calculation. Reference datathat is used depends on currency selection that you select when installing the product.

Communication Between Data Collector and the ServerData collector and the server communicate through a database. Data collector writes to the database and theserver reads the data. Data collector keeps inventory information time stamped, so it is possible to retrieveand view the inventory back in time. The architecture of data collector tables is flexible, and storesproperties retrieved from the vCenter Server in key-value pairs. In some cases, the server converts this datainto specific relations, and performs aggregation operations.

Chapter 1 Introduction to IT Business Management Standard Edition

VMware, Inc. 9

Page 10: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

Communication Between Server and Reference DatabaseReference database is a compressed and encrypted file, which the users can download and install manually.You can update the most current version of reference database. For more information, see “Update theReference Database for IT Business Management Standard Edition,” on page 29.

Other Sources of InformationThese sources are optional, and are used only if installed and configured. The sources includevCloud Automation Center, vCloud Director, vCenter Operations Manager, and Amazon Web Services(AWS).

Data Input SynchronizationThe system picks up the data from the external sources continuously and periodically updates the tables,which are used to display the data and generate the report. This update occurs daily, but can also betriggered by changes in the user interface and major changes in the inventory, such as when you initialize asystem or add a new vCenter Server.

External Interfaces

Interface Description

vCloud Automation Center Call the IT Business Management Standard Edition to get the base rates.

IT Business ManagementAdvanced and Enterprise Edition

Can receive inventory information, which is used as a basis for cost model creation.A special HTTPS API is designated forIT Business Management Advanced and Enterprise Edition.

Supported Product IntegrationsIT Business Management Standard Edition integrates with various products and lets you use theinformation directly from these integration without having to manually enter the information.

VMware vSphereIT Business Management Standard Edition allows addition of one or more vCenter Server machines to getthe complete inventory list. The inventory list contains information related to virtual machinesconfiguration, ESXi host capacity, cluster capacity, storage profiles, storage capacity, and vCenter Serverattributes and tags.

VMware vCloud DirectorIT Business Management Standard Edition integration with vCloud Director lets you view theorganizational constructs from vCloud Director. IT Business Management Standard Edition supportsorganization, organization virtual datacenter (vDC), and virtual machines constructs.

NOTE The cost of virtual machine does not change whether you see the virtual machine as part ofvCenter Server or vCloud Director.

IT Business Management Standard Edition Installation and Administration Guide

10 VMware, Inc.

Page 11: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

VMware IT Business Management Advanced and Enterprise EditionIT Business Management Standard Edition exposes APIs to let the third-party systems to extract data in aCSV format. The information includes object properties along with costs and allocations around virtualmachines, physical servers, datastores, and the public cloud.IT Business Management Advanced and Enterprise Edition editions uses these APIs to collect private andpublic cloud information, which can be used in cost models and reports.

VMware vCenter Operations ManagerIT Business Management Standard Edition does not have any direct integration with vCenter OperationsManager. In an environment where vCenter Operations Manager 5.7.x is installed,IT Business Management Standard Edition gets the expected CPU and memory utilization for each clusteror unclustered ESXi host from vCenter Operations Manager. Otherwise, you can set the expected CPU andmemory utilization for the host by using the system defined value, which is computed by using historicalaverages, by defining a global value, or by defining a value at each cluster level. This value is used forcalculating the virtual machine cost allocation.

VMware vCloud Automation CenterIT Business Management Standard Edition has tight integration with vCloud Automation Center.IT Business Management Standard Edition appears as a tab, named as Business Management, in thevCloud Automation Center user interface shell. IT Business Management Standard Edition uses thecommon services of vCloud Automation Center such as SSO authentication and authorization. TheInfrastructure as a Service (IaaS) component of vCloud Automation Center consumes the base rate APIs ofIT Business Management Standard Edition to compute blueprint price of virtual machine.IT Business Management Standard Edition also has data integration with IaaS component ofvCloud Automation Center. You can define rules and categorize according to vCloud Automation Centerhierarchy. For more information, see Demand Analysis in the IT Business Management Standard Edition User'sGuide.

Amazon Web ServicesIT Business Management Standard Edition provides the users of IT Business Management Standard Editionan overview of how their investments are being spread across Amazon Web Services (AWS) public cloud.IT Business Management Standard Edition integrates with AWS and provides detailed analysis of the billsof AWS.

Chapter 1 Introduction to IT Business Management Standard Edition

VMware, Inc. 11

Page 12: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

IT Business Management Standard Edition Installation and Administration Guide

12 VMware, Inc.

Page 13: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

InstallingIT Business Management StandardEdition 2

You can install IT Business Management Standard Edition as a virtual appliance on a vCenter Server or as avApp on vCloud Director.

This chapter includes the following topics:

n “IT Business Management Standard Edition System Requirements,” on page 14

n “IT Business Management Standard Edition Deployment Scenarios and Best Practices,” on page 15

n “Deploy IT Business Management Standard Edition in vSphere,” on page 15

n “Deploy IT Business Management Standard Edition in vCloud Director,” on page 16

n “Start the IT Business Management Standard Edition Appliance,” on page 17

n “Configure IT Business Management Standard Edition with vCloud Automation Center,” on page 18

n “Create a Tenant in vCloud Automation Center User Interface,” on page 19

n “Access IT Business Management Standard Edition by Using vCloud Automation Center,” onpage 20

n “Unregister IT Business Management Standard Edition from vCloud Automation Center,” onpage 21

n “Configure NTP Server,” on page 22

n “Change SSL Certificates,” on page 22

n “Change Root Password,” on page 23

VMware, Inc. 13

Page 14: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

IT Business Management Standard Edition System RequirementsBefore you install IT Business Management Standard Edition, verify that minimum hardware and softwarerequirements are met.

IT Business Management Standard Edition Disk and Memory RequirementIT Business Management Standard Edition requires a minimum of 50GB of disk space, 4GB memory, and 2vCPU.

Port RequirementsFollowing ports should be open for communication between different entities.

Port Description

443 For IT Business Management Standard Edition user interface connection through HTTPS

22 For external SSH connection

5432 For vPostgres instance. By default, this port is used with loopback address and not accessible to outside world.

5480 For Web console access

Virtualization Software RequirementsBefore you install the IT Business Management Standard Edition virtual appliance, your environment mustmeet certain requirements.

n VMware ESXi 5.0 or 5.1. See vSphere documentation at https://www.vmware.com/support/pubs/vsphere-esxi-vcenter-server-pubs.html.

n vCenter Server 5.0 or 5.1. See vSphere documentation at https://www.vmware.com/support/pubs/vsphere-esxi-vcenter-server-pubs.html.

n vCloud Automation Center 6.0.x release. See vCloud Automation Center 6.0.x documentation.

NOTE If you want to deploy IT Business Management Standard Edition on VMware vCloud Director, verifythat VMware vCloud Director 5.1 or 5.1.1 is already deployed in your environment.

The IT Business Management Standard Edition user interface appears as the Business Management tab onthe vCloud Automation Center user interface shell.

Web Interface SupportBecause IT Business Management Standard Edition is integrated with vCloud Automation Center, you canuse all of the browsers that vCloud Automation Center supports.

n Microsoft Internet Explorer 10.0. In Internet Explorer, select Tools > Compatibility View Settings anddisable the Disable intranet sites in Compatibility View check box.

n Google Chrome 30.0 and 31.0.

n Mozilla Firefox 24.0 and 25.0.

IT Business Management Standard Edition Installation and Administration Guide

14 VMware, Inc.

Page 15: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

You must have the VMRC plug-in for vCloud Director installed to work with your browser.

NOTE The screen resolution must be above 1024x768 to view the completeIT Business Management Standard Edition user interface. If you set the resolution to 1024x768 or lower, youmight not see all the options on the user interface such as, System Status and Help and also tabs such as,Public clouds and Reports. To view the complete IT Business Management Standard Edition Standard userinterface, zoom out the browser or increase the screen resolution.

IT Business Management Standard Edition Deployment Scenarios andBest Practices

You can deploy the IT Business Management Standard Edition appliance on vCloud Automation Centerstandalone and on vCloud Automation Center with the Infrastructure as a Service (IaaS) componentintegrated.

IT Business Management Standard Edition Standalone1 Deploy and configure VMware identity virtual appliance (SSO).

2 Deploy the vCloud Automation Center virtual appliance and configure to point to identity virtualappliance.

3 Deploy the IT Business Management Standard Edition virtual appliance and then registerIT Business Management Standard Edition with vCloud Automation Center. For more information, seevCloud Automation Center Installation Guide for 6.0.x.

IT Business Management Standard Edition with vCloud Automation CenterIf vCloud Automation Center is present in your environment, deploy theIT Business Management Standard Edition virtual appliance and register with existingvCloud Automation Center.

Best Practicesn Deploy IT Business Management Standard Edition in the same LAN where your vCenter Server setups

are deployed.

n Do not deploy the setups over a WAN. Performance over WAN in such cases might be degraded.

n Keep IT Business Management Standard Edition, vCenter Server, VMware identity virtual appliance,and vCloud Automation Center in the same timezone. Otherwise, data synchronization might bedelayed.

Deploy IT Business Management Standard Edition in vSphereYou can deploy the IT Business Management Standard Edition virtual appliance by using vSphere Client onthe vCenter Server. The IT Business Management Standard Edition virtual appliance is in an OVA format.

Prerequisites

n Log in to the vSphere Client as a user with administrator privileges.

n Verify that your system meets all the requirements as described in “IT Business Management StandardEdition System Requirements,” on page 14.

n Verify that you have deployed and configured the VMware identity virtual appliance in your cloudenvironment. See vCloud Automation Center Installation Guide for 6.0.x.

Chapter 2 Installing IT Business Management Standard Edition

VMware, Inc. 15

Page 16: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

n Verify that you have deployed and configured the vCloud Automation Center virtual appliance in yourcloud environment. See vCloud Automation Center Installation Guide for 6.0.x.

Procedure

1 In the vSphere Client, select File > Deploy OVF Template.

2 Browse to the OVA file, select it, and click Next.

3 On the OVF Template Details pane, click Next.

4 Accept the End User License Agreement and click Next.

5 On the Name and Location pane, type a unique virtual appliance name according to the IT namingconvention of your organization and click Next.

If more than one data center is present, select the data center on which to deploy the virtual appliance.

6 On the Host/Cluster pane, select the host or cluster on which to deploy the virtual appliance, and clickNext.

7 On the Storage pane, select the storage location on which to store the virtual appliance, and click Next.

8 On the Disk Format pane, select Thick Provision Lazy Zeroed as the disk format and click Next.

9 On the Properties pane, configure the default gateway, DNS, static IP address, and netmask values, andclick Next.

NOTE It is recommended to configure the default gateway, DNS, IP address, and netmask valuesmanually.

10 Select Power on after deployment, and click Finish to confirm the settings and begin the deployment.

The process of deploying the IT Business Management Standard Edition virtual appliance might take fewminutes.

What to do next

Start your appliance and set the currency of your choice. See “Start the IT Business Management StandardEdition Appliance,” on page 17.

Deploy IT Business Management Standard Edition in vCloud DirectorTo install IT Business Management Standard Edition in vCloud Director, you must download the appliance.For information about adding vApps, see the vCloud Director documentation.

Prerequisites

n Log in to the vCloud Director as a user with administrator privileges.

n Verify that the system meets all the requirements as described in “IT Business Management StandardEdition System Requirements,” on page 14.

n Verify that you have deployed and configured the VMware identity virtual appliance in your cloudenvironment. See vCloud Automation Center Installation Guide for 6.0.x.

n Verify that you have deployed and configured the vCloud Automation Center virtual appliance in yourcloud environment. See vCloud Automation Center Installation Guide for 6.0.x.

n Convert OVA format to OVF format. See https://www.vmware.com/support/developer/ovf/. Verify thatthe .ovf and .vmdk files are in the same folder.

IT Business Management Standard Edition Installation and Administration Guide

16 VMware, Inc.

Page 17: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

Procedure

1 Log in to vCloud Director and select the organization in which to deployIT Business Management Standard Edition.

2 Select the Catalog and click the vApp Templates tab.

3 Click the Upload icon .

4 In the Upload OVF as a Template window, provide the requested information.

Configure the IP allocation from the static pool.

5 If a certificate warning appears, click OK to continue uploading the appliance.

6 Right-click the uploaded template, select Add to My Cloud, and follow the prompts to add a vApp.

7 Navigate to My Cloud.

8 Right-click the IT Business Management Standard Edition virtual machine and select Properties.

9 On the Guest OS Customization tab, select Enable guest customization, deselect Allow localadministrator password, and click OK.

10 Right-click the newly added vApp and select Start.

What to do next

Start your appliance and set the currency of your choice. See “Start the IT Business Management StandardEdition Appliance,” on page 17.

Start the IT Business Management Standard Edition ApplianceYou must start the newly added vCloud Director vApp or vSphere virtual machine to verify that yourinstallation was successful. You can also set the currency during this process.

Prerequisites

Verify that you have the VMRC plug-in for vCloud Director installed to work with your browser. See “WebInterface Support,” on page 14.

Procedure

1 Open the IT Business Management Standard Edition appliance.

n From vCloud Director, double-click the vApp and select Popout Console.

n From the vSphere Client, locate the powered on virtual machine and click the Console tab.

2 Set the currency for IT Business Management Standard Edition appliance.

The default currency is US Dollar (USD). IT Business Management Standard Edition also supports thefollowing currencies.

Currency Name Supported Abbreviation

Euro EUR

British Pound GBP

Australian Dollar AUD

Canadian Dollar CAD

Singapore Dollar SGD

Japanese Yen JPY

Chapter 2 Installing IT Business Management Standard Edition

VMware, Inc. 17

Page 18: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

Currency Name Supported Abbreviation

Indian Rupee INR

Israeli Shekel ILS

NOTE If you do not select a currency, US Dollar (USD) is selected by default.

3 Navigate to the appliance URL by using a supported browser.

The appliance URL format is https://IT_Business_Management_Standard_Edition_IP_adress:5480.

4 Type the user name as root and password as vmware of the virtual appliance and click Login.

The IT Business Management Standard Edition Web console opens in the browser.

What to do next

For security reason, change the password for the root user. See “Change Root Password,” on page 23.

Configure IT Business Management Standard Edition withvCloud Automation Center

You can use the IT Business Management Standard Edition Web console to configureIT Business Management Standard Edition appliance with vCloud Automation Center.

Prerequisites

Verify that you have deployed and configured the vCloud Automation Center virtual appliance in yourcloud environment.

Procedure

1 Log in to the IT Business Management Standard Edition Web console athttps://IT_Business_Management_Standard_Edition_IP_address:5480.

2 Type the user name and password of the virtual appliance and click Login.

3 On the vCloud Automation Center tab, type the credentials to register with vCloud Automation Centerserver.

Option Description

Hostname Type the host name or IP address of the vCloud Automation Center virtual appliance.

SSO Default Tenant Type the SSO default tenant name that you have defined while configuring yourvCloud Automation Center virtual appliance.

SSO Admin User Type the administrator user name that you have defined while configuring yourvCloud Automation Center virtual appliance.

SSO Admin Password Type the administrator password that you have defined while configuring yourvCloud Automation Center virtual appliance.

IT Business Management Standard Edition Installation and Administration Guide

18 VMware, Inc.

Page 19: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

4 Register IT Business Management Standard Edition with vCloud Automation Center.

Option Action

If you are registering for the firsttime or if vCloud Automation Centercertificate has changed

a Click Register. Registration fails and Failed to register withvCloud Automation Center message appears.

b (Optional) To view the vCloud Automation Center certificate, clickView vCloud Automation Center certificate link.

c Click Accept vCloud Automation Center certificate check box.d Click Register.

If vCloud Automation Center isalready registered

a Click Register.

If all the parameters are correct, a Registered with vCloud Automation Center server messageappears.

NOTE If you change the certificate of vCloud Automation Center, you need to again registerIT Business Management Standard Edition with IT Business Management Standard Edition.

Create a Tenant in vCloud Automation Center User InterfaceTo access the IT Business Management Standard Edition through the vCloud Automation Center userinterface, you must create a IT Business Management Standard Edition tenant invCloud Automation Center.

Prerequisites

Verify that you have deployed and configured the vCloud Automation Center virtual appliance in yourcloud environment.

Procedure

1 Log in to the vCloud Automation Center user interface athttps://vCloud_Automation_Center_host_name/shell-ui-app.

Use SSO administrator credentials to log in.

2 On the Tenants tab, click the Add Tenant icon .

3 On the General tab, type the details of your tenant and click Next.

Option Description

Name Type the name of the tenant.

Description (Optional) Type the description of the tenant.

URL Name Type the URL name that identifies the tenant.

Contact Email (Optional) Type an email address of the user.

4 To provide LDAP or active directory details, on the Identity Stores tab, click the Add Tenant icon.

Option Description

Name Name of your LDAP or active directory server.

Type Type of authentication, open LDAP or active directory.

URL URL for Open LDAP or active directory. For open LDAP and active directory, use theformat ldap://host name:port or ldaps://host name:port

Domain Domain DNS name.

Domain Alias Domain NetBIOS name.

Chapter 2 Installing IT Business Management Standard Edition

VMware, Inc. 19

Page 20: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

Option Description

Login User DN Name of the domain that user logs in to.

Password Password for authentication purpose.

Group Search Base DN Base domain name for groups.

User Search Base DN Base domain name for users.

5 Click Test Connection.

If the connection is successful, the Connection is available message appears.

6 Click Add and click Next.

7 On the Tenant Admins tab, select users and groups from your identity stores to grant the tenantadministrator role.

8 Click Add.

9 Log out from the application.

Example: Values to Set an LDAP or Active Directory Connection

Option Example Value

URL ldap://IP adress:389

Domain example.com

Domain Alias example

Login User DN cn=admin,dc=example,dc=com

Group Search Base DN dc=example,dc=com

User Search Base DN dc=example,dc=com

Access IT Business Management Standard Edition by UsingvCloud Automation Center

You can access the IT Business Management Standard Edition user interface after logging in to thevCloud Automation Center user interface. IT Business Management Standard Edition user interface appearsas a tab in the vCloud Automation Center user interface.

Prerequisites

Verify that you have created a IT Business Management Standard Edition tenant. See “Create a Tenant invCloud Automation Center User Interface,” on page 19.

Procedure

1 Log in to the vCloud Automation Center interface at https://vCloud_Automation_Center_host_name/shell-ui-app/org/tenant_URL by using credentials of a tenant administrator.

2 Click the Administration tab.

3 Click Users.

4 Search and select the user to which you want to add the role.

5 From the Add Roles to this User box, assign the Business Management Administrator or BusinessManagement Read only user privileges to the user.

6 Click Update.

IT Business Management Standard Edition Installation and Administration Guide

20 VMware, Inc.

Page 21: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

7 Refresh the browser.

The Business Management tab is available in the vCloud Automation Center user interface.

What to do next

If you are accessing the Business Management tab for the first time, you need to provide a validIT Business Management Standard Edition license. After adding a valid license, you can useIT Business Management Standard Edition user interface. You can also updateIT Business Management Standard Edition license. See “Update Licenses for IT Business ManagementStandard Edition,” on page 30.

Unregister IT Business Management Standard Edition fromvCloud Automation Center

If you want to deploy a new version of IT Business Management Standard Edition appliance, you need tofirst unregister the earlier instance of IT Business Management Standard Edition appliance fromvCloud Automation Center.

Procedure

1 Log in to the IT Business Management Standard Edition Web console,https://IT_Business_Management_Standard_Edition_IP_address:5480.

2 Type the user name and password of the virtual appliance and click Login.

3 On the vCloud Automation Center tab, type the credentials of already registeredvCloud Automation Center server.

Component Description

Hostname The host name or IP address of the vCloud Automation Center virtual appliance.

SSO Default Tenant The name of the SSO default tenant that you have defined while configuring yourvCloud Automation Center virtual appliance.

SSO Admin User The administration user name that you have defined while configuring yourvCloud Automation Center virtual appliance.

SSO Admin Password The administrator password that you have defined while configuring yourvCloud Automation Center virtual appliance.

4 Click Unregister.

If all the parameters are correct, a Unregistered with vCloud Automation Center server message isdisplayed.

NOTE If vCloud Automation Center certificate has changed, unregisterIT Business Management Standard Edition from vCloud Automation Center fails. To avoid the failure,unregister and then re-register IT Business Management Standard Edition withvCloud Automation Center.

What to do next

Follow the process of deploying the IT Business Management Standard Edition appliance as described in “Deploy IT Business Management Standard Edition in vSphere,” on page 15.

Chapter 2 Installing IT Business Management Standard Edition

VMware, Inc. 21

Page 22: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

Configure NTP ServerYou can configure the Network Time Protocol (NTP) server for periodic time synchronization. NTP is anindustry standard and ensures accurate timekeeping in your guest.

Procedure

1 Log in to the IT Business Management Standard Edition virtual machine console.

2 Navigate to /etc/ntp.conf and add the command.

server %my-ntp-server%

fudge %my-ntp-server% stratum int

server %my-ntp-server% is the IP address or full qualified domain name of the NTP server. stratum intspecifies the stratum number assigned to the driver in the range 0 to 15, both inclusive. This numberoverrides the default stratum number assigned by the driver.

3 Check the status of NTP server by running the chkconfig -a ntp command.

4 If the service is running, restart the service. If the service is not started, start the service by running theservice ntp start command.

5 Disable the time synchronization by VMware Tools by running the /usr/bin/vmware-toolbox-cmdtimesync disable command.

6 To verify the status of NTP server, run the ntpq -pn command.

Change SSL CertificatesYou can manually create a new Java SSL key store with the private key and import the certificate that isissued by Certifying Authority (CA).

The new ssl.keystore replaces the old key store with the same password as that of the old key storeat /usr/local/tcserver/vfabric-tc-server-standard/tcinstance1/conf/ssl.keystore.

Prerequisites

Take a backup of existing key store if you want to restore the old key store again.

Procedure

1 Navigate to /usr/local/tcserver/vfabric-tc-server-standard/tcinstance1/bin/setenv.sh to locatethe old password for the key store provided as a property for tomcat keystorejavax.net.ssl.trustStorePassword=<password>.

2 Create a PKCS12 key store file. For example,openssl pkcs12 -export -in <ca_provided_cert>.crt -inkey server.key -out keystore.p12 -name

tomcat -CAfile ca.crt -caname <CA Name>.

3 Convert the pkcs12 file to a Java key store. For example,keytool -importkeystore -deststorepass <password> -destkeypass <password> -destkeystore

server.keystore -srckeystore keystore.p12 -srcstoretype PKCS12 -srcstorepass

<SOURCE_P12_KEYSTORE_PASSWORD> -alias tomcat

Where <password> is the auto-generated password for old key store in the propertyjavax.net.ssl.trustStorePassword.

IT Business Management Standard Edition Installation and Administration Guide

22 VMware, Inc.

Page 23: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

4 Log in to the IT Business Management Standard Edition Web console and registerIT Business Management Standard Edition with vCloud Automation Center. This ensures thatvCloud Automation Center is added to the newly created key store.

You have the choice of exporting the existing certificates from old ssl.keystore and then import them inthe new key store. For this scenario, accepting the certificate fromIT Business Management Standard Edition Web console is not needed. Restart ofIT Business Management Standard Edition server is sufficient.

Change Root PasswordFor security reasons, you must change the password for the root user ofIT Business Management Standard Edition virtual appliance after installation.

Procedure

1 Log in to the IT Business Management Standard Edition virtual appliance either through SSH or thephysical console.

2 Type passwd root command.

3 Type the new password.

4 Re-type the password for confirmation.

IT Business Management Standard Edition virtual appliance password is changed successfully.

Chapter 2 Installing IT Business Management Standard Edition

VMware, Inc. 23

Page 24: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

IT Business Management Standard Edition Installation and Administration Guide

24 VMware, Inc.

Page 25: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

Setting UpIT Business Management StandardEdition 3

After you deploy IT Business Management Standard Edition, you must manage the vCenter Serverinstances by adding them to IT Business Management Standard Edition. You can also update the referencedatabase, manage vCloud Director instances, manage public cloud accounts, download a support file, andupdate the license key for IT Business Management Standard Edition.

This chapter includes the following topics:

n “IT Business Management Standard Edition Administration,” on page 25

n “View and Update System Status,” on page 31

IT Business Management Standard Edition AdministrationBefore you start using the IT Business Management Standard Edition appliance, you must set up theIT Business Management Standard Edition appliance to work in your virtual environment.

You can perform operations like adding vCenter Server instances, updating a reference database, updatingthe license key, and downloading support file information.

n Add vCenter Server to IT Business Management Standard Edition by entering vCenter Server details.You can add up to four vCenter Server instances.

n Add vCloud Director to IT Business Management Standard Edition by entering vCloud Director details.

n Manage public cloud accounts, for example Amazon Web Services (AWS).

n Update the reference database to reflect the most current data. You can either update the referencesdatabase manually or by running an auto update feature.

n Download the support file containing critical runtime information about the system.

n Update the license key.

n Generate a token that you can use to define a connection betweenIT Business Management Advanced and Enterprise Edition andIT Business Management Standard Edition.

n Provide the CPU, RAM, and storage unit rates to vCloud Automation Center.vCloud Automation Center uses an API to compute the blueprint price of a virtual machine.

NOTE This data is not used anywhere in IT Business Management Standard Edition for any form ofcost computation.

VMware, Inc. 25

Page 26: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

Add vCenter Server InstancesAfter you install IT Business Management Standard Edition, you can add a vCenter Server instance toIT Business Management Standard Edition to enable vCenter Server management and retrieve the inventoryinformation from your virtual environment. You can add up to four vCenter Server instances.

Prerequisites

To add vCenter Server to IT Business Management Standard Edition, you need the credentials of thevCenter Server user. The vCenter Server user must have some additional permissions apart from the normalRead-only role that is assigned to a vCenter Server user. To add additional permissions to thevCenter Server user, perform the following steps.

1 Log into vCenter Server as an administrative user and create a clone of the Read-only role in avCenter Server.

2 Include the Storage views.View, Profile-driven storage.Profile-driven storage view permissions tothis cloned role. Include Global.vCenter Operations User also if you have integrated vCenter Serverwith VMware vCenter Operations Manager.

3 Create a user in vCenter Server for IT Business Management Standard Edition and assign this clonedrole to the user.

Procedure

1 Log in to the vCloud Automation Center interface at https://vCloud_Automation_Center_host_name/shell-ui-app/org/tenant_URL by using credentials of a tenant administrator.

2 Click the Administration tab.

3 Click Business Management.

4 Click the General link.

This link is selected by default.

5 Under Manage vCenter Server connections, click the icon.

6 Type the IP address, user name, and password of the vCenter Server that you want to add.

7 Click Save.

A dialog with untrusted SSL certificate is displayed.

8 Click Install.

If the credentials are valid, vCenter Server is added to the IT Business Management Standard Edition.Refresh the browser to view the added vCenter Server.

NOTE After addition of vCenter Server to IT Business Management Standard Edition, if thevCenter Server certificate changes, data collection fails because vCenter Server presents a newcertificate, which might again be untrusted. You must add the vCenter Server again and accept the newvCenter Server certificate. You can edit the vCenter Server details by clicking the icon and then acceptthe new vCenter Server certificate.

IT Business Management Standard Edition Installation and Administration Guide

26 VMware, Inc.

Page 27: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

Edit or Delete vCenter Server InstancesYou can edit or delete vCenter Server instances from IT Business Management Standard Edition. You canuse the edit functionality to update the vCenter Server information after certificate of vCenter Serverchanges.

Procedure

1 Log in to the vCloud Automation Center interface at https://vCloud_Automation_Center_host_name/shell-ui-app/org/tenant_URL by using credentials of a tenant administrator.

2 Click the Administration tab.

3 Click Business Management.

4 Click the General link.

This link is selected by default.

5 To edit the vCenter Server, click the icon.

6 Modify the details and click Save.

7 To delete vCenter Server, click the icon and click Save.

8 (Optional) You can retrieve vCenter Server that you have deleted by clicking Revert.

Add vCloud Director InstancesYou can add vCloud Director instances to IT Business Management Standard Edition to get vCloud Directorbased categorization.

If you add vCloud Director to IT Business Management Standard Edition, you can categorize the dataaccording the vCloud Director hierarchy.

Procedure

1 Log in to the vCloud Automation Center interface at https://vCloud_Automation_Center_host_name/shell-ui-app/org/tenant_URL by using credentials of a tenant administrator.

2 Click the Administration tab.

3 Click Business Management.

4 Click the General link.

5 Under Manage vCloud Director, click the icon.

6 Type the IP address, user name, and password of vCloud Director that you want to add.

7 Click Save.

A dialog with untrusted SSL certificate is displayed.

8 Click Install.

If the credentials are valid, vCloud Director is added to the IT Business Management Standard Edition.Refresh the browser to view to added vCloud Director.

NOTE After addition of vCloud Director to IT Business Management Standard Edition, if thevCloud Director certificate changes, data collection fails because vCloud Director presents a newcertificate, which might again be untrusted. You must add the vCloud Director again and accept thenew vCenter Server certificate. You can edit the vCloud Director details by clicking the icon and thenaccept the new vCloud Director certificate.

Chapter 3 Setting Up IT Business Management Standard Edition

VMware, Inc. 27

Page 28: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

Edit or Delete vCloud Director InstancesYou can edit or delete vCloud Director instances from IT Business Management Standard Edition. You canuse the edit functionality to update the vCloud Director information after certificate of vCloud Directorchanges.

Procedure

1 Log in to the vCloud Automation Center interface at https://vCloud_Automation_Center_host_name/shell-ui-app/org/tenant_URL by using credentials of a tenant administrator.

2 Click the Administration tab.

3 Click Business Management.

4 Click the General link.

This link is selected by default.

5 To edit the vCloud Director, click the icon.

6 Modify the details and click Save.

7 To delete vCloud Director, click the icon and click Save.

8 (Optional) You can retrieve vCloud Director that you have deleted by clicking Revert.

Manage Amazon Web Services AccountYou can add or modify an AWS account that you want to track and analyze by usingIT Business Management Standard Edition.

Prerequisites

Verify that you have an account ID, access key, secret key, and S3 bucket name. For more information, see ITBusiness Management Standard Edition User's guide.

Procedure

1 Log in to the vCloud Automation Center interface at https://vCloud_Automation_Center_host_name/shell-ui-app/org/tenant_URL by using credentials of a tenant administrator.

2 Click the Administration tab.

3 Click Business Management.

4 Click the General link.

5 Under Manage Public Cloud Account, to add the AWS account details, click the add icon .

6 Type the name, description, account ID, access key, secret key, and S3 bucket name.

7 Click Save.

If all the information regarding AWS account that you provided is correct,IT Business Management Standard Edition adds the AWS account.IT Business Management Standard Edition starts populating the dashboard information after a fewminutes. Currently, IT Business Management Standard Edition refreshes its data by connecting to AWSevery 30 minutes. You can force run the AWS collection job from the System Status menu.

8 (Optional) To modify the details of an AWS account, click the icon, edit the information, and clickSave.

If the information that you have provided is correct, the AWS account details are modified and saved.

IT Business Management Standard Edition Installation and Administration Guide

28 VMware, Inc.

Page 29: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

9 (Optional) To delete an AWS account, click the icon and click Save.

You can retrieve the AWS account that you have deleted by clicking Revert.

Update the Reference Database for IT Business Management Standard EditionYou can update the reference database to have the most updated version of the reference library. You caneither update the references database manually or by running an auto-update feature. This referencedatabase supplies values for cost calculations.

Prerequisites

For auto-update process, verify that port 22 is open so that IT Business Management Standard Edition canaccess SaasFTP.digitalfuel.com to start the auto update process.

Procedure

1 Log in to the vCloud Automation Center interface at https://vCloud_Automation_Center_host_name/shell-ui-app/org/tenant_URL by using credentials of a tenant administrator.

2 Click the Administration tab.

3 Click Business Management.

4 Click the General link.

Under Reference Database, the current version of reference library appears.

5 If an auto update is available, click the icon, which is displayed next to Status.

The Reference Database section of Administration page appears.

a Click Run auto update link.

b Accept the legal agreement.

The reference database is updated.

6 To manually update the reference database, click manual update process link.

a Click Generate and download file link. An encrypted Zip file with the required data isdownloaded to your default download folder.

b Contact VMware customer support and provide them with the Zip file that you have generated.Depending on the information that you have provided, an updated reference costs file will begenerated for you.

c Click Browse and select the file.

d Click Done.

The reference database is updated.

Generate and Download the Support FileYou can download the support file, which contains critical runtime information about the system.

Procedure

1 Log in to the vCloud Automation Center interface at https://vCloud_Automation_Center_host_name/shell-ui-app/org/tenant_URL by using credentials of a tenant administrator.

2 Click the Administration tab.

3 Click Business Management.

4 Click the General link.

Chapter 3 Setting Up IT Business Management Standard Edition

VMware, Inc. 29

Page 30: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

5 Under Support File, click Generate and download file.

6 Save the file.

The support file is saved as an archive file.

This Zip file includes the itfm-vc-dc.log, which contains information about data collector issues anditfm.log is an application log file that contains information about all the other processes, thread dump, andother metrics.

Update Licenses for IT Business Management Standard EditionYou can update the license of IT Business Management Standard Edition by using the Update Licensefeature.

Procedure

1 Log in to the vCloud Automation Center interface at https://vCloud_Automation_Center_host_name/shell-ui-app/org/tenant_URL by using credentials of a tenant administrator.

2 Click the Administration tab.

3 Click Business Management.

4 Click the General link.

Under Update License, IT Business Management Standard Edition displays the current license serialkey number, license type, maximum number of virtual machines that the entered license key allows,and the number of virtual machines that are currently running in your environment.

5 In the New Serial text box, type the new license key.

6 Click Update.

If the new license key is valid, the license is updated.

Generate Token for IT Business Management Advanced and Enterprise EditionIntegration

You can generate a token and IT Business Management Standard Edition host URL fromIT Business Management Standard Edition. You can also download the certificate file that you can import inIT Business Management Advanced and Enterprise Edition.

Procedure

1 Log in to the vCloud Automation Center interface at https://vCloud_Automation_Center_host_name/shell-ui-app/org/tenant_URL by using credentials of a tenant administrator.

2 Click the Administration tab.

3 Click Business Management.

4 Click the General link.

5 Under ITBM token, click Generate a new ITBM token.

IT Business Management Standard Edition generates a token andIT Business Management Standard Edition host URL.

6 Click Download Certificate file and select the location where you want to save the certificate file.

You can use this information to define a connection betweenIT Business Management Advanced and Enterprise Edition and IT Business Management Standard Edition.

IT Business Management Standard Edition Installation and Administration Guide

30 VMware, Inc.

Page 31: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

What to do next

For detailed process of integration between IT Business Management Advanced and Enterprise Edition andIT Business Management Standard Edition, see IT Business Management Enterprise and Advanced EditionInstallation guide.

Compute the Blueprint Price of a Virtual MachineYou can update the vCPU, RAM, and storage prices, which vCloud Automation Center can consume, byusing an API to compute the blueprint price of a virtual machine.

vCloud Automation Center cost profile information from IT Business Management Standard Edition thatvCloud Automation Center can use to calculate blueprint price of a virtual machine.

Procedure

1 Log in to the vCloud Automation Center interface at https://vCloud_Automation_Center_host_name/shell-ui-app/org/tenant_URL by using credentials of a tenant administrator.

2 Click the Administration tab.

3 Click Business Management.

4 Click the Pricing link.

5 Set the vCPU, RAM, and storage values.

Option Action

Set the same values for cost andprice.

Select the Set default prices for computing and storage check box.

Set your own values for prices ofRAM and vCPU.

Select Manually set prices for computing and storage check box.

IT Business Management Standard Edition does not use these values for cost calculation andpresentation.

6 Click Save.

The prices of vCPU, RAM, and storage are updated. vCloud Automation Center can use these prices tocompute the blueprint price of a virtual machine.

View and Update System StatusYou can view and update the status of critical internal business processes and understand the overall systemhealth. The system processes run periodically to ensure that your inventory and cost data are alwayscurrent.

n Data collector connects to vCenter Server instances and collects the inventory data and usage statistics.After collection of inventory data and usage statistics finishes,IT Business Management Standard Edition displays timestamp in GMT.

n Cost calculation involves the steps for computing base rates, allocated costs, cost for each virtualmachine, classification of virtual machines under Consumers tab and pre-generation of reports. Costcalculation occurs daily, but you can also run the process manually.

n vCloud Automation Center connector collects data about consumers of a virtual machine in terms ofblueprints, provisioning groups and tenants from IaaS component of vCloud Automation Center.vCloud Automation Center connection information appears only after you configure IaaS component ofvCloud Automation Center.

n Public cloud connection connects to the listed accounts in AWS to collect inventory and usage data.Public cloud connection information appears only after you configure an AWS account.

Chapter 3 Setting Up IT Business Management Standard Edition

VMware, Inc. 31

Page 32: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

n vCloud Director connector connects to vCloud Director to collect data about consumers of the virtualmachine according to organization and organization vDC. vCloud Director connection informationappears only after you add vCloud Director to IT Business Management Standard Edition.

You can also view and update cost calculation and public cloud connection information.

Procedure

1 Log in to the vCloud Automation Center interface at https://vCloud_Automation_Center_host_name/shell-ui-app/org/tenant_URL by using credentials of a tenant administrator.

2 Click Business Management.

3 Click Status.

IT Business Management Standard Edition displays the system status information. Information relatedto data collector, cost calculation, vCloud Automation Center, public cloud connection, andvCloud Director connection is displayed. If all the processes are running correctly a green check mark

is displayed. If any problem with any of the processes occur, a red exclamation icon is displayed.To further analyze the issues with the processes, view the itfm-vc-dc.log for data collector process anditfm.log for all the other processes.

4 (Optional) To update the cost calculation and public cloud connection, click Update now.

IT Business Management Standard Edition Installation and Administration Guide

32 VMware, Inc.

Page 33: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

TroubleshootingIT Business Management StandardEdition 4

You can troubleshoot IT Business Management Standard Edition for some of the common problems thatmight occur when installing or using IT Business Management Standard Edition.

This chapter includes the following topics:

n “Error While Accessing Business Management Tab,” on page 33

n “vCloud Automation Center Synchronization Job Fails,” on page 33

n “Business Management tab does not appear,” on page 34

n “IT Business Management Standard Edition and vCloud Automation Center Connection Failure,” onpage 34

n “IT Business Management Standard Edition Displays an Exception while Parsing XML Documents,”on page 35

Error While Accessing Business Management TabAn error message is displayed when you attempt to access the Business Management tab after registeringwith vCloud Automation Center.

Problem

After registering IT Business Management Standard Edition with vCloud Automation Center, if you clickthe Business Management tab in vCloud Automation Center user interface, an Error 404 message isdisplayed.

Solution

1 Log in to the IT Business Management Standard Edition virtual machine.

2 Run the monit restart vcbm-server command.

The server restarts in 20 to 30 seconds. You can find the log file at /usr/local/tcserver/vfabric-tc-server/tcinstance1/logs/itfm.log.

vCloud Automation Center Synchronization Job FailsYou might be unable to retrieve tenant, blueprints, and business group information fromvCloud Automation Center because synchronization job fails.

Problem

With the IaaS component of vCloud Automation Center integrated with IT Business Management StandardEdition, the synchronization job shows java.lang.NullPointerException.

VMware, Inc. 33

Page 34: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

Cause

This problem occurs if you add the vCenter Server to vCloud Automation Center, but the samevCenter Server is not added to IT Business Management Standard Edition.

Solution

u Add the vCenter Server that you have added to vCloud Automation Center toIT Business Management Standard Edition.

After you add the vCenter Server and complete the inventory synchronization inIT Business Management Standard Edition, blueprints, tenants, and business group informationbecomes available.

Business Management tab does not appearAfter registering IT Business Management Standard Edition with vCloud Automation Center, BusinessManagement tab does not appear in the vCloud Automation Center user interface.

Problem

After registering IT Business Management Standard Edition with vCloud Automation Center and addingBusiness Management role to the user, Business Management tab does not appear in thevCloud Automation Center user interface. No error is reported in the log file.

Cause

This problem occurs because a known issue of restrictions on extension visibility when IaaS component ofvCloud Automation Center is not available.

Solution

1 Create extension.properties file under /etc/vcac and hide the home page tab, .

shell.disabledExtensions=csp.home

You can hide other tabs by using shell.disabledExtensions=<extension-id>[,<extension-id>].

2 Restart the vCloud Automation Center virtual appliance.

3 Log in to the vCloud Automation Center interface. Business Management tab should appear.

IT Business Management Standard Edition andvCloud Automation Center Connection Failure

An error message is displayed after registering IT Business Management Standard Edition withvCloud Automation Center.

Problem

After you register IT Business Management Standard Edition with vCloud Automation Center and then ifyou navigate to Administration > Business Management java.net.NoRouteToHostException: No route tohost error message is displayed.

Cause

This problem can occur if the IP address of IT Business Management Standard Edition virtual appliancechanged after IT Business Management Standard Edition is registered with vCloud Automation Center. Toconfirm the issue.

1 Log in to IT Business Management Standard Edition by using SSH.

IT Business Management Standard Edition Installation and Administration Guide

34 VMware, Inc.

Page 35: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

2 Type the command /usr/local/tcserver/vfabric-tc-server-standard/tcinstance1/conf/security.properties. This file should contain the propertyvcbm.host=<ip_address>. Check if this IP address is same as that ofIT Business Management Standard Edition virtual appliance.

Solution

n Deploy a new instance of IT Business Management Standard Edition virtual appliance.

a Unregister from IT Business Management Standard Edition.

b Remove IT Business Management Standard Edition virtual appliance from your environment.

c Deploy a new instance of IT Business Management Standard Edition with static IP and fully-qualified domain name.

d Register IT Business Management Standard Edition with vCloud Automation Center.

n If you do not want to deploy a new instance of IT Business Management Standard Edition, perform thefollowing workaround.

a Unregister IT Business Management Standard Edition with vCloud Automation Center.

b Change the IP address in the file /usr/local/tcserver/vfabric-tc-server-standard/tcinstance1/conf/security.properties to correct IP address.

c Re-create the SSL key store file /usr/local/tcserver/vfabric-tc-server-standard/tcinstance1/conf/ssl.keystore with correct IP address and fully-qualified domainname. The key store requires the password. You can fiind the auto-generated password in thefile /usr/local/tcserver/vfabric-tc-server-standard/tcinstance1/bin/setenv.sh given asproperty for tomcat keystore javax.net.ssl.trustStorePassword=<password>. For example, run thecommand keytool -genkey -keystore ssl.keystore -dname CN=<ITBM-VM-IP-Address> -extsan=DNS:<ITBM-FQDN> -alias tomcat -storepass <password> -keypass <password> fromdirectory /usr/local/tcserver/vfabric-tc-server-standard/tcinstance1/conf. Make sure youtake the back up of ssl.keystore before creating a new one.

d Register IT Business Management Standard Edition with vCloud Automation Center.

IT Business Management Standard Edition Displays an Exceptionwhile Parsing XML Documents

IT Business Management Standard Edition displays an exception while parsing XML Documents becauseJava has introduced a counter for each process that limits the XML entity expansions. After the counterreaches its limit, further communication with XML documents might not work.

Problem

This exception occurs because JDK 1.7u45 has a functional bug while parsing XML documents. After thecounter reaches the limit of 64000 an exception is displayed.

Exception in thread "main" javax.xml.stream.XMLStreamException: ParseError at [row,col]:[1,1]

Message: JAXP00010001: The parser has encountered more than "64000" entity expansions in this

document; this is the limit imposed by the JDK.

at

com.sun.org.apache.xerces.internal.impl.XMLStreamReaderImpl.setInputSource(XMLStreamReaderImpl.ja

va:219)

at com.sun.org.apache.xerces.internal.impl.XMLStreamReaderImpl.<init>(XMLStreamReaderImpl.java:

189)

at

com.sun.xml.internal.stream.XMLInputFactoryImpl.getXMLStreamReaderImpl(XMLInputFactoryImpl.java:

277)

Chapter 4 Troubleshooting IT Business Management Standard Edition

VMware, Inc. 35

Page 36: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

at

com.sun.xml.internal.stream.XMLInputFactoryImpl.createXMLStreamReader(XMLInputFactoryImpl.java:

129)

at com.sun.xml.internal.stream.XMLInputFactoryImpl.createXMLEventReader(XMLInputFactoryImpl.java:

78)

at Main.main(Main.java:38)

Solution

u Restart the IT Business Management Standard Edition server by typing monit restart vcbm-servercommand.

IT Business Management Standard Edition Installation and Administration Guide

36 VMware, Inc.

Page 37: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

Index

Aaccess user interface 20accessing IT Business Management Standard

Edition 20add tenant 19add AWS account 28add vCenter Server 26add vCloud Director 27administer IT Business Management Standard

Edition 25administering IT Business Management

Standard Edition 25Amazon Web Services integration 10architecture 8AWS account, addition 28

Bbest practices 15blueprint, unavailable 33blueprint price, virtual machine 31business group, unavailable 33Business Management tab error 34business management tab, error 33

Ccapital expenditure 7challenges faced 7challenges 7change SSL certificate 22change root password 23compute blueprint price 31configure IT Business Management Standard

Edition 18configuring NTP server 22cost efficiency 7cost transparency 7cost of delivering 7cost optimization 7create tenant 19creating tenant 19

Ddata collector, status 31data input synchronization 8delete vCenter Server 27

delete vCloud Director 28deploy in vCloud Director 16deploying IT Business Management Standard

Edition 15deployment scenarios 15disk requirement 14DNS, setting up 17

Eedit vCenter Server 27edit vCloud Director 28error, Business Management tab 34error 404 33ESXi requirement 14external interfaces 8

Ggoals, IT Business Management Standard

Edition 7

IIaaS, vCloud Automation Center 15improve operations 7installation process 13installing IT Business Management Standard

Edition 13integration, IT Business Management Advanced

and Enterprise Edition 30intended audience 5inventory data 31IT Business Management Standard Edition

configuration 18IT Business Management Standard Edition

server 8IT Business Management Standard Edition

troubleshoot 33troubleshooting 33

IT Business Management Standard Editiondeployment 15

IT Business Management Standard Editioninstallation 13

IT Business Management Standard Editionredeployment 21

IT Business Management Standard Editionsystem requirements 14

VMware, Inc. 37

Page 38: IT Business Management Standard Edition Installation and Administration … · 2014. 2. 6. · IT Business Management Standard Edition Installation and Administration Guide The VMware®

Kkeystore 22

Llicense key, update 25license update 30log files 29

Mmanage vCenter Server 26manage vCenter servers 25manage vCloud Director 27memory requirement 14

NNTP server, configure 22

Ooperating expenditure 7optimize operations 7

Pparsing XML documents, error 35parsing XML documents, exception 35port requirements 14

Rredeploying IT Business Management Standard

Edition 21reference database 8, 25reference library 29reference database update 29registration failure 34root password 23root password, change 23

Sset up IT Business Management Standard

Edition 25setting host name 17setting DNS 17space requirement 14SSH connection 14SSO tenant 18SSO admin user 18SSO admin password 18starting vApp 17starting virtual machine 17support file, download 25support file download 25, 29supported integrations 10supported Chrome versions 14

supported Internet Explorer versions 14supported Mozilla Firefox versions 14supported web browsers 14synchronization job fails 33synchronization job failure 33system requirements 14

Ttenant, unavailable 33tenant addition 19tenants, creating 19token, generate 30token generation 30total spending 7

Uunregister IT Business Management Standard

Edition 21update license 30update reference database 25, 29update system status 31using vCloud Automation Center user

interface 20

VvCenter Server addition 26vCenter Server certificate 27vCenter Server requirement 14vCloud Automation Center standalone 15vCloud Automation Center integration 10vCloud Automation Center connection failure 34vCloud Director

deploying IT Business Management StandardEdition 16

management 27vCloud Director certificate 28vCloud Director integration 10view system status 31virtualization requirements 14vSphere Web Service, access 14

IT Business Management Standard Edition Installation and Administration Guide

38 VMware, Inc.