Job Management Partner 1/Software Distribution Setup Guide

[Contents][Glossary][Index][Back][Next]

Appendix E.6 Setting up HTTP Gateway

To run HTTP Gateway on your system, you must install HTTP Gateway and set it up. You must also set up the lower system.

In Windows NT, you must do the setup so that HTTP Gateway is registered as a Windows service. After installation, you can change the HTTP Gateway service settings as required.

Organization of this subsection
(1) Setup procedure
(2) Installing HTTP Gateway
(3) Setting up HTTP Gateway
(4) Setting up the service
(5) Setting up the lower system

(1) Setup procedure

The figure below shows the procedures for setting up HTTP Gateway, the HTTP Gateway service, and the lower system. The HTTP Gateway service should be set up only under Windows NT.

Figure E-10 HTTP Gateway setup procedures

[Figure]

(2) Installing HTTP Gateway

Because Internet Options is a background service that converts protocols, no icon is registered in the Start menu when you install HTTP Gateway. After installing the software, make the necessary settings from the Control Panel.

In Windows NT, you must also make the required settings so that HTTP Gateway is registered as a Windows service. The HTTP Gateway service settings can be changed as required after installation. After installed, HTTP Gateway functions as a Windows service named Software Distribution HTTP Gateway Service.

In Windows Me and Windows 98, HTTP Gateway is a resident program.

Note that you cannot use the remote installation facility of JP1/Software Distribution to install HTTP Gateway. However, you can use this facility to reinstall this product.

To install HTTP Gateway:

  1. Insert the HTTP Gateway installation medium into the CD-ROM drive.
    The Software Distribution HTTP Gateway Setup dialog box appears.
  2. Choose the Next button.
    The Register User dialog box appears.

    Figure E-11 Register User dialog box

    [Figure]

  3. Enter the user name and company name, then choose the Next button.
    The Specify Installation Directory dialog box appears.

    Figure E-12 Specify Installation Directory dialog box

    [Figure]

  4. Specify the directory in which HTTP Gateway is to be installed.
    The default directory for installation is system-drive\Program Files\hitachi\dmhttpgw.
    If the OS being used is Windows Server 2003 (x64), the default directory is system-drive\Program Files (x86)\HITACHI\dmhttpgw.
  5. Choose the Next button.
    In Windows NT, the Set Services dialog box appears when you first install HTTP Gateway. When you reinstall HTTP Gateway, this dialog box is not displayed and installation advances to step 8.
    In Windows Me and Windows 98, this dialog box is not displayed and installation advances to step 8.

    Figure E-13 Set Services dialog box

    [Figure]

  6. Complete the settings for registering HTTP Gateway as a Windows service.
    Set the user account and password to be used when the HTTP Gateway service logs on. HTTP Gateway uses the settings in the Windows Internet Options setup for the specified account user.
    Note the following about setting up the user account:
    • Account users must have Users rights. However, when Secure Socket Client is installed on the machine on which HTTP Gateway is installed, Power Users rights or higher are required.
    • In Windows NT 4.0, you must give read/write permission to the account user for the directory in which HTTP Gateway is being installed.
    • When you create a new user account, after installing HTTP Gateway, log off from the desktop and then log on again using the new user account.
    Note that the Startup Type for the HTTP Gateway service is registered as Automatic.
  7. Choose the Next button.
    The Confirm Installation dialog box appears.
  8. Review the installation, then choose the Next button.
    Installation starts. When installation is completed, the Installation Complete dialog box appears.
  9. Choose Finish.
    If you selected Start Setup in the Installation Complete dialog box, the Software Distribution HTTP Gateway Settings dialog box appears and you can continue with the setup.

(3) Setting up HTTP Gateway

You set up HTTP Gateway from the Control Panel.

Open Control Panel and double-click SD HTTP Gateway Settings to display the Software Distribution HTTP Gateway Settings dialog box. In this dialog box, specify the following settings, then make a test connection to the Web server:

If you change the settings after you begin using Internet Options, you must restart the HTTP Gateway service in order for those changes to take effect. If you are running Windows Me or Windows 98, you must restart the PC.

(a) Server

Specify the Web server and Internet Gateway to which HTTP Gateway connects. You can also specify the port number for HTTP and HTTPS communications.

Figure E-14 Server page

[Figure]

Server
Specify the address of the Web server to which HTTP Gateway connects. This setting is required.

URI
Specify the alias specified at the time of creation of the virtual directory for Internet Gateway using the Microsoft Internet Information Services. This setting is required.

Port number
You can specify the port numbers used for HTTP and HTTPS communications. The defaults are 80 and 443, respectively. If there is a possibility that another program uses the same port number, change the port number.

User Authentication
If the Web server requires user authentication, specify the user name and password.
(b) Proxy

When you use a proxy server, select Use a proxy server and complete the various settings.

Figure E-15 Proxy page

[Figure]

Use the settings specified in Internet Options
Select this option to use the proxy-related information set in the Windows Internet Options. Windows NT uses the Windows Internet Options settings for account users registered in the HTTP Gateway service.

Use the following proxy information
Select this option to use the proxy information set in Address and Port number.
Address
Specify the address of the proxy server.
Port number
You can specify the port number to be used when communicating with the proxy server. The default value is 8080. If there is a possibility that another program uses the same port number, change the port number.

User authentication
If the proxy server requires user authentication, specify the user name and password.
(c) Security

Implement the settings required for HTTPS communications using SSL.

Figure E-16 Security page

[Figure]

Use SSL
Select this option for HTTPS communications. Note that you must have already installed the certificate in the Web server.

Certificates warnings
Select whether an error results when a certificate-related warning occurs or the warning is ignored and HTTPS communication is performed. If you choose to ignore warnings, specify the types of warnings.
(d) Communication

Specify the service that accepts connection from the JP1/Software Distribution lower system and the maximum data size per upload.

Figure E-17 Communication page

[Figure]

The service that accepts connections from the lower system
Select the service that accepts a connection from the JP1/Software Distribution lower system. When the lower system is a relay manager or relay system and HTTP Gateway is installed on the same machine, select Accept connections from the relay system or manager installed on this machine. When HTTP Gateway is installed on a different machine, select Software Distribution Manager if the higher connection destination for Internet Gateway is a central manager, and select Software Distribution SubManager if the connection destination for Internet Gateway is a relay system.
You can also specify the port number used for each service. The default port numbers are shown below. If there is a possibility that another program uses the same port number, change the port number.
  • JP1/Software Distribution Manager: 30000
  • JP1/Software Distribution SubManager: 30001
  • JP1/Software Distribution HTTP Gateway: 22295

Split file
Specify the file split size for file data sent from JP1/Software Distribution.
Depending on your proxy server and on the Web server, the maximum data size that can be sent (uploaded) at one time may be limited. In such a case, split JP1/Software Distribution file data for sending. The default file split size is 1,024 kilobytes.
(e) Dial-up

When you install HTTP Gateway and client on a notebook computer and connect to the Internet using a dial-up connection, the dial-up connection can be automated using the auto-dialing facility, which is set up on the Dial-up page. The Dial-up page is displayed only when the remote access service is installed.

The auto-dialing facility connects and disconnects at the following times:

Before using the HTTP Gateway auto-dialing facility, you must clear the Dial-up connection in the lower system setup. However, when HTTP Gateway is installed on the same computer as the lower system, the same function can be achieved by selecting Dial-up connection at the lower system and setting the auto-dialing facility in HTTP Gateway off.

Figure E-18 Dial-up page

[Figure]

Connect by auto-dial
Select this box to use the HTTP Gateway auto-dialing facility. When you select this box, you must clear the Dial-up connection in the setup of the lower system.

Entry name
Select the dial-up entry to be used. To create a new dial-up entry, choose the New connection button.

Authentication
Enter the user name, password, and domain to be used for the dial-up connection.
(f) Checking settings

When you have completed all settings in the Software Distribution HTTP Gateway Settings dialog box, choose the OK button to display the confirmation dialog box shown below. Choose the Check button to make a test connection to the Web server.

Figure E-19 Check Settings dialog box

[Figure]

When connection is established successfully, the Software Distribution HTTP Gateway - Settings Check Results page is displayed.

Figure E-20 Software Distribution HTTP Gateway - Settings Check Results page

[Figure]

If this Web page is not displayed, connection has not been established. Check the setup. If you are using SSL, make sure that the certificate is installed on the Web server.

(4) Setting up the service

In Windows NT, HTTP Gateway is registered automatically as a Windows service upon completion of installation of HTTP Gateway. The registration items are as follows:

You can change the HTTP Gateway service settings as necessary.

In the account, specify the user account and password to be used when the HTTP Gateway service logs on. HTTP Gateway uses the settings in the Windows Internet Options for the specified account user.

You should note the following about setting up a user account:

Use the following procedure to change the service setup. For details about services, see the Windows manual or online help.

For Windows Server 2003, Windows XP, and Windows 2000
  1. From the Program menu, select Settings, Control Panel, Administrative Tools, then Computer management.
    The Computer Management window appears.
  2. In the left pane of the window, select Services under Services and Applications.
  3. In the right pane of the window, right-click on Software Distribution HTTP Gateway Service, then select Properties from the menu that is displayed.
    The Software Distribution HTTP Gateway Service Properties dialog box appears.
  4. Change the HTTP Gateway Service settings as required.
For Windows NT 4.0
  1. From Control Panel, choose Services.
    The Services dialog box appears.
  2. From the list box, select Software Distribution HTTP Gateway Service, then choose the Startup button.
    The HTTP Gateway service settings are displayed.
  3. Change the HTTP Gateway Service settings as required.

(5) Setting up the lower system

This subsection describes the setup items of the lower system to which HTTP Gateway connects that require attention when Internet Options is used. For details about the setup procedure and the settings, see 4. Setting Up JP1/Software Distribution Manager, 5. Setting Up JP1/Software Distribution Client (relay system), or 6. Setting Up JP1/Software Distribution Client (client).

(a) For relay manager
Page Item Description
Connection destination Higher connection destination host name or IP address When HTTP Gateway is installed on the same machine as the relay manager, specify the host name or IP address of the higher system connected via HTTP Gateway and Internet Gateway. When HTTP Gateway and the relay manager are installed on different machines, specify the host name or IP address of the machine on which HTTP Gateway is installed.
Connect using the HTTP Gateway installed on this relay manager Select this item when HTTP Gateway is installed on the same machine as the relay manager.
Communication Port number Software Distribution HTTP Gateway [netmdmgw] When HTTP Gateway is installed on the same machine as the relay manager, you can specify the port number to be used when communicating with HTTP Gateway. The default is 22295. Change the port number if the default port number is used by another program.
Note that the netmdmgw port can also be set on the Communication tab in the Server setup.
Wait for response Communications via Internet Gateway, HTTP Gateway, and the Internet are slower than when there is a direct connection with the managing server. This is particularly so for file transfers with a low bandwidth Internet connection. In some cases, the lower system may determine that there is no response and a communication error may result. In this item, set a time that takes into account the scale of the system, the lines, and the sizes of the files to be transferred. Use the following formula to calculate the timeout value, then check operations and adjust the setting if required:
Timeout value = T1 x Sp#
Default Running Status/Polling Client will poll the managing server When using Internet Options, job execution requests from the higher system are not received by the lower system. Jobs are executed only in response to requests from a lower system. Taking the job flow into account, select the Client will poll the managing server option and set the polling timing according to the operating environment and conditions. For details about the job flow, see E.2 Job flow via Internet Options.

