3.12 Procedure for controlling the network bandwidth used for distribution

By setting a maximum transfer speed, you can ensure that the distribution of software and files from the management server to managed computers does not monopolize the network bandwidth.

To control the network bandwidth used for ITDM-compatible distribution:

Log on to the OS as a user with administrator permissions.
From the Windows Start menu, select All Programs, JP1_IT Desktop Management 2 - Manager, Tools, and then Setup.
In the Setup window, click the Next button.
In the Select a Setup view, select Settings Modification, and then click the Next button.
Click the Next button until the Other Settings view opens.
Select Control network bandwidth from management server, enter a value in Maximum transmission speed, and then click the Next button.
In the Confirm Setup Settings view, check the settings, and then click the Next button.

A dialog to confirm that Remote Install Manager and JP1/IT Desktop Management 2 - Asset Console are not being used is displayed. After confirming, click the OK button. In the cluster system, make the cluster resources associated with the services displayed in the dialog offline, and then click the OK button.
In the Setup for Distribution by Using Remote Install Manager view, click the OK button.

The setup process begins, and a dialog box appears indicating that setup is in progress. When setup has finished, the Setup Complete view appears.
In the Setup Complete view, click the OK button.

You can now control the network bandwidth.

To control the network bandwidth used for distributions using Remote Install Manager:

Stop the service of JP1/IT Desktop Management 2 - Manager.
Add the required setting to the configuration file.

The configuration file (jdn_rim_distr_bwc.conf) is stored in the following location:

instalation-folder-of-JP1/IT Desktop Management 2\mgr\conf
Start the service of JP1/IT Desktop Management 2 - Manager.

Network bandwidth can now be controlled.

The following tables list and describe the definitions in the configuration file:

Section	Key name	Description	Initial values	Required?
BandwidthCtrl	Function	Specify whether to control data flow when using Remote Install Manager to distribute software and files. `ON`: Control data flow. `OFF`: Do not control data flow.	`OFF`	Yes
Setting`N`^#1	MinIP^#2	Specify the first value of the IP addresses in the range from 0.0.0.0 to 255.255.255.255.	`0.0.0.0`	Yes
	MaxIP	Specify the last value of the IP addresses in the range from 0.0.0.0 to 255.255.255.255.	`255.255.255.255`	Yes
	MaxTransSpeedKbps	Specify the maximum transfer speed in Kbps by using an integer in the range from 32^#3 to 8388608^#4.	`15360`	Yes

#1: N represents a value in the range from 1 to 30. If multiple IP address ranges are specified, specify the definition like this: Setting1,Setting2,Setting3. Also, if you specify multiple IP address ranges, make sure that the IP address ranges of different SettingN sections do not overlap.

#2: Specify a value smaller than the value of MaxIP. If you specify a value lager than the value of MaxIP, the settings in the SettingN section will be ignored.

#3: 32 Kbps is equal to 4 KB per second (32 ÷ 8 bits = 4).

#4: 8,388,608 Kbps is equal to 1,048,576 KB per second (8,388,608 ÷ 8 bits = 1,048,576) or 1,024 MB per second.

Examples of setting the configuration file are shown below.

When controlling the data flow of the network bandwidth of the entire LAN on which the management server is configured

[BandwidthCtrl]
Function=ON

[Setting1]
MinIP=0.0.0.0
MaxIP=255.255.255.255
MaxTransSpeedKbps=1024

When controlling the data flow of a specific network bandwidth

[BandwidthCtrl]
Function=ON

[Setting1]
MinIP=192.168.0.0
MaxIP=192.168.0.255
MaxTransSpeedKbps=1024

[Setting2]
MinIP=192.168.100.0
MaxIP=192.168.100.255
MaxTransSpeedKbps=320

Note the following regarding the configuration file:

If duplicate sections exist, the section defined first takes effect.
If duplicate keys exist, the key defined first in a section takes effect.
If the IP address ranges of the SettingN sections overlap (example: a range including 192.168.100.* is included in both Setting1 and Setting2), data flows according to the settings in the section that has the highest priority (according to the value of N; Setting1 has the top priority). In other words, the maximum transfer speed for distribution to an agent whose IP address is 192.168.100.* (where the * is a value from 0 to 255) is 1,024 Kbps.
```
[BandwidthCtrl]
Function=ON

[Setting1]
MinIP=192.168.0.0
MaxIP=192.168.100.255
MaxTransSpeedKbps=1024

[Setting2]
MinIP=192.168.100.0
MaxIP=192.168.200.255
MaxTransSpeedKbps=320
```
If OFF is specified for the Function key of the BandwidthCtrl section, data flow is not controlled even if one or more SettingN sections exist.
If ON is specified for the Function key of the BandwidthCtrl section, data flow is not controlled if none of the SettingN sections are valid.
If the configuration file (jdn_rim_distr_bwc.conf) could not be opened, data flow is not controlled.

