Job Management Partner 1/Software Distribution Administrator's Guide Volume 1

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

3.4.4 Creating a parameter file

This subsection describes the format of a parameter file and explains how to create the file.

Organization of this subsection
(1) Format of the parameter file
(2) Editing the parameter file

(1) Format of the parameter file

You create a parameter file in text format. The following shows the format of a parameter file:

#Definition of items acquired from Active Directory server HOST001
tag[Figure]value line-feed-code
tag[Figure]value line-feed-code
:
:
(null line)
#Definition of items acquired from Active Directory server HOST002
tag[Figure]value line-feed-code
tag[Figure]value line-feed-code
:
:

A line beginning with a hash mark (#) is treated as a comment. Specify only one tag per line. For [Figure], enter one or more spaces.

You can define information to be acquired from multiple Active Directory hosts by entering a null line between the definitions. All the information about the same host must be specified as a single block without any null lines.

The following table lists and describes the tags that are specified in a parameter file.

Table 3-4 Tags that are specified in a parameter file

Tag name Specification value Specification
HOST Specifies the host name or IP address of the Active Directory. R
PORT Specifies the port number used to connect to the Active Directory. The default is 389. O
ID Specifies the ID to be used to connect to the Active Directory (ID for administrator role). The specification value is extracted from the Active Directory information. R
PASS Specifies the password for the ID used to connect to the Active Directory. If the PASS and ENCPASS tags are both specified during acquisition of directory information, an error results. R
ENCPASS If the dcmadsync command is executed with the /e option specified, the password specified in the PASS tag is converted, and the tag is changed to ENCPASS.
If the PASS and ENCPASS tags are both specified during acquisition of directory information, an error results.		 --
DOMAIN Specifies the domain name. The specification value is extracted from the Active Directory information. R
USRTYPE Specifies one of the following values as the user attribute to be acquired:
  • USR: Acquires user attribute.
  • INET: Acquires the InetOrgPerson attribute.
  • BOTH: Acquires both user and InetOrgPerson attributes (default).
 O
GOU Specifies the DN for the OU to which the target group belongs. If there is more than one applicable OU, specify multiple values. This value is extracted from the Active Directory information.
Information about the groups in the specified OU and the members of the groups is acquired.		 R#
GNAME Specifies the DN of the target group. If there is more than one applicable group, specify multiple values. This value is extracted from the Active Directory information.
Information about the specified group and the members of the group is acquired.		 R#
COU Specifies the DN for the OU to which the target computer belongs. If there is more than one applicable OU, specify multiple values. This value is extracted from the Active Directory information.
Information about the computer in the specified OU is acquired.		 R#
UOU Specifies the DN for the OU to which the target user belongs. If there is more than one applicable OU, specify multiple values.
Information about the user in the specified OU is acquired.		 O
COMKEY Specifies the attribute name of a computer property that is to be used for assignment with the user. The specification value is extracted from the Active Directory information.
The specified attribute name is not case sensitive.
If this value is omitted, managedBy is set.		 O
USRKEY Specifies the attribute name of a user property that is to be used for assignment with the computer. The specification value is extracted from the Active Directory information.
The specified attribute name is not case sensitive.
If this value is omitted, distinguishedName is set.		 O
USRATTR Specifies the attribute name for an item to be acquired from the user. If you specify multiple attribute names, delimit them with a space.
For the managing server to display the information specified here, you must define it in the map file.		 O
OUATTR Specifies the attribute name for an item to be acquired from OU. If you specify multiple attribute names, delimit them with a space.
For the managing server to display the information specified here, you must define it in the map file.		 O
GRPATTR Specifies the attribute name for an item to be acquired from groups. If you specify multiple attribute names, delimit them with a space.
For the managing server to display the information specified here, you must define it in the map file.		 O
COMATTR Specifies the attribute name for an item to be acquired from the computer. If you specify multiple attribute names, delimit them with a space.
For the managing server to display the information specified here, you must define it in the map file.		 O

Legend:
R: Required
O: Optional
--: No need to specify

#
At least one of these tags must be specified.

(2) Editing the parameter file

Edit the provided sample parameter file according to the environment in which the parameter file is used and the values extracted by the procedure described in 3.4.2 Extracting the information needed for setup.

The sample parameter file (SampleParameter.txt) is stored in the following directory:

JP1/Software-Distribution-installation-directory\SAMPLE\dcmadsync

The following shows the contents of the provided sample parameter file:

HOST     ADHOST
PORT     389
ID       CN=Administrator,CN=Users,DC=Sample,DC=co,DC=us
PASS     Admin
DOMAIN   DC=Sample,DC=co,DC=us
USRTYPE  BOTH
GOU OU=Groups,DC=Sample,DC=co,DC=jp
GNAME CN=Managers,DC=Sample,DC=co,DC=jp
COU      OU=Software Division,DC=Sample,DC=co,DC=us
UOU      CN=Users,DC=Sample,DC=co,DC=us
COMKEY   ManagedBy
USRKEY   distinguishedName
OUATTR   ou managedBy
GRPATTR cn managedBy
COMATTR  cn dNSHostName managedBy
USRATTR  cn sn givenname displayName physicalDeliveryOfficeName telephoneNumber mail company department title manager

This sample file assumes the following Active Directory configuration.

Figure 3-60 Active Directory configuration for the sample file

[Figure]

[Contents][Back][Next]

[Trademarks]

All Rights Reserved. Copyright (C) 2009, 2013, Hitachi, Ltd.
Copyright, patent, trademark, and other intellectual property rights related to the "TMEng.dll" file are owned exclusively by Trend Micro Incorporated.