#
T1: Time (in seconds) required to send a 1-megabyte file by FTP, etc.
Sp: Maximum size (in megabytes) of packages to be distributed or files to be collected.
(b) For relay system
Page Item Description
Connection destination Higher system Specify the product type (Software Distribution Manager or Software Distribution SubManager) of the higher system connecting via HTTP Gateway and Internet Gateway.
Host name or IP address When HTTP Gateway is installed on the same machine as the relay system, specify the host name or IP address of the higher system connecting via HTTP Gateway and Internet Gateway.
When HTTP Gateway is installed on a different machine from the relay system, specify the host name or IP address of the machine on which HTTP Gateway is installed.
Poll multiple higher systems When you select this item, you must specify the following machine as first priority:
  • When HTTP Gateway is installed on the same machine as the relay system, specify the higher system connecting via HTTP Gateway and Internet Gateway.
  • When HTTP Gateway is installed on a different machine from the relay system, specify the machine on which HTTP Gateway is installed.
Note that when HTTP Gateway and the relay system are installed on the same machine, machines set as second priority and lower are ignored.
Connect using the HTTP Gateway installed on this relay system Select this item when HTTP Gateway is installed on the same machine as the relay system.
Communication Port number
Software Distribution HTTP Gateway [netmdmgw]
When HTTP Gateway is installed on the same machine as the relay system, you can specify the port number to be used when communicating with HTTP Gateway. The default is 22295. Change the port number if the default port number may be in use by another program.
Wait for response Communications via Internet Gateway, HTTP Gateway, and the Internet are slower than when there is a direct connection with the managing server. This is particularly so for file transfers with a low bandwidth Internet connection. In some cases, the lower system may determine that there is no response and a communication error may result. In this item, set a time that takes into account the scale of the system, the lines, and the sizes of the files to be transferred. Use the following formula to calculate the timeout value, then check operations and adjust the setting if required:
Timeout value = T1 x Sp#
Default Running Status/Polling Client will poll the managing server When using Internet Options, job execution requests from the higher system are not received by the lower system. Jobs are executed only in response to requests from a lower system. Taking the job flow into account, select the Client will poll the managing server option and set the polling timing according to the operating environment and conditions. For details about the job flow, see E.2 Job flow via Internet Options.

#
T1: Time (in seconds) required to send a 1-megabyte file by FTP, etc.
Sp: Maximum size (in megabytes) of packages to be distributed or files to be collected.
(c) For client
Page Item Description
Connection destination Connection destination Specify the product type (Software Distribution Manager or Software Distribution SubManager) of the higher system connecting via HTTP Gateway and Internet Gateway.
Host name or IP address Specify the host name or IP address of the machine on which HTTP Gateway is installed.
Automatically register this computer in the system configuration In an environment via the Internet, we recommend the operation mode in which the system configuration is not automatically registered. For details, see E.3 Notes on using Internet Options.
Communication Wait for response Communications via Internet Gateway, HTTP Gateway, and the Internet are slower than when there is a direct connection with the managing server. This is particularly so for file transfers with a low bandwidth Internet connection. In some cases, the lower system may determine that there is no response and a communication error may result. In this item, set a time that takes into account the scale of the system, the lines, and the sizes of the files to be transferred. Use the following formula to calculate the timeout value, then check operations and adjust the setting if required:
Timeout value = T1 x Sp#
Default Running Status/Polling Client starts automatically at system boot When using Internet Options, job execution requests are blocked. It is, therefore, not necessary for the client to start automatically.
Client will poll the managing server When using Internet Options, job execution requests from the higher system are not received by the lower system. Jobs are executed only in response to requests from a lower system. Taking the job flow into account, select the Client will poll the managing server option and set the polling timing according to the operating environment and conditions. To save money when using a dial-up connection, make use of the Specify the time to execute polling option. You can also unselect the Client will poll the managing server option and make a connection only when executing the Package Setup Manager of the client or when choosing the Execute Job Backlog icon. For details about the job flow, see E.2 Job flow via Internet Options.
Dial-up Dial-up connection Do not select this item when using the auto-dialing facility in HTTP Gateway. However, when HTTP Gateway is installed on the same machine as the client, you can also unselect the auto-dialing facility in HTTP Gateway and use the client settings.

#
T1: Time (in seconds) required to send a 1-megabyte file by FTP, etc.
Sp: Maximum size (in megabytes) of packages to be distributed or files to be collected.