Customized output from:
Document Release Date: August 2014 Software Release Date: August 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 1994 - 2014 Hewlett-Packard Development Company, L.P.
Adobe™ is a trademark of Adobe Systems Incorporated.
Java is a registered trademark of Oracle and/or its affiliates.
Microsoft® and Windows® are U.S. registered trademarks of Microsoft Corporation.
Oracle® is a registered US trademark of Oracle Corporation, Redwood City, California.
UNIX® is a registered trademark of The Open Group.
Start by choosing what you want to do in the panel on the left.
Note: You can find document release date information from the Legal Notices and Support Information link at the bottom of this page.
The following steps are customized according to your selections. Check that your selections are correct.
If you want to select different options, click Change. Make your selections, and then click View or Print.
This installation guide is interactive and enables you to view the installation instructions that are relevant for your HP Service Manager setup. You can change your selections any time by clicking the Change button on the right side of the Check your selections section at the top of the page. When you complete a step or task, you can click the check box to the left of the heading to collapse that section. To expand sections, clear the check box.
The entry page of this guide contains the following identifying information in the bottom left corner:
To check for updates, or to verify that you are using the most recent edition of this document, go to the HP Software Product Manuals web site (http://h20230.www2.hp.com/selfsolve/manuals). This site requires that you register for an HP Passport and sign-in. To register for an HP Passport ID, click the New users - please register link on the HP Passport login page.
While it is possible to upgrade only the HP Service Manager client and server to the new version, many of the new features are not supported by the old applications. The new Process Designer, Knowledge Management search engine, Service Request Catalog, Mobility, and content modules all require 9.30 applications. To get the benefit of all the new features, you must upgrade to the HP Service Manager applications as well. Refer to the Release Notes or the What's New section of the online help for information on the new features.
If you have an application version that is not supported, you must upgrade both the applications as well as the client and server. The application versions supported by the HP Service Manager client-server are documented in the Compatibility Matrix on the HP Support matrices web site (http://support.openview.hp.com/sc/support_matrices.jsp).
You can install HP Service Manager in a production environment or in non-production environments: development, test, and reporting environments. HP recommends that you perform the installation in a development environment and then convert or push the installation to your production environment.
HP Service Manager environment overview diagram
The HP Service Manager environment overview diagram describes the components of a HP Service Manager installation. The HP Service Manager table below provides a description for each component and lists whether the component is required or optional.
Item | Name | Required? | Description |
---|---|---|---|
1 | Database Tier | Required | Consists of one or more supported RDBMS servers. Your HP Service Manager application data must reside in an external RDBMS. |
2 | RDBMS | Required | A relational database management system for storing HP Service Manager applications and data. Requires a 1 GB network connection to the HP Service Manager server. |
3 | Server Tier | Required | Contains servers that provide or process data for clients. The server tier includes the HP Service Manager server, which runs the HP Service Manager applications and manages the connections between the client and web tiers to the database tier. |
4 | HP HP Service Manager Server | Required | Manages connections between clients and the database tier. |
5 | Online help | Optional | A pre-configured web server that enables end users to access documentation from the Windows and web clients as well as directly from a web browser. |
6 | Web Applications Server | Optional | Offers Java applications and content for web clients. |
7 | Web Server | Optional | Provides HTTP or HTTPS content to web clients. |
8 | Client Tier | Required | Contains the applications and methods available for connecting to HP Service Manager. |
9 | Web Applications | Optional |
Applications that can connect to or communicate with HP Service Manager through a web services API. |
10 | HP Products | Optional |
The suite of applications that can connect to or communicate with the HP Service Manager server. Temporary licenses are integrated with the HP Service Manager server:
For a complete and up-to-date list of HP integrations, see the HP Service Manager 9.30 Compatibility Matrix on the HP Support matrices web site (http://support.openview.hp.com/sc/support_matrices.jsp). |
11 | Windows Client | Required | Intended for HP Service Manager administrators or implementers. The Windows client must be installed on a Windows workstation and requires a separate installation on each system that you want to connect to HP Service Manager. Each installation consumes a license. You must install at least one Windows client, depending on the number of administrators and power users. The Windows client enables you to design forms and work with the dbdict, capabilities that are not available to the Web client user. Requires a 100 MB network connection to HP Service Manager (SOAP over HTTP or HTTPS). |
12 | Web Client | Optional |
Recommended for end users, The web client enables users to connect to the HP Service Manager server using
a web browser, without needing to install any additional software on the user’s system.
You can install the web client once and then any number of web users can access HP Service Manager from a single URL without consuming a license. Note: There are scaling issues to consider: one web application server can only handle so many concurrent users before you need additional servers to handle the load. |
13 | Web Tier | Optional |
Web application server and web server combinations that enable users to connect via a web browser. Third-party server software that provides the HTTP or HTTPS content to HP Service Manager web clients. Some web application servers also include built-in or bundled web servers. |
The HP Service Manager installer automatically copies AutoPassJ libraries as part of the server installation. AutoPass validates your license and determines what product features are enabled. Follow the steps in this section to obtain your permanent licenses.
IP address for the system where the software is installed
Note: If your server obtains an IP address from DHCP, you may have to request a new license that matches the server’s new IP address.
Provide all required information on the Address information form, and then click Next.
The Receive Permanent Password Certificate form displays a copy of your Permanent Password Certificate. It also offers additional delivery options for your certificate. You will also receive an email containing your password certificates and license key/password file attachments.
Save the license key/password file to your system. Install license/ password(s) directly from a license key/password file. Do not manually transcribe and edit them from the license/password certificate. Copy each license key/password file to the appropriate target system.
As part of the process of obtaining a permanent AutoPass license, a .dat file or several .dat files were sent to the email address that you provided. These files contain the licensing data required to use the applicable HP Service Manager modules. After you receive these files, follow these steps to move them to the HP Service Manager server:
Note: Create the LicFile.txt file only once. If you request any additional licenses, append those licenses to the end of this file.
If you plan to run your system in a horizontally-scaled environment, copy LicFile.txt to the <HP Service Manager server installation path>\RUN\ folder on all hosts running in the horizontal group. In addition, provide the grouplicenseip parameter for each host. The grouplicenseip value should match the IP address that you provided in Step 8.
Note: If you have horizontal scaling implementation setup as a high availability failover cluster, you must request a permanent Service Manager license for both the virtual and the physical IP addresses of the host. Otherwise the Service Manager server will fail to start.
If you plan to run your system in a horizontally-scaled environment, copy LicFile.txt to the <HP Service Manager server installation path>/RUN/ folder on all hosts running in the horizontal group. In addition, provide the grouplicenseip parameter for each host. The grouplicenseip value should match the IP address that you provided in Step 8.
Note: If you have horizontal scaling implementation setup as a high availability failover cluster, you must request a permanent Service Manager license for both the virtual and the physical IP addresses of the host. Otherwise the Service Manager server will fail to start
The installation DVD includes a copy of SQL Server Express Edition as a sample database. You can use this sample database if you want to review features or show a demonstration. You must use an enterprise-level RDBMS for your development, test, and production systems. This sample database must be installed on a Windows server. Follow the instructions in this section if you want to install the sample database.
The batch file runs.
The default settings in the out-of-box sm.cfg and sm.ini files are set up to work with this sample database.
The following recommendations assume the implementation of conventional database tuning and performance measures. Actual results may vary on a system-by-system basis, based on the tuning expertise available and hardware and software selections. These recommendations are intended only as a guide and should not be implemented on a production system without extensive testing
Follow the instructions in this section to prepare your Relational Database Management System (RDBMS) prior to installing the HP Service Manager data.
Meet general space requirements:
Place all HP Service Manager data in one or more dedicated table spaces within a single DB2 instance. These table spaces must contain HP Service Manager data only. Multiple instances consume more system resources than a single-instance solution.
Place all HP Service Manager data in one or more dedicated table spaces within a single SQL Server instance. These table spaces must contain HP Service Manager data only. Multiple instances consume more system resources than a single-instance solution.
Place all HP Service Manager data in a dedicated table space within a single Oracle instance. This table space must contain HP Service Manager data only. Multiple instances consume more system resources than a single-instance solution.
Allocate at least 1 GB of data space for a test system. The amount of space necessary for a production system depends on the amount of data that you need to store and your specific implementation.
Set the sorting of characters for localized systems.
Note: Setting the sorting of characters in Service Manager is dependent on the settings defined within the back-end database or client connections to these databases. Please check with your company's Database Administrator when setting up your Service Manager database to ensure you have the correct settings for the native language(s) that will be used within Service Manager.
Database vendors provide different options for these settings and continue to add/modify settings for languages around the world. Refer to the technical documentation provided by the database vendor for more information and recommendations on the correct localization settings. For additional information, search the vendor documentation for following terms.
- Collation Setup
- Collation Sorting
- Globalization Support
- Oracle client installation globalization
- Supported territory codes
- Code pages
Create a login ID and password for HP Service Manager to use to connect to your DB2 server. The login ID requires the Connect to database, Create tables, and Create schemas implicitly DB2 connection privileges.
Create a login ID and password for HP Service Manager to use to connect to your SQL Server database.
The login must have CREATE/ALTER/DROP TABLE authority for the target database. The CREATE/ALTER/DROP TABLE authority is only required during installation and creation of new HP Service Manager tables, and only if you allow HP Service Manager to issue the DDL to create tables and indexes. When you log on to HP Service Manager, it creates a table in the default table space defined for tha
t login ID.
Note: HP Service Manager requires the Use privilege on all table spaces that it uses, including temporary table spaces.
Create a login ID and password for HP Service Manager to use to connect to your Oracle server. When you log on to HP Service Manager, it creates a table in the default table space defined for that login ID. The login ID must have the following privileges:
You can provide these privileges to an Oracle user by using the following oracle statements:
create user <smadmin> identified by <smadmin> default
tablespace <users> quota unlimited on <users>;
grant connect, resource, select any dictionary to <smadmin>;
Note: CREATE/ALTER/DROP TABLE privileges are only required during installation and creation of new HP Service Manager tables if you allow HP Service Manager to issue the DDL to create tables and indexes.
Make sure that your DB2 database is case-sensitive.
HP Service Manager supports both case-sensitive and case-insensitive Microsoft SQL server. To use HP Service Manager in case-insensitive mode, you must select a case-insensitive collation on the SQL Server before installing HP Service Manager. You can specify the desired case-sensitivity for sort order during the creation of the database. Set the SQL Server database to the desired collation when you create it. HP Service Manager automatically detects the settings.
HP Service Manager supports case-insensitivity for Oracle 11.2 and later. For earlier versions of Oracle, HP Service Manager requires a case-sensitive database. Click the appropriate task below for instructions on setting case-sensitivity.
Set up a connection to HP Service Manager:
HP Service Manager connects to the database through your RDBMS client. To set up the connection between the HP Service Manager application server and your RDBMS, know the name of the database and the login ID and password required to connect to the database server that you created above. The HP Service Manager initialization file, sm.ini, must be present in the HP Service Manager server RUN directory.
Follow these connectivity rules when you set up the connection to your SQL Server:
Install the Oracle client on your HP Service Manager server machine.
Note: HP Service Manager requires 32 bit Oracle Client library, which can be found in the Oracle 64 bit Client installation directory or Oracle 32 bit Instant Client directory. Please refer to the Oracle site to download the proper Oracle client for the platform where you plan to run HP Service Manager server.
Set time zones for reporting:
If you plan to report on HP Service Manager data using your RDBMS tools, set the sqltz parameter in sm.ini file. This is an optional parameter that the HP Service Manager server uses to control the storing of date and time values in the RDBMS. This parameter defines the time zone to use as a base for all date and time values. The time zone is specified as the name of the time zone record in the HP Service Manager tzfile. The default time zone is Greenwich/Universal (GMT). For more information about using the sqltz parameter, see the System Parameters topic in the HP Service Manager Help.
Caution! If you use different time zone settings, the dates contained in reports made by your RDBMS utility may be inaccurate.
Set your UNIX environment variable for Oracle:
setenv LD_LIBRARY_PATH $LD_LIBRARY_PATH:$ORACLE_HOME/lib32
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$ORACLE_HOME/lib32
db2empfa <dbname
>Create your DB2 database with a UTF-8 code page. All data passed from HP Service Manager to the DB2 client is encoded in UTF-8; using a UTF-8-based DB2 reduces the overhead of converting data and prevents the loss of special characters.
Create your SQL Server database with a code page that supports the character set of most of your data. Since SQL Server does not support a UTF-8 code page, you might want to use data types that support multiple character sets.
Caution! If you choose a Western European code page, the system cannot store Eastern European or Asian characters in columns defined as VCHAR, CHAR, or TEXT data types. If you must store characters from different languages, consider using the NVARCHAR, NCHAR, or NTEXT data types.
Create your Oracle database with a UTF-8 code page. All data passed from HP Service Manager to the Oracle client is encoded in UTF-8; using a UTF-8-based Oracle database reduces the overhead of converting data and prevents the loss of special characters.
. /home/db2inst1/sqllib/db2profile
”. The db2profile script, provided by your DB2 installation, updates your system’s library and class path variables automatically.Oracle Transparent Application Failover (TAF) enables database clients to reconnect to surviving nodes in an Oracle Real Application Cluster (RAC) in the event of a failure of an instance. HP Service Manager supports Oracle RAC.
All supported HP Service Manager server versions perform similar session recovery operations within the application. When HP Service Manager detects a connection failure, it attempts to reestablish the connection, set up necessary session properties, and repeat the failed transactions. HP Service Manager retries the connection for one minute. If the database is in an Oracle RAC configuration, this should allow time for failover and reconnection to another available instance.
Since similar failover functionality is available within HP Service Manager, the product has not been modified to run in an Oracle TAF configuration.
Caution! Using HP Service Manager in combination with Oracle TAF could cause connectivity issues. Do not run HP Service Manager in an Oracle TAF configuration.
Before you install the HP Service Manager server, you should meet the following requirements.
Make sure that you have a compatible operating system with the current updates.
For more information, refer to the HP Service Manager Compatibility Matrix on the HP Support matrices web site (http://support.openview.hp.com/sc/support_matrices.jsp).
Service Manager server requires the following database resources.
Requirement | Resources needed |
---|---|
RDBMS server |
|
RDBMS client |
|
Requirement | Resources needed |
---|---|
RDBMS server |
|
RDBMS client |
|
Refer to the Service Manager Compatibility Matrix for a list of currently supported RDBMS clients and servers.
Meet the required AIX service patch levels. If your systems fails to meet the required patch level, the HP Service Manager server displays an error message and will not start.
AIX 6.1 requires the following patch levels:
Ensure that Java JDK or JRE version 1.6 update 20 or later is installed on the system, and set the JAVA_HOME environment value to point to it. The HP Service Manager installer will search for it at install time. If the installer finds the java installation, it creates a JRE symlink.
Specify the appropriate number of processes. The system starts one process for each sm command line in the sm.cfg file. By default, each process is limited to 50 concurrent user sessions. The system assigns each user session or background process a dedicated thread.
Note: If you start background processes by using the sm system start command in the sm.cfg file, then the sm processes own the background process threads. If you start the background processes from a user session inside HP Service Manager, then the thread controller process that owns the user session also owns the background process threads.
For DB2 or Oracle database, update your system's PATH variable to include the path to the 32-bit versions of your RDBMS client. Refer to your operating system documentation for information on setting variables.
For Microsoft SQL server, configure ODBC DSN.
Update your system's LIBPATH variable to include the path to the 32-bit versions of your RDBMS client. Refer to your operating system documentation for information on setting variables.
Update your system's SHLIB_PATH variable to include the path to the 32-bit versions of your RDBMS client. Refer to your operating system documentation for information on setting variables.
Update your system's LD_LIBRARY_PATH variable to include the path to the 32-bit versions of your RDBMS client. Refer to your operating system documentation for information on setting variables.
Adjust kernel resources. A server uses approximately 50 MB of base shared memory and requires an additional 5 MB of shared memory for every 50 users. You can specify the amount of shared memory the system allocates by using the shared_memory parameter in the sm.ini file.
The following kernel resource requirements are the minimum values required to run a HP Service Manager server. If you run other programs that require kernel resources on the same system as HP Service Manager, then add the HP Service Manager kernel resource requirements to the existing resources. For example, if the existing system requires 100 MB in kernel resources, and HP Service Manager requires an additional 50 MB, then update the kernel resources to 150 MB.
You do not need to manually adjust kernel resources on AIX systems because they are self-adjusting. However, warnings may be generated if the UDP buffer sizing set in the configuration files surpasses kernel limits. A superuser can change kernel limits to enhance performance of UDP communication.
To retrieve the UDP buffer sizing setting: use the no -o sb_max
command.
To change the setting: no -o sb_max=8388608
Note: AIX only permits sizes of 1048576, 4194304, 8388608, etc.
Solaris may generate warnings if the UDP buffer sizing set in the configuration files surpasses kernel limits. A superuser can change 0 kernel limits to enhance performance of UDP communication.
To retrieve the UDP buffer sizing setting: use the ndd -set/dev/udp udp_max_buf
command.
To change the setting: ndd -set/dev/udp udp_max_buf 8388608
Use the SAM utility to configure kernel parameters. You must be a root user or have superuser capabilities before you start the SAM utility. To configure kernel IPC parameters:
shmmni: This kernel parameter enables you to set the maximum number of shared memory segments system-wide.
Note: HP Service Manager uses 12 semaphores, regardless of the number of users logged on to the system.
When you finish modifying the parameters, the SAM utility guides you through the steps to restart the system. Restart to activate the changes.
To configure kernel IPC parameters:
The default shared memory limit (both SHMMAX and SHMALL) is 32 MB, but you can change it from the proc file system without restarting the system. For example, to specify 128 MB:
# echo 134217728 >/proc/sys/kernel/shmall
# echo 134217728 >/proc/sys/kernel/shmmax
You can use sysctl.conf to control these parameters. Add the following to the /etc/sysctl.conf file:
kernel.shmall = 134217728
kernel.shmmax = 134217728
sysctl.conf is usually processed at startup but can be called later.
shmmni: This kernel parameter enables you to set the maximum number of shared memory segments system-wide.
Note: HP Service Manager uses 12 semaphores, regardless of the number of users logged on to the system.
Adjust UDB buffer sizing if necessary. Linux may generate warnings if the UDB buffer sizing set in the configuration files surpasses kernel limits. For example, a warning might look like the following:
23966( 23966) 08/11/2009 15:38:33 receive buffer of socket
java.net.DatagramSocket@c9d92c was set to 20MB, but the OS only
allocated 131.07KB. This might lead to performance problems.
Please set your max receive buffer in the OS correctly (e.g.
net.core.rmem_max on Linux)
A superuser can change 0 kernel limits to enhance
performance of UDP communication. To retrieve the UDB buffer sizing setting, use the sysctl -w net.core.rmem_max
command. To change the setting, use the sysctl -w net.core.rmem_max=8388608
command.
Disable the Linux security feature, exec-shield-randomize. The out-of-box smstart script sends you an error message and does not start the server if exec-shield-randomize is on. If you use your own script instead of smstart, be aware that the server can start if exec-shield-randomize is turned on, but it will stop later.
The /proc/sys/kernel/exec-shield-randomize file controls whether Exec-Shield randomizes VM mapping. You can turn off exec-shield-randomize by using any of the following options:
Use the following command:
echo 0 >/proc/sys/kernel/exec-shield-randomize
The default value for /proc/sys/kernel/exec-shield-randomize is 1.
Include the following line in the /etc/sysctl.conf file:
kernel.exec-shield-randomize=0
Include the following line in the /etc/grub.conf file:
exec-shield=0
Install HP Service Manager in a development environment and then convert or push the installation to your production environment.
This installation only upgrades the HP Service Manager. Refer the HP HP Service Manager 9.30 Upgrade Guide for information about upgrading your HP Service Manager applications and data from previous versions.
To install the Service Manager server, follow these steps:
The installation wizard starts.
Click Next to accept the default installation folder: C:\Program Files\HP\HP Service Manager 9.30\Server, or click Browse to choose a different installation location.
Caution! Do not install the server over existing versions of ServiceCenter or HP Service Manager. Install in a new folder.
Caution! The HP Service Manager server folder name cannot contain parentheses or use non-ASCII characters. The server cannot start if installed in a folder with a noncompliant folder name.
Select the Run the configuration program after install option to open the configure server tool at the end of the installation.
Note: You can also configure the HP Service Manager server manually by editing the sm.ini initialization file in a text editor.
Click Finish to exit the Setup wizard. The server installation is complete, and the Configuring HP HP Service Manager Server wizard opens. Follow the steps in the next section to configure the server.
Install HP Service Manager in a development environment and then convert or push the installation to your production environment.
This installation only upgrades the HP Service Manager server. Refer the HP HP Service Manager 9.30 Upgrade Guide for information about upgrading your HP Service Manager applications and data from previous versions.
The following convention identifies variables that may change depending on
your particular installation: <variable>
When you see a variable in brackets during the installation, replace the variable with information specific to your system. Do not type the brackets (< >) as part of the command.
To install the Service Manager server, follow these steps:
Run the setupHP11.bin script.
Note: The setup scripts assume you will run them from an X-Windows
environment. If you prefer to run the scripts from a console instead,
add “-console” to the command line. For example, setupHP11.bin -console
.
Run the setupHPIA64.bin script.
Note: The setup scripts assume you will run them from an X-Windows
environment. If you prefer to run the scripts from a console instead,
add “-console” to the command line. For example, setupHPIA64.bin -console
.
Run the setupaix script.
Note: The setup scripts assume you will run them from an X-Windows
environment. If you prefer to run the scripts from a console instead,
add “-console” to the command line. For example, setupaix -console
.
Run the setupSolaris.bin script.
Note: The setup scripts assume you will run them from an X-Windows
environment. If you prefer to run the scripts from a console instead,
add “-console” to the command line. For example, setupSolaris.bin -console
.
Run the setupLinuxX86.bin script.
Note: The setup scripts assume you will run them from an X-Windows
environment. If you prefer to run the scripts from a console instead,
add “-console” to the command line. For example, setupLinuxX86.bin -console
.
At the installation script prompt, type the installation directory where you want to install HP Service Manager. Follow these rules:
The system takes several minutes to read the contents of the DVD, uncompress the files, and complete the server installation.
To automatically configure the server, run the configure script in your <Install path>/ directory to update the sm.imi file.
Note: You can also configure the HP Service Manager server by editing the sm.ini configuration file. Follow the instructions in the next section if you want to configure the server manually.
You can customize your server installation by modifying the HP Service Manager initialization file (sm.ini).
You can define the processes the system starts automatically and the system’s startup parameters from the HP Service Manager configuration file (sm.cfg), which determines how the system starts when started from a service.
You can define the processes the system starts automatically and the system’s startup parameters from the HP Service Manager configuration file (sm.cfg), which determines how the system starts when started from the smstart script.
If you select the Run the configuration program after installation option, the configuration tool starts automatically during your installation.
When you install the server for the first time, the default settings are configured for the sample database. While this tool is intended to configure new or test implementations running the out-of-box sample data, you can use it whenever you want to change the settings in your system’s sm.ini file. Refer to the HP Service Manager Help for a complete list of the parameters stored in the sm.ini file.
Caution! The configuration tool overwrites your current sm.ini settings. You should back-up your system’s sm.ini file prior to running the configuration utility to prevent any accidental data loss or loss of service.
If you are upgrading an existing installation, you may need to copy some parameters from the HP Service Manager initialization (sm.ini) file in the old installation to the sm.ini file in the new installation after you install the new server. Some existing parameters have new names. Other parameters are now obsolete and require you to use new functionality. Follow the instructions in the task below and make any necessary changes.
If necessary, make the required changes for each of the following parameters:
Old name | New name | Required change |
---|---|---|
autopass_dir | licensefile | The default path to the license file is now in the server’s RUN directory. If you want to retain your previous license file path, you must specify it with the new licensefile parameter. |
cacertpem | truststoreFile | Move your CA certificate from a PEM file to a Java keystore and provide the path to this keystore with the truststoreFile parameter. |
certpem | keystoreFile | Move your server certificate from a PREM file to a Java keystore and provide the path to this keystore with the keystoreFile parameter. |
dhpem | keystoreFile | This parameter is obsolete. You can set DH encryption properties when you create your Java keystore. |
pkpem | keystoreFile | Move your server private key from a PEM file to a Java keystore and provide the path to this keystore with the keystoreFile parameter. |
pkpempass | keystorePass | Move your server private key from a PEM file to a Java keystore and provide the password to this keystore with the keystorePass parameter. |
sccluster | group | Use the new parameter to shut down your virtual group. |
scclusterbindaddress | groupbindaddress | Use this parameter to specify which IP Service Manager should bind to when your system has multiple IP addresses available from multiple network interfaces. |
scclustermcastaddress | groupmcastaddress | Use this parameter to define your horizontally scaled system. |
scclustername | groupname | Use the new parameter to define your server group name. |
scclusterport | groupport | Use the new parameter to define your server group port. |
scemail | emailout | Use the new parameter to process outbound e-mail from HP Service Manager. |
schost | host | Use the new parameter to shut down or standby your system |
sctimeramount | heartbeatinterval | Use the new parameter to keep client connections open. |
soapaccepttimeout | sessiontimeout | Web services client connections now use the client time out limits. |
soapreceivetimeout | sessiontimeout | Web services client connections now use the client time out limits. |
ssl_trustedClientspem | trustedclientsJKS | Move your list of trusted clients from a PEM file to a Java keystore and provide the path to this keystore with the trustedclientJKS parameter. |
timeoutlimit | sessiontimeout | Use the new parameter to set your client’s session time out. |
If you have configured SSL or trusted sign-on, you must copy the following files from the previous installation folder to the new installation folder:
Start the HP Service Manager server so that users can connect with client sessions. You can start the server from the Windows command prompt or from Windows services. Click a method below to view instructions for starting the server using that method:
Start the HP Service Manager server so that users can connect with client sessions.
cd <install path>/HP Service Manager 9.30/Run
.smstart
You can uninstall the server from Add/Remove Programs or from the HP Service Manager installation DVD. Click a task below to view instructions for uninstalling the server using that method:
Install at least one Windows client for the system administrator or group of power users. You must install a HP Service Manager client on a Windows workstation. You can support clients running on other operating systems by installing the HP Service Manager web tier.
Install at least one Windows client for the system administrator or group of power users. You must have local administrator privileges to install the Windows client. By default, the client workspace and configuration information is stored in the following directory: C:\Documents and Settings\user_name\Service Manager.
Caution! Make a backup of any customized Help files that you have created for your HP Service Manager clients. The installer for the HP Service Manager 9.30 Windows client overwrites Help from prior clients.
You cannot upgrade previous HP Service Manager clients to the HP Service Manager 9.30 Windows client. Instead, simply install the HP Service Manager 9.30 Windows client in a new folder. HP recommends that you remove previous HP Service Manager clients.
Make sure that your client workstation meets these requirements:
Requirement | Minimum | Recommended |
---|---|---|
OS | Windows XP Professional SP2 or higher | Windows Vista SP1 or higher |
CPU |
Pentium III 650Mhz |
Pentium IV or Celeron 2.4 GHz |
RAM | 256 MB | 384 MB |
HD | 150 MB online help installed | 150 MB with Help Server installed 300 MB with documentation installed |
Resolution | 800 x 600 (16 colors) | 1280 x 1024 (256 colors) |
Network | 100 Megabit | 100+ Megabit |
Login account | Local administrator account | Local administrator account |
You can install a HP Service Manager Windows client locally or on a network share where multiple users run from the shared client installation. Click a task below to view instructions for installing the Windows client on a local machine or on a network share.
Note: The HP Service Manager Windows client is mainly for Service Manager administrators and implementers. HP recommends that you use the web client for end users.
Caution! If you share a Windows client on a network share, you run the risk of running out of user licenses or network system resources to run the client.
You can connect to multiple servers from one HP Service Manager client. Each connection opens in its own window.
The first time you access the Windows client, the Connections window opens, enabling you to define a connection to a HP Service Manager host server. You can add and save multiple connection settings from the Connections window.
You must set your connection to an active server process. These are the default settings:
Notes:
Parameter | Default option | Description |
---|---|---|
Name | New_configuration | The name of this configuration. |
User name | User name of the Windows user currently logged on. | The name that you use to log in to the server. |
Password | blank | The password that you use to log in to the server. |
Remember my password | False | An option to tell the system whether to store your password. |
Automatically log in | False | An option to log in automatically when you start the HP Service Manager client. |
Server host name | localhost | The name of the server that hosts the HP Service Manager service. |
Server port number | 13080 | The port number that your computer uses to connect with the server. |
Language | blank | The language to use for this session (can differ from the language set on the computer). |
Connection identified by a color | blank | An option to change the background color of your connection. |
Use SSL Encryption: An option that uses a Secure Socket Layer (SSL) encryption tool to protect your data when transmitting it over the network.
Caution! You must define a valid CA certificates file to enable SSL encryption. The client installation includes a sample CA certificate file: cacerts. cacerts exists in the C:\Program Files\HP\Service Manager 9.30\Client\ plugins\com.hp.ov.sm.client.common_9.30 folder.
The client uninstall process intentionally preserves your client configuration settings and any other files that have changed since the initial installation. You must manually remove these files if you want to completely uninstall HP Service Manager from your system. HP recommends that you delete the entire client installation folder and the local writeable workspace and configuration folder if you do not want to preserve any existing client settings.
The web tier enables users to connect to the server by using a web browser. It can run on both Windows and UNIX platforms. There are scaling issues to consider, one web application server can only handle so many concurrent users before you need additional servers to handle the load.
The HP Service Manager web tier uses both a web server and a web application server to access HP Service Manager forms through a web browser. The web server handles incoming HTTP requests while the web application server runs the Java and JSP necessary for connecting to HP Service Manager.
Note: Some web application servers such as Tomcat and WebSphere include built-in web servers.
Install the web tier by deploying the webtier-9.30.war or .ear file to your web application server. Some web application servers also require you to install the Sun J2SE Java Development Kit (JDK).
Authenticate that the web application server is a valid host
Note: If you want to demonstrate Web tier functionality, you can disable the secureLogin parameter from the web configuration file (web.xml)
A trusted sign-on implementation: You want web client users to log in to HP Service Manager without entering a user name and password.
A trusted sign-on implementation requires a web server to accept the pre-authenticated HTTP header information from your authentication software (such as SiteMinder or Integrated Windows Authentication). You must install and configure the authentication software separately. See your web server documentation for information about the HTML headers that your web server expects from your authentication software. For additional information, go to the Software Support Online site at http://support.openview.hp.com/ and search for the following white paper on setting up single sign-on in HP Service Manager: SSL Setup and Single Sign-on in Service Manager using Windows or Third Party Authentication.
A load balanced implementation: You want to distribute web client connections among multiple web application servers.
A load-balanced implementation uses a web server to route connection requests to two or more web application servers. You must configure the web server to identify the web application servers (also known as workers) that are available to accept web client requests. For some web server and web application server combinations, you may need to install additional connection software. For example, to route requests to Tomcat web application servers using the Apache web server, you must install the proper connector. See your web server and web application server documentation for information about routing HTTP requests to available worker web application servers.
A scaled implementation to support a large number of concurrent users: You want to support 300 or more concurrent web client connections.
A scaled implementation uses the load balanced implementation described above to support a large number of concurrent web client users. As a general rule, HP recommends starting one worker web application server for every 300 concurrent web client connections you want your web tier to support. To help determine the number of connections your web tier can support, go to the Software Support Online site and search for the following white paper: HP Service Manager 7 Reference Configurations.
The HP Service Manager web tier contains a J2EE-compliant web application that runs on your web application server. Each web application server has its own method of deploying web applications. See your web application server documentation for specific instructions on deploying a web application. This section provides example implementation instructions.
The following table provides a summary of deployment methods required.
Web application server | Deployment method |
---|---|
Apache Tomcat | Copy the webtier-9.30.war file to the webapps folder and start the web application server. |
IBM Web Application Server | Open the administration console and install the web application from the webtier-ear-9.30.ear file. |
Oracle WebLogic |
Open the administration console and deploy the webtier-9.30.war file. |
JBoss EAP |
Copy the webtier-9.30.war file to the deploy folder (for example: C:\Program Files\jboss-5.1.0.GA\server\default\deploy) and start the web application server. |
Note: Be sure to set up your Web Tier with only the minimum required functionality. Enabling more functionality in web and application servers (extra languages or scripts such as VB, PHP, CGI, and so on), increases the risk of security breaches. HP recommends that you follow well-known best practices for a secure application server.
Web tier log files: The default log file is sm.log, located in <web app install dir>\bin. You can change the default log file and location in log4jproperties, which is located in <web app install dir>\webtier-9.30\WEB-INF.
You can configure a web server to redirect web-client specific URLs to the Service Manager Web tier. The following instructions illustrate redirecting requests from a Windows Internet Information Services (IIA) web server to the default Web tier URL.
Edit the workers.properties.minimal (IIS 5) or workers2.properties (IIS 6.2) file to include the following five parameters:
Note: If you change the default application name from webtier-9.30, then you will need to change the URI mappings to match your Web tier’s application name.
If you are upgrading an existing installation, you may need to copy some parameters from the HP Service Manager web tier configuration (web.xml) file in the old installation to the web.xml file in the new installation after you install the new server. Some existing parameters have new names. Other parameters are now obsolete and require you to use new functionality.
Follow the instructions below and make any necessary changes.
Existing parameter name | New parameter name |
---|---|
sc.autosubmit | autoSubmit |
sc.cacerts | cacerts |
sc.compress_soap | compress_soap |
sc.helpserverhost | helpServerHost |
sc.helpserverport | helpServerPort |
sc.honorUrlHost | honorUrlHost |
sc.honorUrlPort | honorUrlPort |
sc.host | serverHost |
sc.port | serverPort |
sc.querysecurity | querySecurity |
sc.refreshmessages | refreshMessages |
sc.refreshmessinterval | refreshMessagesInterval |
sc.ssl | ssl |
sc.useservertabs | useservertabs |
sc.viewactivenotes | viewactivenotes |
sc.viewpromptforsave | viewpromptforsave |
sc.viewrecordlist | viewrecordlist |
If you have configured SSL or trusted sign-on, you must copy the following files from the previous installation folder to the new installation folder (where <sm_web_tier_installation> is the installation folder of the web tier):
Copy parameters that were previously set in the following file from the previous installation to the new installation:
To connect to HP Service Manager by using a browser:
Use the following URLs to access HP Service Manager from the web tier.
For <server>, type the name of the web server running the web tier.
For <port>, type the communications port number used to connect to the web tier.
Note: If you deployed using the webtier-ear-9.30.ear file, you can find the webtier-9.30.war file archived inside the .ear file.
Accessible employee self-service web client: http://<server>:<port>/webtier-9.30/accessibility_ess.do
Note: You do not need to specify the communications port in the web tier URL if you use the default web server port (port 80). See your web server documentation for instructions on setting the communications port.
Language: The language to use for this session (can differ from the language set on the computer).
Note: The login account that you enter must already exist in HP Service Manager. HP Service Manager provides an out-of-box login account with System Administrator privileges: System.Admin (with a blank password). HP recommends that you disable this account or change its password after creating accounts for all of your users. For information about how to create user accounts, see the HP Service Manager help.
The web client can support connections from Computer Telephony Integration (CTI) applications. The web client CTI implementation uses the HP Service Manager Event Services application to open or update records. Follow the steps in this section to make sure that your environment meets the requirements for installing CTI.
Install the CTI applet on each web client system to enable the web client to accept HP Service Manager system events from a CTI application. The applet installation requires that you use a local administrator account.
Open a web browser and navigate to the telephony web tier URL: http://<server>:<port>/webtier-9.30/index.do?telephonyuser=1
For <server>, type the name of the web server running the web tier. For <port>, type the communications port number used to connect to the web tier.
If the web client system has a properly installed JRE, the browser prompts you to install the CTI applet.
You can use the following URLs to access the telephony portions of the web client. For <server>, type the name of the web server running the web tier. For <port>, type the communications port number used to connect to the web tier.
Note: The telephony applet does not apply to the self-service portions of HP Service Manager.
Note: You do not need to specify the communications port in the web tier URL if you use the default web server port (port 80). See your web server documentation for instructions on setting the communications port.
When an event comes from a CTI application, the telephony web client prompts users to save their current work. Save your current work, and then click Yes to receive the incoming call (or other event).
The HP Service Manager online help provides a centralized location to access and store all online help files. You can install the online help on a local file system, a network share, or on a web server. If you want end users to access documentation from the Windows or web clients or directly from a web browser, you must install the help on a web server.
You cannot upgrade previous Help Servers to the HP Service Manager 9.30 help. You must install the HP Service Manager 9.30 help in a new folder or on a different system than your previous Help Server. HP recommends that you remove previous Help Servers, but it is not required.
Caution! Make a backup of any customized Help files that you have created for your HP Service Manager clients.
Make sure that you meet the following requirements so that you can install the online help:
Access the archive:
C:\Program Files\Apache Software Foundation\Apache2.2\htdocs
.Test the help by browsing to the web server's URL:
http://<helpserverhost>:<helpserverport>/<helpdirectory>/
<helpserverhost> is the fully qualified domain name or IP address of the web server hosting the help. <helpserverport> is the communications port used to connect to the web server hosting the help. You can omit the port number if you use the default port 80 HTML port.<helpdirectory> is the virtual directory name, if any, you created on your web server. By default, the archive creates a folder called SM_help that is part of the URL. For example: http://helpserver.domain.com/SM_help/
To configure Windows clients to display the online Help from a web server, set the Windows client preferences and define the help server's host name and communications port.
This setting is saved with your client preferences and is captured by the Client Configuration utility so that you can deploy it to your Windows client users.
Note: You can also view the help from a web browser by browsing to the following URL:
http://<helpserverhost>:<helpserverport>/<helpdirectory>/
<helpserverhost> is the fully qualified domain name or IP address of the web server hosting the help. <helpserverport> is the communications port used to connect to the web server hosting the help. You can omit the port number if you use the default port 80 HTML port.<helpdirectory> is the virtual directory name, if any, you created on your web server. By default, the archive creates a folder called SM_help that is part of the URL. For example: http://helpserver.domain.com/SM_help/
To set up web clients to display online help from a web server, configure the web client web.xml file and define the help server's host name and communications port.
web.xml
file from the sm/WEB-INF
folder of your application server installation.web.xml
.Note: The link on the web client points to the following URL:
http://<helpserverhost>:<helpserverport>/help/
<helpserverhost> is the name or IP address of the Help server that you want to connect to. <helpserverport> is the communications port used to connect to the web server hosting help. You can omit the port number if you use the default port 80 HTML port.
Currently, you cannot specify the virtual directory where the online help is published. The online help URL always points to a help
directory following the host and port that you have specified. Therefore, you must make sure that you publish the online help to http://<helpserverhost>:<helpserverport>/help/
.
The HP Service Manager Client Configuration Utility enables you to customize a Windows installation for deploying to end users.
Note: The Client Configuration Utility cannot push customization changes to previously installed Windows clients. To change existing installations of the Windows client, you uninstall the existing client and reinstall using the customized files you create. The Client Configuration Utility only picks up changes made directly from the Windows client interface or within the utility itself. The Client Configuration Utility cannot pick up changes made directly to Windows client initialization files.
The HP Service Manager Client Configuration Utility changes the following Windows client settings:
The Client Configuration Utility has the following known issues:
Make sure that you meet the following requirements to install the client configuration utility:
Start the Installer:
The HP Service Manager Client Configuration Utility Setup wizard opens.
You can customize the images that Windows clients use by providing alternate versions of the images from a local folder or web server virtual directory. The following guidelines and considerations apply to customized images:
Click Skip if you want to use the default splash screen image, or type or select the path to the splash screen image that you want to use.
The default splash screen image, splash.bmp, is located in the following folder: C:\Program Files\HP\HP Service Manager 9.30\Client\plugins\ com.hp.ov.sm.client.eclipse.user_9.30\src\resources\icons\obj16.
Follow these guidelines when you edit the splash screen image:
CA Certificate Path: Type or select the local path to the CA certificate used by your SSL connection. Leave this entry blank if you do not use an SSL connection.
Note: You can find a sample CA certificate file cacerts in the following path: C:\Program Files\HP\HP Service Manager 9.30\Client\ plugins\com.hp.commons_9.30\.
Help Server Port: Type the communications port on which the HP Service Manager Help Server listens to client connection requests. The default communications port is 80.
<ServiceManagerHome>\plugins\com.hp.ov.sm.client.thirdparty_9.30\lib;
The HP Service Manager 9.30 client and server support both the K2 Search Engine and the KM Search Engine.
Once you run the applications upgrade for HP Service Manager 9.30, you will lose support for the K2 Search Engine, which affects script libraries, menus, the search library (including advanced search), and how you manage knowledgebases.
To upgrade the new KM Search Engine, you will need to do the following:
Note: If you do not have the administrative experience necessary to manage migrating to the new KM Search Engine, you should get assistance from your local application developers and database administrators.
Ensure that the target system complies with the installation requirements, as listed in the HP HP Service Manager Compatibility Matrix on the HP Support matrices web site (http://support.openview.hp.com/sc/support_matrices.jsp).
Important: Before you install the Knowledge Management search engine, be sure that a Java Development Kit (JDK) 1.6, update 21 or greater is installed on the server, as follows:
HP recommends the using the following configurations for Knowledge Management.
RAM: Minimum of 8GB with 4GB dedicated to the JVM that hosts the KM Search Engine.
For better performance, 16 GB of RAM with 8 GB dedicated to the JVM that hosts the KM Search Engine.
Note: It is important to consider the size of the indexes when allocating RAM. Performance is greatly improved if there is enough RAM available to the OS, so that all the index files can be easily cached by the OS as disk seeks to load stored fields and other data from the KM index files, which can slow performance. With 4GB of RAM for the OS, an index of approximately 3GB in size could be cached easily. But if that number is doubled to 8GB of RAM for the OS, then a 6GB or 7GB index could be cached.
The Knowledge Management (KM) Search Engine installation consists of installing the KM Search Engine, KM Web Crawler, and Apache Tomcat Server. The KM Search Engine and KM Web Crawler can be installed separately.
The KM Search Engine is highly configurable. While a single instance may be suitable for pre-production testing, you may want to add more machines for a more robust production system. Refer to the HP Service Manager online help for Knowledge Management for production system recommendations.
There are two ways to install the KM Search Engine. Click a task below to view the instructions for installing the KM Search Engine using that method.
The following files are installed in a typical install.
Before you can use the KM Search Engine, you will need to configure HP Service Manager to point to it and you will need to create indexes. You will also need to configure the KM Web Crawler before use.
To configure the new KM Search Engine and Web Crawler, you should be an experienced HP Service Manager System Administrator who is familiar with your installation.
Refer to the Knowledge Management section of the online Help for information and instructions.
After you install the KM Search Engine and before starting it:
C:\Program Files\Java\jdk1.6.0_18
KMSearchEngineClass:com.hp.ov.sm.server.plugins.knowledgemanagement.solr.KMSolrSearch
You can start and stop the KM Search Engine by using the command line scripts or through a Windows Service.
The KM Search Engine installation folder has the following executable scripts that you can use to start and stop the Search Engine.
Name | Purpose |
---|---|
startup.cmd |
Starts the master KM Search Engine server on a Windows system. Starts the KMCrawler that has been installed separately. |
startup.cmd slave | Starts the slave KM Search Engine server on a Windows system. |
startup.sh | Starts the master KM Search Engine server on a UNIX system. |
startup.sh slave | Starts the slave KM Search Engine server on a UNIX system. |
Name | Purpose |
---|---|
shutdown.cmd |
|
shutdown.cmd slave | Shuts down the slave KM Search Engine server on a Windows system. |
shutdown.sh |
|
shutdown.sh slave | Shuts down the slave KM Search Engine server on a UNIX system. |
Before you can start and stop the KM Search Engine as a Windows Service, you need to first register and install it as a Windows Service.
You can uninstall the KM Search Engine as follows:
Note: The Windows and UNIX uninstall folder and program are the same.
Click Next. The uninstaller begins to remove the features. When the uninstall is complete, a list of the files that have been removed displays.
Note: The uninstall process intentionally preserves the files that have changed since the initial installation. You must manually remove these files if you want to completely uninstall the KM Search Engine from your system.
The out-of-box server sc.ini file is configured to connect to the sample database. To connect to another RDBMS, edit the parameters in the sc.ini file.
To connect to your HP Service Manager RDBMS, add the database connectivity settings. Make sure that these settings match the settings that you used when you set up your RDBMS connection.
If the legacy listener will connect to a case-insensitive Oracle database, add the parameter sql_oracle_binary_ci to the sc.ini file.
Type scservic -install.
This command creates a Windows service with the name specified by the ntservice parameter in the sc.ini file.
scstart
script in the <HP Service Manager 9.30 installation path>\Server\LegacyIntegration\RUN folder.Start the Installer:
The ServiceCenter ODBC driver InstallShield Wizard opens.
The default installation sets up the ODBC DSN to connect to the default legacy listener on the local host. Configure the legacy ODBC driver to connect to the legacy read-only listener:
Navigate to C:\Program Files\HP\HP Service Manager 9.30\Server\ LegacyIntegration\RUN.
From the Windows Start menu, select Control Panel > Administrative Tools > Services.
Run the scstart script.
Select the service that you installed when you set up the legacy listener, and then click Start.
You can start the listener as an application rather than as a
service. To do so, go to the <HP Service Manager 9.30 installation path>\Server\ LegacyIntegration\RUN directory and run the following
command using the Windows command prompt: scenter -listener:<port number> -RPCReadOnly
.
You must start a legacy listener with the RPC read-only mode parameter. This parameter allows a ServiceCenter 6.2 server to connect to a HP Service Manager database without interfering with the HP Service Manager server (it does not create a system lock).
The RPC read-only parameter prevents HP Service Manager clients (Windows, web tier, and web services) from connecting to the HP Service Manager server. The only connections the ServiceCenter 6.2 RPCReadOnlyMode listener accepts are connections from the ServiceCenter ODBC driver or Connect-It.
Notes:
Type scservic -remove.
This command removes the Windows service with the name specified by the ntservice parameter in the sc.ini file.
You can use Crystal Reports to view, update, and develop new reports with HP Service Manager.
Follow these steps to install Crystal Reports 2013 SP3 for use with HP Service Manager:
Run the batch file:
The installation wizard starts.
The HP Service Manager installation DVD comes with out-of-box reports that you can run using Crystal Reports. Using these reports requires the ServiceCenter ODBC driver and requires that the legacy listener is started.
See the HP HP Service Manager Operational Reports Guide for more information.
Follow these steps to uninstall Crystal Reports 2013 with SP3 and all the associated Language Packs:
Review your client and server customizations, client connections, and overall system performance. Correct any problems and retest the development environment.
To convert the development environment, connect the HP Service Manager server to your production environment network and deploy necessary clients to the production environment.
To push the development environment to your production environment, create an unload file of your application and operator customizations and load the file into your production environment system. See the HP Service Manager online help for instructions.
Once you have completed the installation of HP Service Manager 9.30, you can view the HP Service Manager 9.30 online Help for information about customizing the HP Service Manager applications to your environment. You can add or update the operator records in your development environment with new capability words. You can also optimize the HP Service Manager interface in your development environment. For example, you can add public favorites and dashboards, tailor forms for viewing in the web tier, and tailor forms for accessibility-assisted users. In addition, see the HP Service Manager online help for instructions on enabling integrations to other applications.
© Copyright 1994 - 2014 Hewlett-Packard Development Company, L.P.