2.12 Transfer Target Information File

This section describes the transfer target information file used when modifying the IP address of the Management Server connected to client (CT).

File name

DTKServerChange.txt

Usage

This file will be used when modifying IP address of the Management Server connected to the client (CT) on the Management Server.
The settings information will be notified to client (CT) as the CT policy.

When this file is saved in "Saving location", the IP address of the connected Management Server will be modified. Therefore, after modifying the IP address of the connected Management Server, delete this file, or move the file to location other than saving location.

Refer to the related contents of "Change Management Server/Master Management Server To Be Connected" in Systemwalker Desktop Keeper User's Guide for Administrator for how to use this file.

Saving location

When the operating system is a system other than Windows Server(R) 2008 and Windows Server(R) 2012

[Install OS Drive]\Documents and Settings\All Users\Application Data\Fujitsu\Systemwalker Desktop Keeper

When installing the Management Server, an example file (DTKServerChange_sample.txt) will be generated from the above mentioned saving location.

When the operating system is Windows Server(R) 2008 or Windows Server(R) 2012

[Install OS Drive]\ProgramData\Fujitsu\Systemwalker Desktop Keeper

File format

The item name and description of the input file are described as follows:

The character encoding used is either Shift JIS or UTF-8, one of which is specified in the server configuration tool. The blank line will be ignored.
The line that does not fulfill the file format will be ignored and displayed as error in the trace file (fsw21sj0.log) of server service.
When the beginning character is "#", it will be determined as comment line.
Each item will be quoted by " (double quote).

, (comma) will be used to separate one item from another.

No.	Item Name	Description
1	Specifying Method (Required) (Note1)	Specify the method for CT to modify the IP address of the connected Management Server. I: when specifying with IP address. A: when modifying IP address of connected Management Server for all clients (CTs) under Management Server.
2	Condition Specifying of Target CT (Required) (Note1)	When specifying through the IP address When specifying IP address in turn For IPv4 address: aaa.bbb.ccc.ddd For IPv6 address: aa:bb:cc:dd:ee:ff:gg:hh Note) For IPv6 address, an abbreviation compatible to RFC 5952 can also be used. When specifying the scope of IP address aaa.bbb.ccc.ddd-eee (The specified scope is the content after the fourth part (part of ddd).) Note) The scope for IPv6 address cannot be specified. It is specified in turn. The numerals that can be specified for each part are described as follows: - 1<=aaa<=254 - 0<=bbb<=255 - 0<=ccc<=255 - 1<=ddd<=254 - 1<=eee<=254 But, ddd < eee Under the following conditions, the IP address is incorrect. - When " 0" has been set before the numerals (Example: 192.168.001.020-050) - When specifying the local loop back address When modifying IP address of connected Management Server for all clients (CTs) under Management Server, it will be specified as ALL.
3	IP Address of Server (CT Management Server) (Required) (Note 1)	The switched IP address or the server name shall be specified. Specify according to the following format. For IPv4 address: aaa.bbb.ccc.ddd For IPv6 address: aa:bb:cc:dd:ee:ff:gg:hh For IPv6 address, an abbreviation compatible with RFC 5952 can also be used. For server name: 15 halfwidth characters or less Note) Local loop back address cannot be specified.
4	IP Address of Server (Substitute Management Server) (Note1)	The switched IP address or server name shall be specified. Specify according to the following format. When the default input format (Settings are blank) is allowed, the system will consider that the value of "IP Address of Server (CT Management Server)" has been set. For IPv4 address: aaa.bbb.ccc.ddd For IPv6 address: aa:bb:cc:dd:ee:ff:gg:hh For IPv6 address, an abbreviation compatible with RFC 5952 can also be used For server name: 15 halfwidth characters or less Note) Local loop back address cannot be specified.
5	Switch Date	In the client (CT), specify the date to switch the IP address of the connected Management Server. 20000101~20371231: the switch date shall be specified in the format of yyyymmdd. Default input or 0: switch when restarting CT When the CT is operating, and the system date is larger than the specified date, or when it has reached the specified date during CT starting, switch immediately.
6	Communication Port (For Receiving)	The standard value is 10,010. The value within a range from 5,001 to 60,000 can be specified. When the default input format is allowed or the value is set as 0, adopt the value that has been set in the client (CT).
7	Communication Port (For Sending)	The standard value is 10,010. The value within a range from 5,001 to 60,000 can be specified. When the default input format is allowed or the value is set as 0, adopt the value that has been set in the client (CT).
8	Communication Port (For Sending 2)	The standard value is 10,014. The value within a range from 5,001 to 60,000 can be specified. When the default input format is allowed or the value is set as 0, adopt the value that has been set in the client (CT).

The smart device (Agent) cannot change synchronous URL, smart device relay server to be connected and the Management Server by using this file.

Note1) Do not specify IPv6 address for the client (CT) of V14.3.0 or earlier. Do not enter the link local address. Operations when the link local address is specified are not guaranteed.

Use example

When specifying all clients (CTs) under the Management Server (When primary/secondary Management Server is modified as 192.168.5.10)

# Modify Management Server "Transfer Target Information File"
"A","ALL","192.168.5.10",""

The settings of items after the fifth item in the aforementioned file will be omitted.

When specifying the client (CT) according to the scope of IP address (The primary/secondary Management Server will be specified/modified in turn, and the switch date will be specified)

# Execute Modification of Management Server"Transfer Target Information File"
"I","192.168.0.20-240","192.168.4.10","192.168.4.11","20090611","0","0","0"
"I","192.168.1.20-240","192.168.4.10","192.168.4.11","20090611","0","0","0"
"I","192.168.2.20-240","192.168.4.10","192.168.4.11","20090611","0","0","0"

Execution results

When the information set in transfer target information file is notified to the client (CT) as CT policy, the result log of the transfer target information file will be output to the Management Server.

Output target path

When the operating system is Windows Server(R) 2008 and Windows Server(R) 2012

[Install OS Drive]\ProgramData\Fujitsu\Systemwalker Desktop Keeper

When the operating system is system other than Windows Server(R) 2008 and Windows Server(R) 2012

[Install OS Drive]\Documents and Settings\All Users\Application Data\Fujitsu\Systemwalker Desktop Keeper

File name: DTKServerChange.log

Output example

"2009/06/11 13:16:02","192.168.1.34","DTKCT","192.168.4.10","192.168.4.11","20090611","0","0","0"

The output detail contents are shown as follows:

No.	Item Name	Description
1	Response Time	This is the time when the client (CT) receives the switch information from the previous Management Server. Its format is YYYY/MM/DD HH:MM:SS.
2	IP Address of CT	IP address of client (CT) of response. (IPv4 address is displayed. For only IPv6, nothing is displayed)
3	Computer Name of CT	Computer name of client (CT) of response.
4	IP Address of Server (CT Management Server)	IP address of Management Server that sends switch information.
5	IP Address of Server (Substitute Management Server)	IP address of substitute Management Server responded by client (CT).
6	Switch Date	This is the information sent for the client (CT). It is the configuration value of switch date for transfer target information file.
7	Communication Port (for sending)	This is the information sent for the client (CT). It is the configuration value of communication port (for receiving) for transfer target information file.
8	Communication Port (for sending)	This is the information sent for the client (CT). It is the configuration value of communication port (for sending) for transfer target information file.
9	Communication Port (for sending 2)	This is the information sent for the client (CT). It is the configuration value of communication port (for sending 2) for transfer target information file.