Customized output from:
Document Release Date: February 2014 Software Release Date: January 2014 |
|
The only warranties for HP products and services are set forth in the express warranty statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP shall not be liable for technical or editorial errors or omissions contained herein.
The information contained herein is subject to change without notice.
Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license.
© Copyright 2010-2014 Hewlett-Packard Development Company, L.P.
Adobe™ is a trademark of Adobe Systems Incorporated.
Microsoft® and Windows® are U.S. registered trademarks of Microsoft Corporation.
Oracle and Java are registered trademarks of Oracle and/or its affiliates.
RED HAT READY™ Logo and RED HAT CERTIFIED PARTNER™ Logo are trademarks of Red Hat, Inc.
This product includes an interface of the 'zlib' general purpose compression library, which is Copyright © 1995-2002 Jean-loup Gailly and Mark Adler.
The HP Cloud Service Automation Installation Guide for 4.00 is an interactive document that provides the information necessary to install your HP Cloud Service Automation (HP CSA) solution, based on the information you provide.
The high-level steps to install and configure the HP Cloud Service Automation solution are illustrated in the figure.
Select from the options below and click View or Print to create a customized installation and configuration document. In this document, when available, detailed tasks are provided to complete the installation and configuration. In other cases, you may need to refer to the manufacturer's documentation to complete the steps.
Note: If a selection is disabled (it cannot be selected), it is not a supported selection based on the other options you have selected. If a disabled selection is selected, choose an enabled selection instead. In some cases, there may be only one selection that can be enabled in a section.
For general information about HP Cloud Service Automation, see the HP Cloud Service Automation Concepts Guide.
For information about the supported components and versions, see the HP Cloud Service Automation System and Software Support Matrix.
If you want to upgrade to HP CSA version 4.00, see the HP Cloud Service Automation Upgrade Guide.
Version: 4.00
Document Release Date: February 2014
Software Release Date: January 2014
The following steps are customized according to your selections. Check that your selections are correct.
If any selections are not correct, click Change.
Based on your selections on the previous page, you must perform the following steps. It is recommended that you perform each step in the following order:
This guide provides information for installing the HP Cloud Service Automation solution. Successful implementation of the solution requires knowledge of the integrated products, as well as the HP Cloud Service Automation solution. Information in this guide augments information provided in the integrated products documentation but is not intended to replace that documentation. Primary product documentation contains the most up-to-date information. Cross references are provided to those documents where appropriate.
For information about how these parts fit together, see the HP Cloud Service Automation Concepts Guide.
You should review the HP Cloud Service Automation System and Software Support Matrix for version requirements.
Both documents are available from the HP Software Support Web site at http://h20230.www2.hp.com/selfsolve/manuals/ (this site requires that you register with HP Passport).
Configure a group and user for HP CSA:
Create a group called csagrp. Enter the following:
groupadd csagrp
Create a user called csauser and assign this user to the csagrp. Enter the following:
useradd -g csagrp -m csauser
(Ubuntu) oruseradd -g csagrp -m csauser -s /bin/bash
(RHEL)
Assign a password to the csauser. Enter the following:
passwd csauser
When prompted, enter the password.
The HP CSA installer requires
that a supported JRE version is installed on the system
and that JRE is configured in the system
registry or the path to the JRE binaries
(<jre_installation>\bin
) is defined in
the system path variable. and
the path to the JRE binaries (<jre_installation>/bin
) is defined in the
system path variable.
For a list of supported JRE versions, refer to the
HP Cloud Service Automation System and Software Support Matrix, available on the
HP Software Support Web site at
http://h20230.www2.hp.com/selfsolve/manuals/
(this site requires that you register with HP Passport).
HP CSA installs OpenJDK JRE to be used exclusively with HP CSA (by default, the JRE is installed in C:\Program Files\Hewlett-Packard\CSA\openjre/usr/local/hp/csa/openjre
). However, you may choose to use another supported JRE version. HP recommends that you install a JRE that can be used exclusively by
HP CSA
(you will be asked for the path to this JRE during installation).
In this documentation,
the directory in which this JRE (the JRE used exclusively by
HP CSA)
is installed will be referred to as
<csa_jre>
.$CSA_JRE_HOME
.
HP Operations Orchestration also installs a JRE to be used with HP Operations Orchestration. By default, this JRE is installed in %ICONCLUDE_HOME%\jre1.6$ICONCLUDE_HOME/jre1.6
.
If HP CSA and HP Operations Orchestration are installed on the same system, you will have multiple JREs installed and you must use the correct JRE for specific commands. In the HP CSA documentation, the path to the specific JRE that should be used for a command will be specified. For example, when exporting HP Operations Orchestration's certificate, you will use HP Operations Orchestration's JRE and the path to HP Operations Orchestration's JRE will be specified (%ICONCLUDE_HOME%\jre1.6$ICONCLUDE_HOME/jre1.6
). When importing HP Operations Orchestration's certificate into HP CSA's truststore, you will use HP CSA's JRE and the path to HP CSA's JRE will be specified (<csa_jre>$CSA_JRE_HOME
).
The JRE used by
HP CSA must be installed by the csauser.
Note: If you are configuring HP CSA to be compliant with FIPS 140-2, you MUST install a supported JRE that is used exclusively by HP CSA. For a list of supported JRE versions, refer to the HP Cloud Service Automation System and Software Support Matrix
For a list of supported database versions, refer to the HP Cloud Service Automation System and Software Support Matrix, available on the HP Software Support Web site at http://h20230.www2.hp.com/selfsolve/manuals/ (this site requires that you register with HP Passport).
Install the database according to the manufacturer’s documentation. Database installation is typically done in partnership with a database administrator.
For a list of supported JDBC driver versions, refer to the HP Cloud Service Automation System and Software Support Matrix (available on the HP Software Support Web site at http://h20230.www2.hp.com/selfsolve/manuals/ (this site requires that you register with HP Passport)).
Download a supported version of the JDBC .jar
file(s) and save them on the system on which
HP CSA will be installed.
Note the location where you save the file(s) as this information must be provided when
HP CSA is installed.
These tasks must be completed before HP CSA is installed.
A database user is needed when installing HP CSA. Work with the database administrator to do the following (or refer to the manufacturer’s documentation for more information):
Caution: The database name and username cannot contain more than one dollar sign symbol ($). For example, c$adb is a valid name but c$$adb and c$ad$b are not valid names.
You must provide this user's username and password when prompted for the CSA database user during the installation of HP CSA.
A reporting database role and read-only user are needed only if you want to use the reporting capabilities of HP CSA. Work with the database administrator to create a role and read-only user to do the following (or refer to the manufacturer’s documentation for more information):
Caution: The username cannot contain more than one dollar sign symbol ($). For example, c$adb is a valid name but c$$adb and c$ad$b are not valid names.
For example, run the following commands to create the CSAReportingDBRole role and CSAReportingDBUser read-only user:
Create user CSAReportingDBUser identified by CSAReportingDBUser;
Create role CSAReportingDBRole;
Grant CREATE SESSION to CSAReportingDBUser;
Grant CSAReportingDBRole to CSAReportingDBUser;
Alter user CSAReportingDBUser default role CSAReportingDBRole;
A reporting database user is needed only if you want to use the reporting capabilities of HP CSA.
Caution: The username cannot contain more than one dollar sign symbol ($). For example, c$adb is a valid name but c$$adb and c$ad$b are not valid names.
Add a reporting database user to the HP CSA database with no roles.
For example, run the following commands to create the CSAReportingDBUser read-only user:
CREATE LOGIN CSAReportingDBUser WITH PASSWORD = '<csareportingdbuser_password>';
CREATE USER CSAReportingDBUser FOR LOGIN CSAReportingDBUser WITH DEFAULT_SCHEMA = csa;
Optionally, create a reporting
database user for HP CSA
(for example, CSAReportingDBUser
).
A reporting database user is needed only if you want to use the reporting capabilities of
HP CSA.
This user should have read-only rights.
Caution: The username cannot contain more than one dollar sign symbol ($). For example, c$adb is a valid name but c$$adb and c$ad$b are not valid names.
From the psql prompt, enter the following:
create role CSAReportingDBUser login password '<csareportingdbuser_password>' nosuperuser nocreatedb nocreaterole inherit;
If you configure this user, you must provide this user's username and password when prompted for the CSA reporting database user during the installation of HP CSA.
To support localization, the Oracle database instance must support UTF-8 character encoding and multi-byte characters. Work with the database administrator to set the following parameters to the specified values (or refer to the manufacturer’s documentation for more information):
For performance reasons, HP recommends that you create a new tablespace which stores LOBs for the CSA_DOCUMENT table. Work with the database administrator to create a tablespace to be used by HP CSA (or refer to the manufacturer’s documentation for more information). HP recommends that the initial tablespace size should be at least 3 GB.
The tablespace must be created before installing HP CSA and then must be configured immediately after HP CSA is installed.
Refer to HP Cloud Service Automation System and Software Support Matrix for a list of supported database versions, available on the HP Software Support Web site at http://h20230.www2.hp.com/selfsolve/manuals/ (this site requires that you register with HP Passport).
Database installation is typically done in partnership with a database administrator. Microsoft SQL Server must be installed with Mixed Mode authentication. During the installation of Microsoft SQL Server, from the Database Engine Configuration dialog, for Authentication Mode, select Mixed Mode (SQL Server authentication and Windows authentication).
These tasks must be completed before HP CSA is installed. Work with the database administrator to complete the following tasks (or refer to the manufacturer’s documentation for more information).
TCP/IP must be enabled on the Microsoft SQL Server in order for HP CSA to log in to the database. By default, TCP/IP may be disabled on the Microsoft SQL Server. Verify the TCP/IP configuration.
From the SQL Server Configuration Manager:
A database user is needed when installing HP CSA.
Caution: The database name and username cannot contain more than one dollar sign symbol ($). For example, c$adb is a valid name but c$$adb and c$ad$b are not valid names.
To create a database user for HP CSA, do the following:
You must provide this user's username and password when prompted for the CSA database user during the installation of HP CSA.
A reporting database role and read-only user are needed only if you want to use the reporting capabilities of HP CSA. Work with the database administrator to create a role and read-only user to do the following (or refer to the manufacturer’s documentation for more information):
Caution: The username cannot contain more than one dollar sign symbol ($). For example, c$adb is a valid name but c$$adb and c$ad$b are not valid names.
For example, run the following commands to create the CSAReportingDBRole role and CSAReportingDBUser read-only user:
Create user CSAReportingDBUser identified by CSAReportingDBUser;
Create role CSAReportingDBRole;
Grant CREATE SESSION to CSAReportingDBUser;
Grant CSAReportingDBRole to CSAReportingDBUser;
Alter user CSAReportingDBUser default role CSAReportingDBRole;
A reporting database user is needed only if you want to use the reporting capabilities of HP CSA.
Caution: The username cannot contain more than one dollar sign symbol ($). For example, c$adb is a valid name but c$$adb and c$ad$b are not valid names.
Add a reporting database user to the HP CSA database with no roles.
For example, run the following commands to create the CSAReportingDBUser read-only user:
CREATE LOGIN CSAReportingDBUser WITH PASSWORD = '<csareportingdbuser_password>';
CREATE USER CSAReportingDBUser FOR LOGIN CSAReportingDBUser WITH DEFAULT_SCHEMA = csa;
Optionally, create a reporting
database user for HP CSA
(for example, CSAReportingDBUser
).
A reporting database user is needed only if you want to use the reporting capabilities of
HP CSA.
This user should have read-only rights.
Caution: The username cannot contain more than one dollar sign symbol ($). For example, c$adb is a valid name but c$$adb and c$ad$b are not valid names.
From the psql prompt, enter the following:
create role CSAReportingDBUser login password '<csareportingdbuser_password>' nosuperuser nocreatedb nocreaterole inherit;
If you configure this user, you must provide this user's username and password when prompted for the CSA reporting database user during the installation of HP CSA.
For performance reasons, HP recommends that you associate a new filegroup with the CSA_DOCUMENT table. Work with the database administrator to configure a filegroup to be used by HP CSA (or refer to the manufacturer’s documentation for more information). HP recommends that the initial filegroup size should be at least 3 GB.
The filegroup is configured after HP CSA is installed.
Refer to HP Cloud Service Automation System and Software Support Matrix for a list of supported database versions, available on the HP Software Support Web site at http://h20230.www2.hp.com/selfsolve/manuals/ (this site requires that you register with HP Passport).
Install the database according to the manufacturer’s documentation. Database installation is typically done in partnership with a database administrator.
These tasks must be completed before HP CSA is installed. Work with the database administrator to complete the following tasks (or refer to the manufacturer’s documentation for more information).
A database user is needed when installing HP CSA. Do the following:
On the system hosting the database, install
postgresql-client
postgres-client.rpm
if it is not already installed.
As the root user, enter the following:
apt-get install postgresql-client
rpm -ivh postgres-client.rpm
Set the shared library path to
include the PostgreSQL libraries (<postgresql_installation>/lib
).
For example, if you installed PostgreSQL in /opt/PostgreSQL/9.2/
, run the
following command:
export LD_LIBRARY_PATH=/opt/PostgreSQL/9.2/lib:$LD_LIBRARY_PATH
Log in to psql as the postgres user. Enter the following:
psql -h localhost -U postgres -d template1
When prompted, enter the password for the postgres user.
Create an HP CSA
database user (for example, csadbuser
). This user should inherit rights from parent roles and be a superuser.
Caution: The username cannot contain more than one dollar sign symbol ($). For example, c$adb is a valid name but c$$adb and c$ad$b are not valid names.
From the psql prompt, enter the following:
create role csadbuser login password '<csadbuser_password>' superuser inherit;
You must provide this user's username and password when prompted for the CSA database user during the installation of HP CSA.
A reporting database role and read-only user are needed only if you want to use the reporting capabilities of HP CSA. Work with the database administrator to create a role and read-only user to do the following (or refer to the manufacturer’s documentation for more information):
Caution: The username cannot contain more than one dollar sign symbol ($). For example, c$adb is a valid name but c$$adb and c$ad$b are not valid names.
For example, run the following commands to create the CSAReportingDBRole role and CSAReportingDBUser read-only user:
Create user CSAReportingDBUser identified by CSAReportingDBUser;
Create role CSAReportingDBRole;
Grant CREATE SESSION to CSAReportingDBUser;
Grant CSAReportingDBRole to CSAReportingDBUser;
Alter user CSAReportingDBUser default role CSAReportingDBRole;
A reporting database user is needed only if you want to use the reporting capabilities of HP CSA.
Caution: The username cannot contain more than one dollar sign symbol ($). For example, c$adb is a valid name but c$$adb and c$ad$b are not valid names.
Add a reporting database user to the HP CSA database with no roles.
For example, run the following commands to create the CSAReportingDBUser read-only user:
CREATE LOGIN CSAReportingDBUser WITH PASSWORD = '<csareportingdbuser_password>';
CREATE USER CSAReportingDBUser FOR LOGIN CSAReportingDBUser WITH DEFAULT_SCHEMA = csa;
Optionally, create a reporting
database user for HP CSA
(for example, CSAReportingDBUser
).
A reporting database user is needed only if you want to use the reporting capabilities of
HP CSA.
This user should have read-only rights.
Caution: The username cannot contain more than one dollar sign symbol ($). For example, c$adb is a valid name but c$$adb and c$ad$b are not valid names.
From the psql prompt, enter the following:
create role CSAReportingDBUser login password '<csareportingdbuser_password>' nosuperuser nocreatedb nocreaterole inherit;
If you configure this user, you must provide this user's username and password when prompted for the CSA reporting database user during the installation of HP CSA.
Create a new database for HP CSA. Grant the HP CSA database user all rights to this database and grant the reporting database user read-only access to this database.
Caution: The database name cannot contain more than one dollar sign symbol ($). For example, c$adb is a valid name but c$$adb and c$ad$b are not valid names.
For example, if you create
a database named csadb
, an
HP CSA
user named csadbuser
, and a reporting database user CSAReportingDBUser
,
from the psql prompt, enter
the following commands:
create database csadb with owner=csadbuser connection limit=-1;
grant all on database csadb to csadbuser;
grant connect on database csadb to CSAReportingDBUser;
Exit psql. From the psql prompt, enter the following:
\q
Install HP Operations Orchestration to the correct version and patch level. See HP Cloud Service Automation System and Software Support Matrix for version requirements, available on the HP Software Support Web site at http://h20230.www2.hp.com/selfsolve/manuals/ (this site requires that you register with HP Passport).
If you are using an existing installation of HP Operations Orchestration, you should verify that the correct versions of patches and updates have been applied.
Note: Installation log files are written to the
directory.%CSA_HOME%
$CSA_HOME
\_CSA_4_0_1_installation\Logs\
To install HP Cloud Service Automation (HP CSA), complete the following steps.
Run the setup.exe
installation file.
On the Introduction screen, read the information and click Next.
Read the license agreement and select I accept the terms of the License Agreement. Click Next to continue with the installation.
If the following error message displays:
Another version of HP CSA
is configured in the registry. However, HP CSA
has been uninstalled (the HP CSA installation
directory %CSA_HOME% does not exist). You must exit the installer and delete the entry in the registry before
installing HP CSA. Refer to the
HP Cloud Service Automation Installation Guide for more information about deleting the registry entry.
exit the installer. Locate the C:\Program Files\Zero G Registry\.com.zerog.registry.xml
file (you may need to show hidden files), make a backup copy, delete all
HP CSA entries from
the .com.zerog.registry.xml
file, and
restart the installer.
Choose the JRE that will be used by HP CSA.
In this documentation,
the directory in which the JRE is installed will be referred to as
<csa_jre>
.
For a list of supported JREs, refer to the HP Cloud Service Automation System and Software Support Matrix, available on the HP Software Support Web site at http://h20230.www2.hp.com/selfsolve/manuals/ (this site requires that you register with HP Passport).
OpenJDK JRE
By default, the OpenJDK JRE that is bundled with HP CSA is selected and will be installed. If you want to use the OpenJDK JRE, click Next.
The default location in which the OpenJDK JRE is installed is
C:\Program Files\Hewlett-Packard\CSA\openjre
.
Oracle JRE
If you have installed a supported version of Oracle JRE to be used by HP CSA, click Oracle JRE, select the location in which you installed this JRE, and click Next.
The default location displayed for the Oracle JRE Home is either a supported JRE that is configured in the system registry or a supported JRE in a path that is defined in the system path variable. If this is not the JRE that should be used by HP CSA, click Choose and select the location in which you installed the JRE that will be used by HP CSA.
Caution:
The entire directory path cannot contain more than one dollar sign symbol ($). For example, C:\HP\C$A\Java and C:\HP\CSA\Java$ are valid paths. However C:\HP\C$A\Java$ and C:\HP\C$$A\Java are not valid paths.
Choose a location in which to install HP CSA and click Next (
is set to this location).%CSA_HOME%
$CSA_HOME
The default location is
C:\Program Files\Hewlett-Packard\CSA
.
Note: If the directory in which you choose to install HP CSA is not empty, existing content in the directory may be overwritten or deleted when HP CSA is installed, upgraded, or uninstalled.
Caution:
The entire directory path cannot contain more than one dollar sign symbol ($). For example, C:\HP\C$A\Java and C:\HP\CSA\Java$ are valid paths. However C:\HP\C$A\Java$ and C:\HP\C$$A\Java are not valid paths.
Define the database instance on which the HP CSA database components should be installed or where the HP CSA database schema already exists. Enter the following database information and click Next.
Field Name | Description |
---|---|
Database Type |
The type of database you have installed (Microsoft SQL Server)(Oracle)(PostgreSQL). For an Oracle database, you must also
enter the JDBC Driver Directory. This is the absolute directory path to the location
of the JDBC drivers (these are the JDBC drivers you downloaded onto the
HP CSA
system). For a list of supported JDBC driver versions, refer to the
HP Cloud Service Automation System and Software Support Matrix, available on the
HP Software Support Web site at
http://h20230.www2.hp.com/selfsolve/manuals/
(this site requires that you register with HP Passport).
Click Choose to select the directory.
Caution:
The entire directory path cannot contain more than one dollar sign symbol ($).
For example, C:\HP\C$A\Java and C:\HP\CSA\Java$ are valid paths.
However C:\HP\C$A\Java$ and C:\HP\C$$A\Java are not valid paths. |
Database Name | The name of the database instance on which the HP CSA database schema will be installed. If you are creating a new HP CSA database schema, this is the name of the database instance on which the HP CSA database components will be installed. If you are using an existing HP CSA database schema that was created as part of a prior successful installation of HP CSA version HP 4.00, this is the name of the database instance on which the HP CSA database schema exists. For an Oracle database, this is the System ID (SID). |
Database Host | The hostname or IP address of the server where the database is located. |
Database Port | The database port number, such as 1433 (Microsoft SQL Server).1521 (Oracle).5432 (PostgreSQL). |
CSA Database Username | The username of the database user you configured for HP CSA after installing the database. |
CSA Database Password | The password for the database user. |
CSA Reporting Database Username | Optional. The username of the database user you configured for reporting purposes for HP CSA after installing the database. |
CSA Reporting Database Password | The password for the CSA reporting database user. |
Define the database instance where the HP CSA database schema already exists. Enter the database information and click Next.
Field Name | Description |
---|---|
Database Type |
The type of database you have installed (Microsoft SQL Server)(Oracle)(PostgreSQL).(Microsoft SQL Server or Oracle).(Microsoft SQL Server, Oracle, or PostgreSQL). For an Oracle database, you must also
enter the JDBC Driver Directory. This is the absolute directory path to the location
of the JDBC drivers (these are the JDBC drivers you downloaded onto the
HP CSA
system). For a list of supported JDBC driver versions, refer to the
HP Cloud Service Automation System and Software Support Matrix, available on the
HP Software Support Web site at
http://h20230.www2.hp.com/selfsolve/manuals/
(this site requires that you register with HP Passport).
Click Choose to select the directory.
Caution:
The entire directory path cannot contain more than one dollar sign symbol ($).
For example, C:\HP\C$A\Java and C:\HP\CSA\Java$ are valid paths.
However C:\HP\C$A\Java$ and C:\HP\C$$A\Java are not valid paths. |
Database Name | The name of the database instance on which the HP CSA database schema exists. For an Oracle database, this is the System ID (SID). |
Database Host | The hostname or IP address of the server where the database is located. |
Database Port |
The database port number, such as 1433 (Microsoft SQL Server) or , 1521 (Oracle), or 5432 (PostgreSQL). |
CSA Database Username | The username of the database user you configured for HP CSA after installing the database. |
CSA Database Password | The password for the database user. |
CSA Reporting Database Username | Optional. The username of the database user you configured for reporting purposes for HP CSA after installing the database. |
CSA Reporting Database Password | The password for the CSA reporting database user. |
Install HP CSA database components onto the database instance to create the HP CSA database schema, if it does not exist.
Click Yes to install HP CSA database components and create the HP CSA database schema. When you select this option, the HP CSA service automatically starts when you exit the installer.
Click No if you are using an existing HP CSA database schema that was created as part of a prior successful installation of HP CSA version 4.00. When you select this option, the HP CSA service does not start when you exit the installer. Refer to the end of this section for information on how to start and stop the HP CSA service.
Click No, do not install database components as you are using an existing HP CSA database schema.
From the Enter host name screen, enter the fully-qualified domain name of the system on which you are installing HP CSA. The fully-qualified domain name is used to generate the self-signed SSL certificate which is used when https browser requests are issued for the Cloud Service Management Console. Marketplace Portal. This self-signed certificate expires 120 days after HP CSA is installed.
Caution: If you enter an IP address, after installation completes, you must manually generate a self-signed certificate using the fully-qualified domain name of the system on which you installed HP CSA and manually reconfigure HP CSA and the Marketplace Portal to use this certificate. For more information, refer to the HP Cloud Service Automation Configuration Guide.
Review your selections and click Install to complete the installation.
In some instances, you may be asked to restart your system.
Click Yes, restart my system to restart your system when you exit the installer.
Click No, I will restart my system myself to restart your system at a more convenient time.
Click Done to exit the installer.
Verify that the HP Cloud Service Automation and Marketplace Portal services have started by navigating to Control Panel > Administrative Tools > Services. It can take up to five minutes for the HP Cloud Service Automation to start. If one or both services have not started, right-click on the service and select Start.
The installer creates the HP Cloud Service Automation and Marketplace Portal services. If you opted to install the HP Cloud Service Automation database components, the installer starts the both services. The HP Cloud Service Automation service must be running in order to access the Cloud Service Management Console and the Marketplace Portal service must be running in order to access the Marketplace Portal.
To start, stop, and restart the HP Cloud Service Automation and Marketplace Portal services, navigate to Control Panel > Administrative Tools > Services, right-click on a service, and select the desired action.
Note: Installation log files are written to the
directory and are named %CSA_HOME%
$CSA_HOME
/_CSA_4_0_1_installation/Logs/csa_*.txt
.
To install HP Cloud Service Automation (HP CSA), complete the following steps.
Install the unzip utility if it is not already installed (Ubuntu Linux only). Enter the following:
apt-get install unzip
Create an installation directory for HP CSA
(this document assumes that you will install the product in
/usr/local/hp/csa
and all examples
used in this document are based on this assumption). Enter the following:
mkdir -p /usr/local/hp/csa
For the installation directory, set the owner to csauser and the group to csagrp. Enter the following:
chown -R csauser:csagrp /usr/local/hp/csa
setup.bin
) to the system and go to the directory in which it has been copied.Verify that setup.bin
is owned by csauser and csauser has full permissions to the file. If necessary,
do the following:
Enter one or both of the following commands:
chown csauser setup.bin
chmod u+rwx setup.bin
Run the setup.bin
installation file (as the csauser).
Note: You must run setup.bin
as the csauser. If you
install HP CSA as another user,
you may not be able to run HP CSA.
As the csauser, enter the following:
./setup.bin
Read the Introduction and click enter to continue with the installation.
Select Y and enter to accept the license agreement and continue with the installation. Select N and enter to exit the installation.
If the following error message displays:
Another version of HP CSA
is configured in the registry. However, HP CSA
has been uninstalled (the HP CSA installation
directory $CSA_HOME does not exist). You must exit the installer and delete the entry in the registry before
installing HP CSA. Refer to the
HP Cloud Service Automation Installation Guide for more information about deleting the registry entry.
exit the installer. Locate the $CSA_HOME/.com.zerog.registry.xml
file, make a backup copy, delete all
HP CSA entries from
the .com.zerog.registry.xml
file, and
restart the installer.
Choose the JRE that will be used by HP CSA.
In this documentation,
the directory in which the JRE is installed will be referred to as
$CSA_JRE_HOME
.
For a list of supported JREs, refer to the HP Cloud Service Automation System and Software Support Matrix, available on the HP Software Support Web site at http://h20230.www2.hp.com/selfsolve/manuals/ (this site requires that you register with HP Passport).
OpenJDK JRE
By default, the OpenJDK JRE that is bundled with HP CSA is selected and will be installed. If you want to use the OpenJDK JRE, select Enter.
The default location in which the OpenJDK JRE is installed is
/usr/local/hp/csa/openjre
.
Oracle JRE
If you have installed a supported version of Oracle JRE to be used by HP CSA, select 2 and Enter. Type the location in which you installed this JRE and select Enter.
The default location displayed for the Oracle JRE Home is either a supported JRE that is configured in the system registry or a supported JRE in a path that is defined in the system path variable. If this is not the JRE that should be used by HP CSA, type in the location in which you installed the JRE that will be used by HP CSA and select Enter.
Enter a location in which to install HP CSA (enter the absolute path to the location) and select enter. Or, select enter to accept the default location.
The default location is /usr/local/hp/csa
.
Note: If the directory in which you choose to install HP CSA is not empty, existing content in the directory may be overwritten or deleted when HP CSA is installed, upgraded, or uninstalled.
If prompted, verify the installation folder. If the folder is correct, select Y and enter to continue with the installation. If the folder is not correct, select N and enter to re-enter the installation folder.
Define the database instance on which the HP CSA database components should be installed. Enter the following database information (select enter after each entry).
Enter the type of database you have installed.
For an Oracle database, you must also enter the JDBC Driver Directory. This is the absolute directory path to the location of the JDBC drivers (these are the JDBC drivers you downloaded onto the HP CSA system). For a list of supported JDBC driver versions, refer to the HP Cloud Service Automation System and Software Support Matrix, available on the HP Software Support Web site at http://h20230.www2.hp.com/selfsolve/manuals/ (this site requires that you register with HP Passport).
Enter the database port. This is the database port number, such as 1433 (Microsoft SQL Server), 1521 (Oracle), or 5432 (PostgreSQL).
Enter the database name. This is the name of the database instance on which the
HP CSA
database schema will be installed. If you are creating a new
HP CSA
database schema, this is the name of the database instance on which the
HP CSA database components
will be installed. If you are using an existing
HP CSA database schema
that was created as part of a prior successful installation of
HP CSA version
HP 4.00,
this is the name of the database instance on which
the HP CSA database schema already exists.
If you followed the examples in this document, enter csadb
.
Enter the CSA database user name. This is the user name of the database user you configured for
HP Cloud Service Automation after installing the database.
If you followed the examples in this document, enter csadbuser
.
Enter the CSA reporting database username (optional). This is the username of the database user you configured for reporting purposes for
HP CSA after installing the database.
If you followed the examples in this document, enter csareportingdbuser
.
Define the database instance where the HP CSA database schema already exists. Enter the following database information (click enter after each entry).
Enter the database port. This is the database port number, such as 1433 (Microsoft SQL Server), 1521 (Oracle), or 5432 (PostgreSQL).
csadb
.Enter the CSA database username. This is the username of the database user you configured for
HP CSA after installing
the database. If you followed the examples in this document, enter csadbuser
.
Enter the CSA reporting database username (optional). This is the username of the database user you configured for reporting purposes for HP CSA after installing the database.
Install HP CSA database components onto the database instance to create the HP CSA database schema, if it does not already exist.
Type yes to install HP CSA database components and create the HP CSA database schema. When you select this option, the HP CSA process automatically starts when you exit the installer.
Type no if you are using an existing HP CSA database schema that was created as part of a prior successful installation of HP CSA version 4.00. When you select this option, the HP CSA process does not start when you exit the installer. Refer to the end of this section for information on how to start and stop the HP CSA service.
Type no, do not install database components as you are using an existing HP CSA database schema.
Enter the HP CSA server hostname. This is the fully-qualified domain name of the system on which you are installing HP CSA. The fully-qualified domain name is used to generate the self-signed SSL certificate which is used when https browser requests are issued for the Cloud Service Management Console. Marketplace Portal. This self-signed certificate expires 120 days after HP CSA is installed.
Caution: If you enter an IP address, after installation completes, you must manually generate a self-signed certificate using the fully-qualified domain name of the system on which you installed HP CSA and manually reconfigure HP CSA and the Marketplace Portal to use this certificate. For more information, refer to the HP Cloud Service Automation Configuration Guide.
Review your selections and select enter to complete the installation or ctrl-c to exit the installation.
When the installation completes, select enter to exit the installer.
Define the CSA_HOME and JAVA_HOME environment variables
and add /sbin
to the PATH variable for the csauser user. Set CSA_HOME to the location where
HP CSA is installed. In a startup script
for the csauser user (for example, .profile
(Ubuntu) or .bash_profile
(Red Hat Enterprise Linux)), add the following:
export CSA_HOME=/usr/local/hp/csa
export JAVA_HOME=<csa_jre>$CSA_JRE_HOME
export PATH=$PATH:/sbin
<csa_jre>
$CSA_JRE_HOME
is the directory
in which the JRE that is used by HP CSA
is installed.Source the startup file in
which you set the CSA_HOME, JAVA_HOME,
and PATH environment variables. If you edited
.profile
(Ubuntu) or .bash_profile
(Red Hat Enterprise Linux),
enter the following:
. .profile
(Ubuntu). .bash_profile
(Red Hat Enterprise Linux)
Create an HP CSA service and a Marketplace Portal service to start and stop the HP CSA and Marketplace Portal processes.
Go to the directory in which HP CSA is installed. For example:
cd /usr/local/hp/csa
Copy the csa
and mpp
scripts to the /etc/init.d
directory. Enter the following:
cp ./scripts/csa /etc/init.d
cp ./scripts/mpp /etc/init.d
Change permissions of the scripts. Enter the following:
chmod 755 /etc/init.d/csa
chmod 755 /etc/init.d/mpp
Log in as csauser and start the HP CSA and Marketplace Portal services. Enter the following:
service csa start
service mpp start
The HP Cloud Service Automation service must
be running in order to access the
Cloud Service Management Console.
You can start this service by typing service csa start
.
You can restart this service by typing service csa restart
.
You can stop the service by typing service csa stop
.
You can check the status of the service by typing service csa status
.Do not start the
HP CSA service. You
must remove unneeded files (next section) before starting the
HP CSA service.
The Marketplace Portal service must be running in order to access the
Marketplace Portal.
You can start this service by typing service mpp start
.
You can restart this service by typing service mpp restart
.
You can stop the service by typing service mpp stop
.
You can check the status of the service by typing service mpp status
.
Configure the Oracle tablespace you created for HP Cloud Service Automation only if you are installing HP Cloud Service Automation for the first time and there is no data in the CSA_DOCUMENT table. The tablespace must have been created before HP Cloud Service Automation is installed and then must be configured immediately after HP Cloud Service Automation is installed.
Work with the database administrator to perform the following (or refer to the manufacturer’s documentation for more information):
Modify the CSA_DOCUMENT table such that LOB segments are stored in the tablespace. For example:
ALTER TABLE csa_document
MOVE LOB(content)
STORE AS (TABLESPACE <new_tablespace>);
These tasks must be completed after HP Cloud Service Automation is installed.
Configure the Microsoft SQL server filegroup you created for HP Cloud Service Automation only if you are installing HP Cloud Service Automation for the first time and there is no data in the CSA_DOCUMENT table. The filegroup must have been created before HP Cloud Service Automation is installed and then must be configured immediately after HP Cloud Service Automation is installed.
Work with the database administrator to perform the following (or refer to the manufacturer’s documentation for more information):
The HP Cloud Service Automation solution includes a number of HP Operations Orchestration flows that perform Cloud Service Automation operations.
Complete the following tasks to configure HP Operations Orchestration to integrate successfully with HP Cloud Service Automation:
Note: In the following instructions,
%CSA_HOME%
$CSA_HOME
is the directory in which
HP Cloud Service Automation is installed and
%ICONCLUDE_HOME%
or $ICONCLUDE_HOME
is where you installed HP Operations Orchestration.
Be sure all the latest patches for HP Operations Orchestration
have been installed. See the HP Cloud Service Automation System and Software Support Matrix
for more information, available on the
HP Software Support Web site at
http://h20230.www2.hp.com/selfsolve/manuals/
(this site requires that you register with HP Passport).
The HP Cloud Service Automation flows that are imported require that a JRE be included in the system path. HP recommends that you use the JRE that is installed with HP Operations Orchestration.
Windows
Open the Environment Variables dialog:
At the end of the value for Variable value, add a semicolon (;) and the following path:
%ICONCLUDE_HOME%\jre1.6\bin
Linux
Open a shell and enter the following command:
export PATH=$PATH:$ICONCLUDE_HOME/jre1.6/bin
Note: By setting the system path, all applications (that require a JRE) use the JRE that is installed with HP Operations Orchestration (if it is the only path or the first path set to a JRE in the system path). If you need to run another JRE with an application, you must type in the relative path to that JRE in order to run it (for example, when you configure SSL).
Copy the
file to:%CSA_HOME%
$CSA_HOME
\CSAKit-4.0\OO Flow Content\oo10-csa-cp-uuids.txt%CSA_HOME%
$CSA_HOME
/CSAKit-4.0/OO Flow Content/oo10-csa-cp-uuids.txt
Windows
%ICONCLUDE_HOME%\central\cmu\exclusions
Linux
$ICONCLUDE_HOME/central/cmu/exclusions
If HP CSA and
HP Operations Orchestration are running on different systems,
copy the
file
from the HP Cloud Service Automation
system to the HP Operations Orchestration system (where
%CSA_HOME%
$CSA_HOME
\CSAKit-4.0\OO Flow Content\oo10-csa-cp-4.0.0.jar%CSA_HOME%
$CSA_HOME
/CSAKit-4.0/OO Flow Content/oo10-csa-cp-4.0.0.jar%CSA_HOME%
$CSA_HOME
is the directory in which
HP Cloud Service Automation is installed).
To install HP Cloud Service Automation flows:
%CSA_HOME%
$CSA_HOME
\
/
CSAKit-4.0\
/
OO Flow Content\
/
CSA-3_20-ContentInstaller.jar
file
from the HP Cloud Service Automation
system to the HP Operations Orchestration system (where
%CSA_HOME%
$CSA_HOME
is the directory in which
HP Cloud Service Automation is installed). CSA-3_20-ContentInstaller.jar
is located.Run the following command:
Windows
"%ICONCLUDE_HOME%\jre1.6\bin\java" ‑jar CSA-3_20-ContentInstaller.jar ‑centralPassword <OOAdminPassword>
Linux
$ICONCLUDE_HOME/jre1.6/bin/java ‑jar CSA-3_20-ContentInstaller.jar ‑centralPassword <OOAdminPassword>
The internal user can be used to configure HP Operations Orchestration for HP CSA and is used to import the HP Operations Orchestration flows. When importing flows, this user is configured in the HP Operations Orchestration input file used by the process definition tool.
Enter the following information:
Field | Recommended Value |
---|---|
User Name | csaoouser |
Password | cloud |
Roles | ADMIN, SYSTEM_ADMIN |
The HP CSA content pack must be deployed after you have deployed the base content packs.
Browse to the content packs on the system. Select a content pack and click Open. Select and open the following base content packs in the order shown below:
Note: Do not deploy the HP CSA content pack until after you have deployed the base content packs. The HP CSA content pack must be deployed separately and after you have deployed the base content packs.
Click Deploy.
The deployment may take a few minutes and the cursor will show the "busy" icon.
Information about the success or failure of the deployment is displayed in the Deployment Result section.
Select the oo10-csa-cp-4.0.0 content pack and click Open.
Click Deploy.
The deployment may take a few minutes and the cursor will show the "busy" icon.
Information about the success or failure of the deployment is displayed in the Deployment Result section.
Set up three system accounts for the HP CSA content pack:
Enter the following information:
Field | Recommended Value |
---|---|
System Account Name | CSA_REST_CREDENTIALS |
User Name | ooInboundUser |
Password | cloud |
Note: The User Name configured for the CSA_REST_CREDENTIALS System Account setting must match the Property ValueOverride Value configured for the CSA_OO_USER System Property setting.
Enter the following information:
Field | Recommended Value |
---|---|
System Account Name | CSA_SERVICEMANAGER_CREDENTIALS |
User Name | falcon |
Password |
<leave_blank> |
Set up the following system properties for the HP CSA content pack:
Enter the following information:
Field | Recommended Value |
---|---|
Name | CSA_REST_URI |
Override Value | https://<csa_hostname>:8444/csa/rest |
The flows for HP Cloud Service Automation must be installed in the HP Operations Orchestration Flow Library.
Copy the
file to:%CSA_HOME%
$CSA_HOME
\CSAKit-4.0\OO Flow Content\oo10-csa-cp-uuids.txt%CSA_HOME%
$CSA_HOME
/CSAKit-4.0/OO Flow Content/oo10-csa-cp-uuids.txt
Windows
%ICONCLUDE_HOME%\central\cmu\exclusions
Linux
$ICONCLUDE_HOME/central/cmu/exclusions
If HP CSA and
HP Operations Orchestration are running on different systems,
copy the
file
from the HP Cloud Service Automation
system to the HP Operations Orchestration system (where
%CSA_HOME%
$CSA_HOME
\CSAKit-4.0\OO Flow Content\oo10-csa-cp-4.0.0.jar%CSA_HOME%
$CSA_HOME
/CSAKit-4.0/OO Flow Content/oo10-csa-cp-4.0.0.jar%CSA_HOME%
$CSA_HOME
is the directory in which
HP Cloud Service Automation is installed).
To install HP Cloud Service Automation flows:
%CSA_HOME%
$CSA_HOME
\
/
CSAKit-4.0\
/
OO Flow Content\
/
CSA-3_20-ContentInstaller.jar
file
from the HP Cloud Service Automation
system to the HP Operations Orchestration system (where
%CSA_HOME%
$CSA_HOME
is the directory in which
HP Cloud Service Automation is installed). CSA-3_20-ContentInstaller.jar
is located.Run the following command:
Windows
"%ICONCLUDE_HOME%\jre1.6\bin\java" ‑jar CSA-3_20-ContentInstaller.jar ‑centralPassword <OOAdminPassword>
Linux
$ICONCLUDE_HOME/jre1.6/bin/java ‑jar CSA-3_20-ContentInstaller.jar ‑centralPassword <OOAdminPassword>
Set the URL to:
https://<FQDN>:9004/RAS/services/RCAgentService
where <FQDN>
is the fully qualified domain name or IP address of the
HP Operations Orchestration host. Do not use localhost in the URL.
Using localhost does not work correctly even though it appears
to work when you run HP Operations Orchestration Studio on the same
machine as the RAS.
RAS must be run on the same system as HP Operations Orchestration Studio. Running HP Operations Orchestration Studio on another machine produces errors and turns flows red with a cryptic error message about result assignments to result variables that do not exist.
Verify the Credentials are set to the following values:
where CSA_REST_CREDENTIALS are the credentials for HP CSA REST authentication.
Note: The User Name configured for the CSA_REST_CREDENTIALS System Account setting must match the Property ValueOverride Value configured for the CSA_OO_USER System Property setting.
Set the Property Value to:
https://<csa_hostname>:8444/csa/rest
Verify the Property Value is set to:
ooInboundUser
Note: The Property ValueOverride Value configured for the CSA_OO_USER System Property setting must match the User Name configured for the CSA_REST_CREDENTIALS System Account setting.
The other settings can be optionally configured. For information about the settings, refer to the HP Cloud Service Automation Configuration Guide.
true
.For each system running HP CSA, import the root certificate of each HP Operations Orchestration's Certificate Authority.
Import HP Operations Orchestration's certificate into HP CSA
Import the root certificate of HP Operations Orchestration's Certificate Authority into HP Cloud Service Automation (you must first export HP Operations Orchestration's certificate from HP Operations Orchestration's truststore and then import it into HP CSA's truststore).
%ICONCLUDE_HOME%
(Windows)
or $ICONCLUDE_HOME
(Linux).Run the following command:
Windows
.\jre1.6\bin\keytool -exportcert -alias pas -file C:\oo.crt
-keystore .\Central\conf\rc_keystore -storepass bran507025
Linux
./jre1.6/bin/keytool -exportcert -alias pas
-file /tmp/oo.crt
-keystore ./Central/conf/rc_keystore -storepass bran507025
Windows
.\jre1.6\bin\keytool -export -alias tomcat -file C:\oo.crt
-keystore .\Central\var\security\key.store -storepass changeit
Linux
./jre1.6/bin/keytool -export- -alias tomcat
-file /tmp/oo.crt
-keystore ./Central/var/security/key.store -storepass changeit
where C:\oo.crt
and /tmp/oo.crt
are examples of filenames
and locations used to
store the exported root certificate (you can choose a different filename and location).
oo.crt
from the HP Operations Orchestration system
to the system running HP Cloud Service Automation
(in this example, the file is copied to
C:\
/tmp
).On the system running HP Cloud Service Automation, run the following command:
<csa_jre>\bin\keytool -importcert -alias pas -file C:\oo.crt
-keystore <csa_jre>\lib\security\cacerts -storepass changeit$CSA_JRE_HOME/bin/keytool -importcert -alias pas -file /tmp/oo.crt
-keystore $CSA_JRE_HOME/lib/security/cacerts -storepass changeit
<csa_jre>\bin\keytool -importcert -alias tomcat -file C:\oo.crt
-keystore <csa_jre>\lib\security\cacerts -storepass changeit$CSA_JRE_HOME/bin/keytool -importcert -alias tomcat -file /tmp/oo.crt
-keystore $CSA_JRE_HOME/lib/security/cacerts -storepass changeit
where <csa_jre>
$CSA_JRE_HOME
is the directory
in which the JRE that is used by HP CSA
is installed.
yes
.To restart HP CSA:
On the server that hosts HP CSA, navigate to Control Panel > Administrative Tools > Services.
Restart the HP Cloud Service Automation service.
To restart HP CSA, on the server that hosts HP CSA, type the following:
service csa restart
service mpp restart
Remote Access Server (RAS) operations are subject to a default timeout limit of 20 minutes on HP Operations Orchestration Central. You can change the time-out setting to support operations that are likely to take more than 20 minutes to complete.
If you expect to run large deployments, change the time-out setting according to Changing the timeout limit for RAS operations in the HP Operations Orchestration Software Administrator’s Guide. You may also refer to HP Operations Orchestration User's Guide sections Adding a RAS override and Best practices for runtime environment overrides. Both documents are available on the HP Software Support Web site at http://h20230.www2.hp.com/selfsolve/manuals/ (this site requires that you register with HP Passport).
The calls HP Cloud Service Automation makes to the HP Operations Orchestration REST APIs are synchronous, and HP Operations Orchestration will time-out the connection after one hour by default. To extend this time-out, do the following:
Open the following file in a text editor:
Windows
%ICONCLUDE_HOME%\Central\conf\Central.properties
Linux
$ICONCLUDE_HOME/Central/conf/Central.properties
Add the following lines:
# the maximum flow timeout value in milliseconds, this is equivalent to 2 hrs
dharma.headless2.continuation.timeout=7200000
Open the following file in a text editor:
Windows
%ICONCLUDE_HOME%\Central\WEB-INF\applicationContext.xml
Linux
$ICONCLUDE_HOME/Central/WEB-INF/applicationContext.xml
Add the following property to the dharma.RCDefaults
section:
<bean id="dharma.RCDefaults" class="com.iconclude.dharma.util.spring.RCDefaultsSpringFactory" lazy-init="false" singleton="true">
................
<prop key="dharma.headless2.continuation.timeout">${dharma.headless2.continuation.timeout}</prop>
Install HP Matrix Operating Environment infrastructure orchestration (infrastructure orchestration) according to the manufacturer's recommendations. See HP Cloud Service Automation System and Software Support Matrix for version requirements.
The HP Cloud Service Automation System and Software Support Matrix is available on the HP Software Support Web site at http://h20230.www2.hp.com/selfsolve/manuals/ (this site requires that you register with HP Passport).
To configure HP Matrix Operating Environment infrastructure orchestration, refer to
for more information.%CSA_HOME%
$CSA_HOME
\
/
CSAKit-4.0\
/
Lib\
/
matrix operating environment\
/
README.txt
Install vCenter according to the manufacturer's recommendations. For example, follow the VMware best practices for managing individual ESX servers from a vCenter instance. You can find the VMware documentation at http://www.vmware.com/support/pubs/.
You must have a vCenter instance that can support the flows that actuate vSphere VMs. See HP Cloud Service Automation System and Software Support Matrix for version requirements.
Both the HP Cloud Service Management Console Help, which is available in a printable PDF format, and the HP Cloud Service Automation System and Software Support Matrix are available on the HP Software Support Web site at http://h20230.www2.hp.com/selfsolve/manuals/ (this site requires that you register with HP Passport).
Install HP Network Automation according to the manufacturer's recommendations. See HP Cloud Service Automation System and Software Support Matrix for version requirements.
Installation notes:
HP software product documentation and the HP Cloud Service Automation System and Software Support Matrix are available on the HP Software Support Web site at http://h20230.www2.hp.com/selfsolve/manuals/ (this site requires that you register with HP Passport).
The following tasks are required to configure HP Network Automation to integrate successfully with HP Cloud Service Automation:
If HP CSA and HP Network Automation are not installed on the same system, copy the HPN Virtual Network.exp
command script to the system on which HP Network Automation is installed.
The default location of the command script file is
where
%CSA_HOME%
$CSA_HOME
\
/
CSAKit-4.0\
/
Lib\
/
network automation%CSA_HOME%
$CSA_HOME
is the directory in which
HP Cloud Service Automation is installed (for example,
C:\Program Files\Hewlett-Packard\CSA/usr/local/hp/csa
).
From the Import/Export Scripts/Diagnostics page, click Choose File and
browse to the location of the HPN Virtual Network.exp
command script.
Click Continue.
The message Important: You have successfully imported one or more Command Scripts or
Diagnostics.
displays.
Vlan Id
, Vlan SubnetIP
, and Vlan SubnetMask
.
For example, set Vlan Id = 200, Vlan Subnet IP = 192.168.30.1 and Vlan Subnet Mask = 255.255.255.0.Click Save.
If the networking switch is already discovered and a device snapshot is successfully
taken in the HP Network Automation portal, the message
Succeeded
displays.
If you are using an HP networking switch, verify that the HPN Create Vlan
and
HPN Delete Vlan
command scripts use the EXT_HP_Procurve Network Automation driver
that supports a wide range of HP networking switches. If you want to use another networking switch,
update the mode of each command script.
To verify/update the command script mode:
HPN Create Vlan
, click Edit.HPN Delete Vlan
command script.Install HP Server Automation to the correct version and patch level. See HP Cloud Service Automation System and Software Support Matrix for version requirements.
You can determine your version and patch level by using the HP Server Automation Client and selecting Help > About.
Installation notes:
HP software product documentation is available on the HP Software Support Web site at http://h20230.www2.hp.com/selfsolve/manuals/ (this site requires that you register with HP Passport).
The following tasks are required to configure HP Server Automation to allow read and write access to the required areas:
Click New User in the Users tab toolbar and complete the following fields using the values listed in the following table:
Field Name | Value |
---|---|
Last Name | Service Account |
First Name | CSA |
Full Name | CSA Service Account |
Email Address | <your email address> |
User Name | hpcsa |
Password | <password> |
Click New Group and complete the following fields using the values listed in the following table:
Field Name | Value |
---|---|
Group Name | hpcsa-admin |
Group Description | HPCSA Administrators |
Not Assigned | Read & Write |
Opsware | Read |
Select the Facilities tab and select Read & Write to the appropriate facility.
If only one facility exists, select Read & Write for it.
Select the OGFS Permissions tab, click Add Permissions, and enter the following permissions:
root
.Click Add Permissions and enter the following permissions:
Verify that the client is installed.
If neither the icon nor the Start Menu link appear, then you need to install the client by performing the following steps:
You must have a JRE installed in order to use the Opsware Launcher on a Windows system.
Launch the client with the following credentials:
The above login information may vary depending on your installation.
These steps prepare a VMware template to self-register with HP Server Automation.
Virtual machines (VMs) created by the HP Cloud Service Automation solution are created based on virtual machine templates. The HP Cloud Service Automation flows reference a vSphere template name, and perform a clone operation to provision new virtual machines. These templates would generally provide an operating system image only, with no application software installed.
To allow applications (such as Apache) to be deployed to the image, you must install and configure HP Server Automation and create a template that includes the HP Server Automation Agent software. That is, in order to manage the virtual server and to install application software, the clones are configured to self-register upon power-on with an HP Server Automation system. Once registered as a managed server, software policies are applied to the server in order to install and configure the correct applications. Refer to the HP Server Automation Policy Setter Guide and the HP Server Automation Application Deployment User Guide in the HP Server Automation documentation for more information on managing servers and configuring software policies. HP software product documentation is available on the HP Software Support Web site at http://h20230.www2.hp.com/selfsolve/manuals/ (this site requires that you register with HP Passport).
For cloned virtual machines to register with the HP Server Automation system upon power-on, prepare a template with an HP Server Automation agent. The following is a general outline of the steps to be performed:
First, create a virtual machine with the appropriate operating system image that you would like to template. Provision the VM with an operating system through any method supported by vSphere:
Refer to the appropriate vSphere documentation to create a new virtual machine with an installed operating system image.
Refer to the vSphere documentation set for detailed information on the creation, configuration, and operating system installation for a new virtual machine. There are several options to install an operating system onto a new virtual machine. One of the options available is to use the PXE network boot facility from the HP Server Automation server, with an operating system installation profile that integrates the installation of an HP Server Automation agent. A virtual machine which is provisioned using this method starts the agent upon bootup, and attempts to register it with the HP Server Automation system.
If you use another method to provision an operating system on the virtual machine, the HP Server Automation agent can be installed from the HP Server Automation system. You can refer to the product documentation for an expanded discussion of this process; the following instructions describe one method.
Discover the virtual machine in the Unmanaged Servers (HP SA 9.x) or SA Agent Installation (HP SA 10.x) window in HP Server Automation. You can scan an entire subnet or enter the IP address for the virtual machine and initiate a scan to discover it.
Click OK.
When the installation process completes successfully, the agent is installed, and the virtual machine is visible in the All Managed Servers tab. The hostname has not been set, as we plan to convert this virtual machine to a generic template. So, the default host name is used for the virtual machine.
The agent on our virtual machine template must be prepared to install and register a new machine server with HP Server Automation each time we create a new clone. To prepare the agent we must "sanitize" the agent configuration on our template machine by doing the following:
Execute the BRDC HPSA agent sanitizer APX:
In the Specify any needed parameters for this program execution field, enter the Object ID, which you previously obtained for the virtual server template:
Shut down the virtual machine after the job completes successfully and the agent has been prepared.
Do not reboot this virtual machine again until after it has been converted to a vSphere template.
The template is now ready to use to clone new virtual machines. HP Cloud Service Automation uses a simple customization template that sets the hostname equal to the VM name. Additional customization is possible during the clone operation. See the Basic Customization section below.
When a newly cloned virtual machine powers up, the HP Server Automation Agent installs and then contacts the HP Server Automation system to self-register. Shortly after power on, you can refresh the All Managed Servers view in the HP Server Automation client to locate the new virtual machine record.
Perform the following basic customizations:
Customize as appropriate, noting two important items:
The template must be installed on the system containing the vSphere client software. See Configure VMware vCenter for more information.
Consult the vSphere documentation for additional details. You can find the VMware documentation at http://www.vmware.com/support/pubs/.
Configure VMware vCenter by installing prepared templates. In the vSphere environment, a template is a master copy of a virtual machine that can be used to create many clones. A clone is a copy of a virtual machine.
You can learn more about creating templates and working with clones in vSphere by referring to VMware's vSphere Virtual Machine Administration Guide for vCenter Server (EN-000312-02), available in the VMware documentation. You can find the VMware documentation at http://www.vmware.com/support/pubs/.
Virtual machines created by the HP Cloud Service Automation solution are created based on virtual machine templates. To allow applications (such as Apache) to be deployed to the image, you must create a template that includes HP Server Automation Agent software. See Prepare a VMware Template to Self-Register with HP Server Automation for more information.
To install a prepared template, do the following:
Copy the template folder to the datastore by clicking on the Upload files to this datastore button.
The following image shows the Datastore Browser window with Upload files to this datastore highlighted. It also shows a rhel53x64-clone
folder that was uploaded to this datastore:
Consult the vSphere documentation for additional details. You can find the VMware documentation at http://www.vmware.com/support/pubs/.
Install HP SiteScope to the correct version and patch level. See HP Cloud Service Automation System and Software Support Matrix for version requirements.
Installation notes:
HP software product documentation is available on the HP Software Support Web site at http://h20230.www2.hp.com/selfsolve/manuals/ (this site requires that you register with HP Passport).
The following tasks are required to configure HP SiteScope to integrate successfully with HP Cloud Service Automation:
HP SiteScope is installed with a default of secured API calls required for configuring monitors. HP Cloud Service Automation does not support secured API calls; therefore, you must change this setting. To re-configure HP SiteScope so it does not use secure APIs, you must make the following change to the configuration:
Stop the HP SiteScope service by typing the following command in a console window:
net stop SiteScope
<sitescopeInstallDir>\groups\master.config
file in a text editor.Change the _accessControlled=true
property value to _accessControlled=false
.
Restart the HP SiteScope service by typing the following command in a console window:
net start SiteScope
From the HP Cloud Service Automation server, copy the
file
to the %CSA_HOME%
$CSA_HOME
\
/
CSAKit-4.0\
/
Lib\
/
sitescope\
/
CSA templates autoimport.tmpl<sitescopeInstallDir>\persistency\import
directory on the
HP SiteScope server. When the
CSA templates autoimport.tmpl
file is processed,
HP SiteScope creates a template container
(CSA templates
) and two credential profiles
(WINDOWS-CSA-TARGETS
and LINUX-CSA-TARGETS
).
CSA templates
container. You must wait for the
HP SiteScope server to finish processing the
CSA templates autoimport.tmpl
file before the CSA templates
template container is displayed.WINDOWS-CSA-TARGETS
and LINUX-CSA-TARGETS
credential profiles, which you will
configure in Step 4: Configure
HP Cloud Service Automation Credential Profiles.Two additional HP Cloud Service Automation templates,
CSA templates Silver
and CSA templates Gold
, must be
manually imported. These templates are used by the CSA_BP_VCENTER_COMPUTE_SITESCOPE_MODIFY_v4.00.00 service design.
Note: You must be able to access files in the
directory from the
HP SiteScope Dashboard. If necessary,
copy this directory to the system from which you are
launching the HP SiteScope Dashboard.%CSA_HOME%
$CSA_HOME
\
/
CSAKit-4.0\
/
Lib\
/
sitescope
%CSA_HOME%
$CSA_HOME
\
/
CSAKit-4.0\
/
Lib\
/
sitescope
(or the directory to which
this directory was copied) and import CSA templates Silver.tmpl
.CSA templates Gold.tmpl
.Configure the credentials used to log in to every Windows system and every Linux system monitored by HP SiteScope. The credentials to all Windows systems must be the same. Likewise, the credentials to all Linux systems must be the same.
Configure the credentials used to log in as the administrator of HP SiteScope. These credentials are used by HP Cloud Service Automation when configuring HP SiteScope resource providers from the Cloud Service Management Console.
Install HP Universal CMDB to the correct version and patch level. See HP Cloud Service Automation System and Software Support Matrix for version requirements.
If you are using an existing installation of HP Universal CMDB, then you should verify that the necessary patches and updates have been applied. If not, then follow the instructions presented here to update your installation.
If you are installing HP Universal CMDB, then you should follow the installation instructions in the HP Universal CMDB documentation and then follow the instructions presented here to configure your installation.
Monitor the service status by browsing to http://localhost:8080/status.
You will need to wait until the Default Client status is up on the status page. This takes approximately five minutes. Until then, the HP Universal CMDB console cannot be used.
HP software product documentation is available on the HP Software Support Web site at http://h20230.www2.hp.com/selfsolve/manuals/ (this site requires that you register with HP Passport).
To configure HP Universal CMDB, deploy a file to your HP Universal CMDB server:
From the HP Cloud Service Automation server, navigate
to the
folder where
%CSA_HOME%
$CSA_HOME
\
/
CSAKit-4.0\
/
Lib\
/
ucmdb%CSA_HOME%
$CSA_HOME
is the directory in which
HP Cloud Service Automation is installed.
%CSA_HOME%
$CSA_HOME
\
/
CSAKit-4.0\
/
Lib\
/
ucmdb\
/
CSAIntegration.zip
to the
HP Universal CMDB server.%CSA_HOME%
$CSA_HOME
\
/
CSAKit-4.0\
/
Lib\
/
ucmdb\
/
README.txt
file
for more information on how to deploy the zipped file.No installation is required for HP Cloud Services as it is accessible through the Web. However, you will need to configure HP Cloud Services to integrate with HP Cloud Service Automation. See Configure HP Cloud Services in this document for more information.
The following tasks are required to configure HP Cloud Services to integrate successfully with HP Cloud Service Automation:
In order to access HP Cloud Services, you must be a registered user. Sign up for HP Cloud Services by accessing this URL from a supported Web browser: https://console.hpcloud.com/signup
To create an HP Cloud Services instance, you must have a Security Group and KeyPair configured in the HP Cloud Services environment:
You can configure the Security Group and KeyPair values as default values in the Server Group component properties of an HP CSA service design.
Install HP Service Manager according to the manufacturer's recommendations. See HP Cloud Service Automation System and Software Support Matrix for version requirements.
Installation notes:
HP software product documentation and the HP Cloud Service Automation System and Software Support Matrix are available on the HP Software Support Web site at http://h20230.www2.hp.com/selfsolve/manuals/ (this site requires that you register with HP Passport).
The following tasks are required to configure HP Service Manager to integrate successfully with HP CSA:
Importing the HP CSA integration file into HP Service Manager creates the OO_CSA3 script library.
Locate the HPSM_CSA_Integration_file.unl
file installed with
HP CSA.
The default location of the file is
%CSA_HOME%\CSAKit-4.0\Lib\service manager$CSA_HOME/CSAKit-4.0/Lib/service manager
where
%CSA_HOME%
$CSA_HOME
is the directory in which
HP Cloud Service Automation is installed (for example,
C:\Program Files\Hewlett-Packard\CSA/usr/local/hp/csa
).
If HP CSA and HP Service Manager are installed on different systems, copy this file to the system running HP Service Manager.
Update the sample Approval Definition provided with HP Service Manager to create a new subscription approval.
Verify or set the following fields and values:
Field Name | Value |
---|---|
Name | Subscription Approval |
Approval Condition | true |
Approval Type | All must approve |
Group/Oper | Change.Approver |
Sequence | 1 |
Condition | true |
Export HP Operations Orchestration's SSL certificate. On the system on which HP Operations Orchestration is installed, open a command prompt and type the following:
Windows
cd "%ICONCLUDE_HOME%\Central\conf"
"%ICONCLUDE_HOME%\jre1.6\bin\keytool.exe" -exportcert -alias pas -file pas.crt
-keystore rc_keystore -storepass bran507025
.\jre1.6\bin\keytool -export -alias tomcat -file pas.crt
-keystore .\Central\var\security\key.store -storepass changeit
Linux
cd $ICONCLUDE_HOME/Central/conf
$ICONCLUDE_HOME/jre1.6/bin/keytool.exe -exportcert -alias pas -file pas.crt
-keystore rc_keystore -storepass bran507025
./jre1.6/bin/keytool -export- -alias tomcat -file pas.crt
-keystore ./Central/var/security/key.store -storepass changeit
pas.crt
to the system on which HP Service Manager is installed,
to the <HPSM_install_directory>\Server\RUN\jre\lib\security
(Windows)
or <HPSM_install_directory>/Server/RUN/jre/lib/security
(Linux) directory.On the system on which HP Service Manager is installed, import the HP Operations Orchestration certificate. Open a command prompt and type the following:
Windows
cd "<HPSM_install_directory>\Server\RUN\jre\lib\security"
"<HPSM_install_directory>\Server\RUN\jre\bin\keytool.exe"
-importcert -alias pas -file pas.crt
-keystore cacerts -storepass changeit
Linux
cd <HPSM_install_directory>/Server/RUN/jre/lib/security
<HPSM_install_directory>/Server/RUN/jre/bin/keytool.exe
-importcert -alias pas -file pas.crt
-keystore cacerts -storepass changeit
When HP Service Manager accesses HP Operations Orchestration as a client, the HP Operations Orchestration certificate uses a hardcoded key for the CN. On the system running HP Service Manager, this CN, opsware.com, must be mapped to the IP address of the system on which HP Operations Orchestration Central server is installed. The following is an example of how to map the CN to the IP address:
On the system running HP Service Manager,
open C:\Windows\system32\drivers\etc\hosts
(Windows)
or /etc/hosts
(Linux) in a text editor.
Add the following to the file:
<IP_address_of_HPOO_central_server> opsware.com
where <IP_address_of_HPOO_central_server> is the IP address of the system on which HP Operations Orchestration Central server is installed.
You have completed the initial installation and configuration of HP CSA and can begin familiarizing yourself with the capabilities of HP CSA.
Launch the Cloud Service Management Console
(type the following URL in a supported Web browser:
https://<csahostname>:8444/csa
) and log in using
the out-of-the-box user (admin) and password (cloud).
Launch the Marketplace Portal
(type the following URL in a supported Web browser:
https://<csahostname>:8444/mpp
) and log in using
the out-of-the-box user (consumer) and password (cloud).
To complete the configuration of HP CSA, refer to the following documents:
HP Cloud Service Automation Configuration Guide: The configuration guide describes the process for preparing LDAP for the Cloud Service Management Console and for consumer organizations, requesting software licenses, configuring SSL, customizing the Cloud Service Management Console, configuring HP CSA to be compliant with FIPS 140-2, and performing other HP CSA customizations. The configuration guide also describes the process of how to import the sample HP Operations Orchestration flows included with HP CSA.
HP Cloud Service Automation Service Design Guide: The service design guide describes how to use HP CSA to create automated, on-demand cloud services. The guide covers key concepts and steps for HP CSA service design, including sequenced and topology design models, the role of the service design, design layouts and components, service lifecycles, and service options.
© Copyright 2010-2014 Hewlett-Packard Development Company, L.P.