Installing HP Device Manager 4.5 Creating a standard for installing HP Device Manager 4.5 and configuring HP Device Manager 4.
© Copyright 2013 Hewlett-Packard Development Company, L.P. Microsoft and Windows are U.S. registered trademarks of Microsoft Corporation. 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.
Table of contents Overview ............................................................................................................................................ 4 Server preparation ............................................................................................................................... 5 FTP server configuration .................................................................................................................... 5 Windows Firewall settings ....................
Overview This document discusses the installation of HP Device Manager 4.5 and the usage of HP Device Manager 4.5 tools in a Proof of Concept. Production installation may differ based on a number of parameters, including, but not limited to, the number of remote sites, the number of thin clients, LAN and WAN links, network configuration, etc... Please contact your thin client technical consultant for more details.
Server preparation For this setup, you will need Windows Server 2003 or Windows Server 2008 running on either a physical or virtual machine. Please allocate at least 10 GB for the operating system and the HPDM files. Full server recommendations are in the HP Device Manager User Guide. Assumption—The server will be a standard installation without any additional services running.
3. To disable stateful FTP filtering so that Windows Firewall will not block FTP traffic to the passive port range, enter the following command and then hit Enter: netsh advfirewall set global StatefulFtp disable Firewall settings for HP Device Manager The basic ports used by HPDM for management traffic between the Server, Gateway, and Agent fall in the range of 40000-40009 and 40012. Use the following steps to configure the necessary exceptions: 1.
Installing HP Device Manager 4.5 Before installing HP Device Manager, copy the installation files to the server and see the chapter Server preparation. Running the installation file 1. Open the HP Device Manager folder and double-click the HPDM setup file. If it asks to Extract or Run, pick Run. 2. Click Next.
3. Accept the license agreement and click Next. 4. Click Yes.
5. This step allows you to select a setup type: o Complete—All components will be installed with their default configurations. o Custom—Select the components to install and specify the configuration of each one. Select the desired setup type, change the Destination Folder if you want, then click Next. NOTE: In this example, we are using the Custom setup. 6. Make sure all the components are checked. For a detail description of each component, please refer to the HP Device Manager User Guide.
7. Accept the default root path where the Master Repository will be stored or click Browse and navigate to a specific location. Click Next. 8. Click Install.
9. HPDM is installing… HPDM configuration 1. Next, an HPDM Configuration Wizard appears. Set the preferred language and click Next.
2. Click Check… to check ports, then click Next. 3. Be sure that DHCP server not located on this machine is selected and click Next.
4. Change Start PXE service when gateway is started to No and click Next. 5. Click Execute.
6. Click Finish.
Creating a new database 1. Next, an HP Device Manager Database Setup dialog appears. Select Create New Database, then click Next. NOTE: Since it’s the first time installing HP Device Manager, you have to create a new database. 2. HP Device Manager supports two database types: o PostgreSQL—HP Device Manager’s embedded database. There is no need to do any other database configurations if you choose it.
NOTES: If you choose MS SQL Server as your HP Device Manager database, the authentication type in the HP Device Manager Database Setup dialog should correspond to the MS SQL Server configuration, and you have to be authorized to create the database. For example: a. If you choose Windows authentication mode when doing Database Engine Configuration, you should choose Window Authentication when configuring HP Device Manager Database Setup. b.
3. Choose PostgreSQL, then click Next. 4. There will be a processing dialog while it is creating a new database.
5. After the database creation is done, enter and confirm the password for the root account, and then click Finish. NOTE: This account is the Administrator account. 6. Click OK. The database was created successfully.
7. After the database installation is finished, a completion dialog will appear. Click Finish. You have completed the installation of HP Device Manager.
Upgrading to HP Device Manager 4.5 If you’ve installed an older version of HP Device Manager, you can use the HPDM 4.5 installation file to upgrade it. Before upgrading HP Device Manager, copy the installation files to the server and see the chapter Server preparation. Running the installation file to upgrade HPDM 1. Open the HP Device Manager folder and double-click the HPDM setup file. If it asks to Extract or Run, pick Run. 2. A dialog will appear to prompt you to upgrade HP Device Manager.
3. If you want to continue, click Yes. Otherwise, click No to exit this upgrade. 4. Click Next. 5. Accept the license agreement and click Next.
6. Click Yes. 7. Select the Custom setup, change the destination folder if you want, and then click Next. NOTE: You can overwrite the old version’s HP Device Manager directory, or you can create a new destination folder.
8. Make sure all the components are checked. For a detailed description of each component, please refer to the HP Device Manager User Guide. Click Next. 9. Accept the default root path where the Master Repository will be stored or click Browse and navigate to a specific location. Click Next.
10. Click Install. 11.
12. HPDM is installing… HPDM configuration during an upgrade 1. Next, an HPDM Configuration Wizard appears. Set the preferred language and click Next.
2. Click Check to check ports, then click Next. 3. Be sure that DHCP server not located on this machine is selected and click Next.
4. Change Start PXE service when gateway is started to No and click Next. 5. Click Execute.
6. Click Finish.
Using an existing database 1. Next, an HP Device Manager Database Setup dialog will appear. Select Use HP Device Manager database at existing location, then click Next. NOTES: Use HP Device Manager database at existing location means to use the existing database instead of creating a new one. For example, if you have HP Device Manager 4.4 and you want to upgrade to 4.5, you can use the existing version 4.4 database.
2. A processing dialog will appear. Database Setup is connecting to the existing database. 3. A dialog will appear notifying you that the existing database was used successfully. You have completed the upgrade of HP Device Manager. If Database Setup has a problem connecting to the existing database: 1. A dialog will appear. Click OK. You can specify the database manually.
2. There are two configuration modes: a. Import—You can import an existing database configuration file: hibernate.cfg. b. Setting Database—You do the configuration manually. For this example, use the Import option, then click Browse.
3. Look in the existing HP Device Manager directory …/Server/conf, select the hibernate.properties file, then click Open. 4. You will see the Database Settings is configured.
5. Click Browse to set the last installed HP Device Manager directory, then click Next. 6. After the process is done, enter and confirm the password for the root account, then click Finish. NOTE: This account is the Administrator account.
7. Click OK. The existing database was used successfully. 8. After the database installation is finished, a completion dialog will appear. Click Finish. You have completed the upgrade of HP Device Manager.
HP Device Manager tools Configuring HPDM Server Here, we explain each parameter in the Server configuration file. Accessing the Server configuration file 1. Open the Explorer and find the installation folder for HP Device Manager. 2. Right-click on the file server.conf, and choose Open With and then Notepad. Now you have a notepad displaying the content of server.conf, and you can modify some of the parameters in it. The following are explanations for each parameter.
Port settings The following ports are used to communicate with HPDM Gateway. Parameter Description hpdm.poll.port=40000 This parameter indicates the port that the Server uses to poll a Gateway. hpdm.task.port=40003 This parameter indicates the port that the Server uses to send tasks to a Gateway. hpdm.report.port=40005 This parameter indicates the port that the Server uses to receive reports from a Gateway.
Log settings HPDM Server outputs logs to a rolling file named hpdm-server.log. Parameter Description hpdm.log.level=WARN This parameter indicates log levels to write into the log file. The log levels in the Server are: DEBUG = 1: Logs for developer debugging. INFO = 2: Logs of running information, contain no errors. WARN = 3: Logs with warning, something unexpected happened. FATAL = 4: Logs of fatal errors or what must be logged, such as server start.
Configuring HPDM Gateway 1. After HPDM Gateway is installed, its tray icon will be displayed on the right side of the taskbar. Right-click the icon, and the following menu will appear. 2. Click Configure Device Management Gateway, and the HPDM Gateway Configuration window will appear.
3. Move the mouse over the input field of any item and, after a moment, a hint will be displayed. Every hint includes two parts: o Value scope o Explanation of the item For example, move the mouse over the input field of Server address and the following hint will be displayed. 4. After the settings are configured, click OK to save them. The following message will appear. 5. Click OK to exit the HPDM Gateway Configuration window.
• Report Session Timeout—After a report connection is established with the Server, it will be maintained for a period of time equal to this value in seconds to reduce the cost of connection establishment and cleaning up. • Batch—The number of HPDM Agents that will be polled by HPDM Gateway in a batch. • Poll interval—The interval in seconds between polling HPDM Agents. • Local NIC—Select a network card for HPDM Gateway to send/receive tasks and reports.
Configuring DHCP tags For information about configuring DHCP tags, please refer to the Configuring DHCP Tags for HP Device Manager white paper. Configuring HPDM Agent Configuring HP WES/XPe/CE clients 1. Log onto the client device as Administrator. 2. Open the Windows Control Panel and double-click HPDM Agent. You will see the following dialog. There are two tabs in this dialog. The General tab contains all parameters for Agent settings.
There are two radio options in the Groups tab. Selecting Get Pre-Assign Groups from DHCP Tag will make the Agent report in with grouping values to get from the DHCP server. Selecting Use Static Custom Groups allows you to set custom grouping values for this device manually. When you choose Use Static Custom Groups and click Add, a dialog will appear and let you input the grouping value. You can choose the Group Name from a drop-down list and input a value for it.
There are two tabs in this dialog. The General tab contains all parameters for Agent settings. The Groups tab is an entry to set special grouping information for HPDM Console/Server use. There are two radio options in the Groups tab. Selecting Get Pre-Assign Groups from DHCP Tag will make the Agent report in with grouping values to get from the DHCP server. Selecting Use Static Custom Groups allows you to set custom grouping values for this device manually.
When you choose Use Static Custom Groups and click Add, a dialog will appear and let you input the grouping value. You can choose the Group Name from a drop-down list and input a value for it. Agent parameters Although the GUIs differ a little between Windows and Linux, their parameters are the same. Here, we give explanations for each parameter. • Agent Version—The current version of HPDM Agent. • Current Gateway—The IP address of the HPDM Gateway that is currently managing this Agent.
Appendix A—Port usage in HP Device Manager The following standard and custom ports are used by HP Device Manager: Standard ports Port Protocol Purpose 67 and 68 UDP PXE - Bootstrap 69 UDP TFTP (Trivial File Transfer Protocol) 4011 UDP DHCP Proxy Service (this is an alternative to ports 67 and 68 if those ports are not available) 20 and 21 TCP FTP (Used for Repository) 22 TCP SSH Tunnel 5900 TCP VNC Server 5500 TCP VNC Viewer in Listen Mode HPDM custom ports Receiver Port Sender
