A.3 The procedure for creating a server environment of Citrix XenApp and Microsoft RDS

The following describes the procedure necessary to manage the Citrix XenApp and Microsoft RDS server with JP1/IT Desktop Management 2.

Create Agent installers
Installing agents
Assigning security policies
Creating policies of destination groups

Organization of this subsection

(1) Create agent installers
(2) Installing agents
(3) Assigning security policies
(4) Creating policies of destination groups

(1) Create agent installers

The followining describes the procedure for creating agent installers to perform an installation to the Citrix XenApp and Microsoft RDS server. The agent installers must be created by an administrator.

In addition, agents must be registered to the management server. For details on procedure for registering agents to the management server, see 5.9 Procedure for registering components.

This section describes the procedure to manage the Citrix XenApp and Microsoft RDS server. For information on other necessary settings, see 1.6 Manually installing agents on computers.

Stop the services of the management server.

To stop the services, execute the stopservice command (stopping services).
Edit the configuration file (jdn_manager_config.conf).

Set the value of AgentStartMenu_Display to OFF. (If the execution of setup is necessary, for example, when you change the connection destination of agents, execute Agent-installation-folder\bin\jdngsetup.exe.)

For details on the configuration file (jdn_manager_config.conf), refer to the property list in the manual JP1/IT Desktop Management 2 Overview and System Design Guide.
Start the services of the management server.

To start services, execute the startservice command (Starting services).
Log in to the management window of JP1/IT Desktop Management 2.
Add agent settings.

Select Windows Agent Configurations and Create Agent Installers on the menu area of the Settings module, then click Add Agent Configuration button in the Windows Agent Configurations and Create Agent Installers window. In the Add Agent Configuration dialog box, add agent settings for the Citrix XenApp and Microsoft RDS server. For the agent settings we recommend, refer to the the parameter list in the manual JP1/IT Desktop Management 2 Overview and System Design Guide.
Specify the setting items for agent installers.

From the Windows Agent Configurations and Create Agent Installers window, select the agent settings you created and then click Create Agent Installer. In the Create Agent Installer dialog box, specify the setting items for agent installers.

In Settings for the component to be installed, select JP1/IT Desktop Management 2 - Agent (Agent), and set the check of Remote Control Agent off.
Create agent installers.

To Page Top

(2) Installing agents

The following describes the procedure for installing agents to the Citrix XenApp and Microsoft RDS server. In this procedure, an administrator creates agent installers and a master image in which the agents are installed.

This section describes the procedure to manage the Citrix XenApp and Microsoft RDS server. For information on other necessary settings, see 1.6 Manually installing agents on computers.

Log on to the Citrix XenApp and Microsoft RDS server to which agents are installed with administrator privileges.
Install the agents with the agent installers.

Perform the installation with administrator privileges.

Specify the settings to distinguish the Citrix XenApp and Microsoft RDS server from general Windows computers.

With a registry editor etc., add the registry information to the Citrix XenApp and Microsoft RDS server. Example of registry information to be specified:

Key	HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Hitachi\JP1/IT Desktop Management - Agent
Value name	RdsServerType
Type	REG_SZ
Value	XenApp_RDS_Server

From a command prompt launched with administrator privileges, execute the following command.
```
Agent-installation-folder\bin\jdngsetrdsconf.bat LOGSETTING
```
This command is for setting the size expansion of internal logs of agents. After executing, confirm the following message is displayed.^#
```
The operation completed successfully.
```
# The following describes the errors that might occur when executing the command and how to deal with them.

Inputted parameter is invalid.

Workaround: Conform that the LOGSETTING option when executing the command is specified correctly.

Access to the registry is denied.

Workaround: Confirm that the command is executed with administrator privileges.

Failed to create an INI file.

Workaround 1: Confirm that the command is executed with administrator privileges.

Workaround 2: Confirm that there is the access privilege to the Agent-installation-folder\conf folder.
Register the exception of the ports for communication of agents to Windows Firewall.

