Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Note
Before using this information and the product it supports, read the information in Notices on page 17.
Contents
Preface . . . . . . . . . . . . . . . v
Audience
. v
. 1
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 9
10
10
10
10
10
10
10
10
10
10
10
5
6
6
7
Known problems
Error codes . .
9
9
9
9
9
9
9
Chapter 7. Troubleshooting . . . . . . 15
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 15
. 16
Notices . . . . . . . . . . . . . . 17
Trademarks and Service Marks . . . . 19
iii
iv
Preface
This publication documents how to use the IBM Cloud Orchestrator Content Pack
for Opscode Chef.
Audience
This information is intended for content developers of IBM Cloud Orchestrator
who must use or customize the IBM Cloud Orchestrator Content Pack for Opscode
Chef.
vi
Supported versions
v IBM Cloud Orchestrator version 2.4
v Open Source Chef Server version 11.0
Upgrading
If you already have the toolkit installed and are upgrading from SmartCloud
Orchestrator V2.3 to IBM Cloud Orchestrator V2.4, because of changes in the
structure of the self-service catalog and new version 2.4 architecture, you must
make some adjustments manually to clean up the environment so that the toolkits
can run.
Make the following adjustments:
v Remove the "Install Software Modules" and "Deploy Cookbook" user actions
v Remove all the offerings under the category "Chef".
v For information about removing user actions, see IBM Cloud Orchestrator >
Managing orchestration workflows > Orchestration workflows > User actions in
the IBM Knowledge Center.
Procedure
1. Log in to the administrative console - https://<Business Process Manager IP
address>:<Port number>/ibm/console/logon.jsp.
2. Expand Security and click SSL certificate and key management.
3. Under Configuration settings, click Manage endpoint security
configurations.
4. Expand the appropriate Outbound configuration, navigate to and select the
following node: Outbound : xxxxCell1 (CellDefaultSSLSettings) :
nodes :
Node1(NodeDefaultSSLSettings) : servers :
SingleClusterMember1.
5. In Related Items, click Key stores and certificates.
6. Click CellDefaultTrustStore.
7. In Additional Properties, click Signer certificates and Retrieve From Port.
8. Enter your appstore host name in the host name field. Normally, this is the
host name of your Chef server.
9. Enter 443 in the Port field.
10. Enter <Chef Server host name> in the Alias field.
11. Click Retrieve Signer Information.
12. Verify that the certificate information is for a certificate that you can trust.
13. Click Apply and Save.
Related information:
http://publib.boulder.ibm.com/infocenter/javasdk/v1r4m2/index.jsp?topic=
Information about keytool
Setting the time difference between Endpoint virtual machine and Chef
server
Procedure
1. Update Timezone on Linux - ln -sf /usr/share/zoneinfo/Asia/Kolkata/etc/
localtime.
2. Change Time on Linux date - --set = <current time in given format>. For
example, Sun Feb 28 14:05:15 IST 2014.
Private Key
File that contains the private key of the client specified in the Client
field.
Chef-validator key
File that contains the chef-validator key
Client Name of the client with the admin role used to access the Chef Server
API.
5. Click Create. The details of the Chef host are stored in the database.
Both the private and validator key can be generated by the Chef server. For more
information, see http://docs.opscode.com/chef_private_keys.html.
Table 1. Configuration of the offering
Name
Category
Chef
Process
User interface
Category
Chef
Process
User interface
Deploy Cookbook
In Chef, a cookbook is an essential component for configuration.
For more information about Opscode Chef, see http://docs.opscode.com/
essentials_cookbooks.html. This content pack provides an easy-to-use interface to
deploy the cookbook on a virtual machine.
Before being able to install software modules to the deployed virtual images, you
must:
v Register a Chef host
1.
2.
3.
4.
5.
6.
7.
Deploy Cookbook
Category
Chef
Process
User interface
Name
Category
Chef
Process
User interface
Business processes
There are a number of the business processes available in the toolkit.
Deploy Cookbook
This business process is responsible for deploying cookbooks on a virtual machine.
Human services
There are a number of Human Services artifacts available in the toolkit.
Deploy Cookbook
This business process is responsible for deploying cookbooks on a virtual machine
Coach views
There are no public coach views currently available.
Integration services
Integration services are used to implement the activities in a business process
definition. It implements the required feature when the Business Process
Definitions and its tasks are started.
ListChefHosts
Returns the list of the Chef Hosts registered in the repository.
getcookbooks
Returns the list of cookbooks defined in the specified Chef Host.
ListSoftwareModules
Returns the list of software modules (roles) defined in the specified Chef Host.
Each software module is described by a name and a description.
GetSoftwareModuleAttributes
Returns the default attributes, in JSON format, of the specified software module
(role) defined in the specified Chef Host.
ConvertChefParamsToPlainList
Converts the Chef attributes in JSON format to a list of NameValuePair objects,
where the name is the attribute name in plain format, for example,
apache.default_ports, and the value is the attribute value in string format.
ConvertPlainListParamsToChefParams
Converts a list of NameValuePair objects, where the name is the attribute name in
plain format, for example, apache.default_ports, and the value is the attribute
value in string format, to a JSON format.
10
11
12
13
<tag>active</tag>
</tags>
</instance-action>
<instance-action selection-type="single">
<name>Install Software Modules using Chef</name>
<description>This action applies to virtual servers and enables
you to apply Roles defined on the registered Chef Servers</description>
<instance-type>openstackvms</instance-type>
<process>
<name>Install Software Modules</name>
</process>
<user-interface>
<name>Install Software Modules</name>
</user-interface>
<tags>
<tag>active</tag>
</tags>
</instance-action>
</instance-actions>
</catalog>
14
Chapter 7. Troubleshooting
There are some known problems and limitations.
Error messages are logged for all failures occurring during the execution of the
triggered operations.
The main locations to check are the BPM SystemOut.log and SystemErr.log files
located under the following directory, on the Business Process Manager machine:
/opt/ibm/BPM/v8.5/profiles/Node1Profile/logs/SingleClusterMember1/.
Error indications and messages are displayed in the IBM Cloud Orchestrator user
interface when interacting with the Offerings and when monitoring the outcome of
a queued operation.
The BPM Admin Console (https://<bpm_hostname>:9080/ProessAdmin) can also be
used to inspect a failed process and check its internal status and parameters.
Known problems
There are some known problems you might encounter when using this toolkit.
Install Software Modules UI takes too long to return the list of software
The reason is that the Chef Server is unreachable. Solution: Power on the
machine that hosts the Chef server and start the Chef server.
User action Install Software Modules did not completed successfully
The software installation on one of the virtual machine failed. Check the
/opt/ibm/BPM/v8.5/profiles/Node1Profile/logs/SingleClusterMember1/
SystemOut.log file to see the root causes.
Failure might occur for the following reasons:
v The chef-client is not installed on the virtual machine and the virtual
machine cannot connect to the www.opscode.chef' site to download the
chef-client. Solution: Configure the machine's network or install the
chef-client before running this action.
v The chef-client run process exited unsuccessfully. This might occur for
the following reasons:
The run list refers to recipes or roles not loaded in the Chef server.
Solution: Upload the missing recipes or roles to the Chef server.
One of the recipes cannot be compiled due to an error. Solution: Fix
the specified error.
The Install Software on Vms process stops on error. This means if you
select multiple virtual machines and a software installation fails on one of
them, the process exits without attempting to install the software on the
remaining selected machines.
15
Error codes
Error messages are logged for all probable errors during deployment. The syntax
of the error message is as follows: <Base error code>: <Detailed error code>:
<Error message>.
The table provides the list of all the error codes and their probable causes.
Table 5. Error codes
16
Error code
Description
CTJCA1301E
Enter IP address.
CTJCA1302E
CTJCA1303E
CTJCA1304E
CTJCA1305E
Enter IP address.
CTJCA1306E
No cookbook found.
CTJCA1307E
CTJCA1308E
CTJCA1309E
Connection timeout.
CTJCA1311E
Chef Server generic error. Check BPM server logs for more
details.
CTJCA1312E
CTJCA1313E
CTJCA1314E
CTJCA1315E
CTJCA1316E
CTJCA1317E
CTJCA1318E
CTJCA1319E
CTJCA1320E
CTJCA1321E
CTJCA1322E
CTJCA1323E
Unable to contact the specified Chef Server. Check that the Chef
Server is running and that the provided connection data is
correct.
CTJCA1324E
CTJCA1325E
CTJCA1326E
CTJCA1327E
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.
1623-14, Shimotsuruma, Yamato-shi
Kanagawa 242-8502 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. 2013, 2014
17
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 78758
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.
Any performance data contained herein was determined in a controlled
environment. Therefore, the results obtained in other operating environments may
vary significantly. Some measurements may have been made on development-level
systems and there is no guarantee that these measurements will be the same on
generally available systems. Furthermore, some measurements may have been
estimated through extrapolation. Actual results may vary. Users of this document
should verify the applicable data for their specific environment.
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.
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.
If you are viewing this information softcopy, the photographs and color
illustrations may not appear.
18
19
20
Printed in USA