Tip: You can check the application of flow control for the distribution function that uses Remote Install Manger either in the MAIN.LOG file output when the management server starts up or the messages in the Windows event log file.

Tip

Data flow is not controlled in the following situations:

Collecting files by using the remote collection function
Distributing software or files when multicast distribution is enabled

To control network bandwidth for distribution by using Remote Install Manager in relay system:

Add the settings to relay system configuration file.

The storage location of the configuration file (jdn_rim_distr_bwc.conf) is as follows.

JP1/IT Desktop Management 2-Agent installation folder\conf\jdn_rim_distr_bwc.conf

The following table describes the definitions to be set in the configuration file.

Section	Key name	Description	Initial value	Required?
BandwidthCtrl	Function	Specifies whether to control the data flow with relay system during distribution by using Remote Install Manager. `ON`: Control data flow. `OFF`: Do not control data flow.	`OFF`	Yes
Setting	MaxTransSpeedKbps	Specify the maximum transfer speed in Kbps by using an integer in the range from 32^#1 to 8388608^#2.	`15360`	Yes

Section

Key name

Description

Initial value

Required?

BandwidthCtrl

Function

Specifies whether to control the data flow with relay system during distribution by using Remote Install Manager.

ON: Control data flow.
OFF: Do not control data flow.

OFF

Yes

Setting

MaxTransSpeedKbps

Specify the maximum transfer speed in Kbps by using an integer in the range from 32^#1 to 8388608^#2.

15360

Yes

#1: 32 Kbps is equal to 4 KB per second (32 ÷ 8 bits = 4).

#2: 8,388,608 Kbps is equal to 1,048,576 KB per second (8,388,608 ÷ 8 bits = 1,048,576) or 1,024 MB per second.

The following shows a sample configuration file for relay system.

[BandwidthCtrl]
Function=ON

[Setting]
MaxTransSpeedKbps=1024

Note the following regarding the configuration file:

If duplicate sections exist, the section defined first takes effect.
If duplicate keys exist, the key defined first in a section takes effect.
If OFF is specified for the Function key of the BandwidthCtrl section, data flow is not controlled even if one or more Setting sections exist.
If ON is specified for the Function key of the BandwidthCtrl section, data flow is not controlled if none of the Setting sections are valid.
If the configuration file (jdn_rim_distr_bwc.conf) could not be opened, data flow is not controlled.

Restart OS of relay system.
Check MAIN.LOG file of relay system.

Check that all the settings specified in the setting file have been outputted in the message about the application status of the flow rate control in distribution by using Remote Install Manager function.

To disable control for network bandwidth on distribution by using Remote Install Manager in relay system, specify OFF in Function in BandwidthCtrl section of the configuration file, and then perform the same steps.

For an administrator to distribute configuration files from Remote Installation Manager to subordinate relay systems:

On the administrator's terminal, create a configuration file to distribute to relay system.

For more information about the configuration file to create, see step 1 in “To control network bandwidth for distribution by using Remote Install Manager in relay system”.
On the administrator's terminal, package the created configuration file from Packager.
From the Remote Install Manager, distribute the packaged configuration files to the relay system in a distribution job.

When creating a distribution job, set the following items in the Change Installation Conditions dialog box that is displayed by clicking the Change button in the Package page.

System Conditions page

・Specify the following path in installation target directory

JP1/IT Desktop Management 2-Agent installation folder\conf

・Select the Replace existing package checkbox.

Options page

Select the Restart computer after installation check box.

For more information on job creation, see the instructions on running remote installation in “JP1/IT Desktop Management 2 Distribution Function Administration Guide” manual.
In Remote Install Manager Job Execution Status window, verify that distribution job to relay system is complete.
Run the remote collect job in the Remote Installation Manager to collect the configuration files and public logs distributed from the relay system.

Specify the following files to be collected:
- Distributed configuration file
- Publishing log: JP1/IT Desktop Management 2-Agent installation folder\log\MAIN_0000.log
Make sure that the collected configuration file is the same as the file created in step 1.
Review the collected publishing logs.

Check that all the settings specified in the setting file have been outputted in the message about the application status of the flow rate control in distribution by using Remote Install Manager function.

To Page Top