From a command prompt, execute the following command.
```
netsh advfirewall firewall add rule name="JP1/IT Desktop Management 2 - Agent Service" dir=in action=allow protocol=TCP localport=Port-number-for-request-forstarting-agents
```
The following shows an execution example:
```
netsh advfirewall firewall add rule name="JP1/IT Desktop Management 2 - Agent Service" dir=in action=allow protocol=TCP localport=31001
```
Note that in the management server, when you change Agent startup port number of setup from the default value (31001), also change the port number for the request for starting agents of the execution commands.
Execute the resetnid.vbs command (Re-setting host id).

From a command prompt, execute the following command.
```
cscript.exe Agent-installation-folder\bin\resetnid.vbs /nodeid /i
```
For details on the resetnid.vbs command (Re-setting host id), refer to the explanation about re-setting host id (resetnid.vbs) in the manual JP1/IT Desktop Management 2 Administration Guide.
Create a master image with a tool etc.
Reboot the OS after copying the master image to the Citrix XenApp and Microsoft RDS server.
Log in.

Agent is started.

To Page Top

(3) Assigning security policies

The following describes the procedure to create and assign security policies for the Citrix XenApp and Microsoft RDS server. For information on other necessary settings, see 1.6 Manually installing agents on computers.

Specify additional management items.

In Custom Fields (Hardware Assets) in the Asset Field Definitions window of the setting window, add the items to acquire the registry information specified in (2) Installing agents.

Example of an additional management item:

Item name		The Citrix XenApp and Microsoft RDS server identification information
Input method		Acquire from registries
Data type		Text
Registry path	Root key	HKEY_LOCAL_MACHINE
	Path	SOFTWARE\Wow6432Node\Hitachi\JP1/IT Desktop Management - Agent
	Registry	RdsServerType

Add groups of user definitions.

From Device List (User-Defined)] in the menu area of the security window and device window, add groups of user definitions in which additional management items are specified as a condition.

Example of a user definition group:

Group name		The Citrix XenApp and Microsoft RDS server
Condition	Targeted item	The Citrix XenApp and Microsoft RDS server identification information
	Condition to be determined	Equal to determined value
	Determined value	XenApp_RDS_Server

Create security policies.

Select Security Policy List in the menu area in the Security module, click Add button in Security Policy List window, and then create security policies in the Add Security Policy dialog box. For the security policies we recommend, refer to the items that can be specified in security policies in the manual JP1/IT Desktop Management 2 Overview and System Design Guide.
Assign the security policies.

Select the created groups of user definitions from Device List (User-Defined) in the menu area of the security window. After the list of the Citrix XenApp and Microsoft RDS servers is displayed, select all the items and click Action - Assign Policy, and then display the Assign Policy dialog box. Select and assign the created security policies of the Citrix XenApp and Microsoft RDS server.

To Page Top

(4) Creating policies of destination groups

To perform distribution with Remote Install Manager, by creating policies of destination groups, you can create the destination groups for the Citrix XenApp and Microsoft RDS server.

This section describes the procedure for creating policies to create destination groups for the Citrix XenApp and Microsoft RDS server. For information on other necessary settings, refer to the manual JP1/IT Desktop Management 2 Distribution Function Administration Guide.

Log in to Remote Install Manager of JP1/IT Desktop Management 2.
Display the Group by custom fields of hardware asset information dialog box.

Display the Policy Setup dialog box by selecting File - Create Host Group - Create the policy for a host group from the menu of the Destination window. The Group by custom fields of hardware asset information dialog box is displayed by Clicking Add, selecting Automatic maintenance of destination group, and then selecting Group by custom fields of hardware asset information.

Add the policies in which additional management items to distinguish the Citrix XenApp and Microsoft RDS server are specified.

Example of the policy of destination groups:

Policy type	Group by custom fields of hardware asset information
Custom fields of hardware asset information	1st level	The Citrix XenApp and Microsoft RDS server identification information
	2nd level	(Not specified)
	3rd level	(Not specified)
	4th level	(Not specified)
	5th level	(Not specified)
	6th level	(Not specified)
Route	(Not specified)

To Page Top