Job Management Partner 1/Software Distribution Description and Planning Guide

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

6.3.1 Settings for using AMT

This subsection explains the settings required for using AMT to control clients.

Before you install AMT Linkage, you must configure settings for AMT on the clients. For details about the AMT settings, see 5.2.5(1) Settings required before JP1/Software Distribution is installed.

Organization of this subsection
(1) Settings for using AMT to control clients
(2) dcmamtwc.exe (wireless LAN connection settings)
(3) Notes on using AMT to control clients

(1) Settings for using AMT to control clients

To use AMT to control clients, the following settings are required.

Settings in JP1/Software Distribution Manager and JP1/Software Distribution Client (relay system):
Here, you set the user name and password of the AMT management user, either in the Settings for the AMT Linkage dialog box during installation or on the AMT Linkage page at setup.

Settings in JP1/Software Distribution Client (client):
Here, you set the user name and password of the AMT management user in the Settings for the AMT Linkage dialog box during installation. You cannot configure these settings at setup.

The settings for the user name and password of the AMT management user specified on the client must match those set on the managing server.

If the user name and password of the AMT management user set on the clients differ from those set on the managing server, you can distribute the AMT settings file (AMTSETUP file) to change the client settings.

To distribute the AMT settings file:

  1. Package the AMT settings file.
    The AMT settings file is stored in JP1/Software-Distribution-installation-directory\DMAMT. Package the entire folder.
    Specify the installation directory settings as follows:
    • Drive: none
    • Directory: %NETMDMP%
  2. Distribute the package to the clients.
    Once distribution has been completed, the settings for the client AMT management user are changed.

When multiple notebook PCs that can use AMT are to be brought into a wireless LAN environment as clients, you can use the dcmamtwc command to perform a batch operation that specifies the wireless LAN connection settings. If it becomes necessary to modify the wireless LAN connection settings, the dcmamtwc command is convenient because it allows you to make changes in a batch operation.

(2) dcmamtwc.exe (wireless LAN connection settings)

An explanation of the dcmamtwc command used for wireless LAN connection settings is provided below. You execute this command from the central manager or a relay system.

Function
Specifies wireless LAN connection settings on notebook PC clients that can use AMT.

Format
dcmamtwc.exe /f CSV-output-utility-output-file-name
             /n wireless-LAN-profile-name
             { [/r] |
             [/w ON | OFF | Sx]
             [/p wireless-LAN-profile-priority-order]
             [/i SSID] [/s WPA | RSN] [/e TKIP | CCMP] [/k encryption-key] }

Arguments
/f
Specify the host for which wireless LAN connection information is being set. To specify a host, use the file to which the CSV output utility outputs the system information. You can also use a file that has the same format as the file to which the CSV output utility outputs the system information.
/n
Specify the wireless LAN's profile name as 1-35 characters.
/r
If wireless LAN connection information settings already exist, specifying this option will delete them.
If /w, /p, /i, /s, /e, and /k are specified at the same time, these other options are ignored and only /r takes effect.
/w
Specify ON, OFF, or Sx to connect to or disconnect from the wireless LAN.
If you specify Sx, a connection can be established to the wireless LAN even when the client PC is sleeping or hibernating, if it is equipped with AMT 4.0 or later.
/p
Specify a value between 0 and 255 for the wireless LAN profile priority order. The default is 0.
/i
Specify the wireless LAN's SSID. If you specify this option, you must also specify the /s, /e, and /k options.
This option is ignored if the /r option is specified, or if OFF is specified for the /w option.
/s
Specify the communication method to be used. Select either WPA or RSN for the communication method. If you specify this option, you must also specify the /e and /k options.
This option is ignored if the /r option is specified, or if OFF is specified for the /w option.
/e
Specify the encryption method to be used. Select either TKIP or CCMP for the encryption method. If you specify this option, you must also specify the /s and /k options.
This option is ignored if the /r option is specified, or if OFF is specified for the /w option.
/k
Specify the encryption key character string. If you specify this option, you must also specify the /s and /e options.
This option is ignored if the /r option is specified, or if OFF is specified for the /w option.

Return codes
The following table describes the codes returned when the dcmamtwc command executes.
Code Meaning Action to take
0 The command was executed for all target machines; and the connection information for a wireless LAN was set or deleted, or the wireless LAN connection was started or stopped. None
1 The CSV output utility output file cannot be opened, or the file format is invalid. Check the path of the CSV output utility output file or the file format.
2 A command argument is invalid. Check the command arguments.
12 An error other than the above occurred. A system error occurred. Check the execution environment of the command.
30 Initialization of AMT's nonvolatile memory failed for at least one client. Check the log file to determine the cause and the action to take.#
  • The settings for the AMT management user might not match. Make sure the AMT management user name and password are set in the target clients.
  • Make sure that Small Business is specified as the AMT Provision model.
  • A targeted PC might not support AMT, or it might not be recognized in the network.
31 The command was executed for all target machines; but an attempt to set or delete the connection information for a wireless LAN failed, or an attempt to start or stop the wireless LAN connection failed. Check the log file to determine the cause and action to take.#
  • Reset the AMT management user name and password specified for AMT linkage in the JP1/Software Distribution setup.
  • Enterprise might be selected as the Provision model in all machines' AMT setup. Change it to Small Business.
  • A targeted PC might not support AMT, or it might not be recognized in the network.

#: For details about the dcmamtwc command log, see 6.3.1(5) Checking the AMT Linkage log in the manual Administrator's Guide Volume 2.


Notes
  • After you have stopped the wireless LAN by specifying OFF for the /w option, to restart it, you need to execute the dcmamtwc command by specifying ON for the /w option from the central manager or relay system of the LAN environment.
  • To set the wireless LAN connection information for the first time, you need to set the wireless LAN connection information from the central manager or relay system of the LAN environment.
  • If you do not specify the /r option, a new profile is added for the specified wireless LAN. If a profile already exists for the same wireless LAN, the existing profile is overwritten.
  • If you stop the wireless LAN by specifying OFF for the /w option, the wireless LAN network is disconnected when the command is executed successfully. Therefore, no return code is reported even when the client terminates normally. Since no return code is reported, the central manager considers that a communication error has occurred, and reports a return code indicating abnormal termination.

Execution example
In the following example, the dcmamtwc command is used to set wireless LAN connection information:
dcmamtwc.exe /f C:\temp\input.csv /n AMTProfile /w ON /i AMTACCESSPOINT /s WPA /e TKIP /k P@ssw0rd

(3) Notes on using AMT to control clients

Note the following points when using AMT to perform client control: