XenApp ALTADDR Command Reference
Article ID: CTX201246
Updated On:
Description
ALTADDR
Use altaddr to query and set the alternate (external) IP address for a server running Citrix XenApp. The alternate address is returned to clients that request it and is used to access a server that is behind a firewall.
Syntax
altaddr [/server:servername] [/set alternateaddress] [/v]
altaddr [/server:servername] [/set adapteraddress alternateaddress] [/v]
altaddr [/server:servername] [/delete] [/v]
altaddr [/server:servername] [/delete adapteraddress] [/v]
altaddr [/?]
Parameters
- servername
- The name of a server.
- alternateaddress
- The alternate IP address for a server.
- adapteraddress
- The local IP address to which an alternate address is assigned.
Options
- /server:servername
- Specifies the server on which to set an alternate address. Defaults to the current server.
- /set
- Sets alternate TCP/IP addresses. If an adapteraddress is specified, alternateaddress is assigned only to the network adapter with that IP address.
- /delete
- Deletes the default alternate address on the specified server. If an adapter address is specified, the alternate address for that adapter is deleted.
- /v (verbose)
- Displays information about the actions being performed.
- /?
- Displays the syntax for the utility and information about the utility’s options.
Remarks
The server subsystem reads the altaddr settings for server external IP addresses at startup only. If you use altaddr to change the IP address setting, you must restart the Citrix Independent Management Architecture service for the new setting to take effect.
If altaddr is run without any parameters, it displays the information for alternate addresses configured on the current server.
Examples
Set the server’s alternate address to 1.1.1.1:
altaddr /set 1.1.1.1
Set the server’s alternate address to 2.2.2.2 on the network interface card whose adapter address is 1.1.1.1:
altaddr /set 2.2.2.2 1.1.1.1
Security Restrictions
None
Additional Resources
