5.3.1 Set static route
Function
Specifies a static route on a Windows or Linux target server.
Use situation
In the case of a system connected to multiple LANs, you use this plugin to set a static route for communication to a specific network.
Prerequisites
For the latest support information about [Required product in the System]/[Required products on the execution target system]/[Prerequisite product OS running in the execution target server], see the release notes.
[Required product in the System]
Job Management Partner 1/Automatic Operation 10-00 or later
[Required products on the execution target system]
None.
[Prerequisite product OS running in the execution target server]
(1) Windows Server 2003, Standard Edition/Enterprise Edition (x86/x64) SP1or later, Windows Server 2003 R2, Standard Edition/Enterprise Edition (x86/x64)
(2) Windows Server 2008 Standard/Enterprise (x86/x64), Windows Server 2008 R2 Standard/Enterprise/Datacenter
(3) Windows Server 2012 Standard/Datacenter, Windows Server 2012 R2 Standard/Datacenter
(4) Red Hat Enterprise Linux 5 Advanced Platform (x86), Red Hat Enterprise Linux 5 (x86), Red Hat Enterprise Linux 5 Advanced Platform (AMD/Intel 64), Red Hat Enterprise Linux 5 (AMD/Intel 64)
(5) Red Hat Enterprise Linux Server 6 (32-bit x86), Red Hat Enterprise Linux Server 6 (64-bit x86_64)
[Usage conditions for the target server]
None.
Cautions
(1) You must specify a destination IP address, a subnet mask, and a default gateway. If any of these is omitted, the static route is not set.
Version
01.00.04
Category
OperatingSystem/Common/Basic
Plug-in name displayed in the task log
osSetStaticRoute
Return code
0: Normal
12: Error (user error) Invalid property
14: Error (user error) File access disabled
23: Error (invalid environment) Required environment is invalid
27: Error (check task logs for the nature of error)
41: Error (error detected in plugin) Missing property (error detected in plugin script)
Property list
The following table lists the properties:
|
Property key |
Property name |
Description |
Default value |
I/O type |
Required |
|---|---|---|---|---|---|
|
OS.destIPAddress |
Destination IP of static route |
Specify the IP address of the destination network for which you want to set a static route. IPv6 addresses are not supported. |
-- |
Input |
O |
|
OS.subnetMaskStaticRoute |
Subnet mask (static route) |
Specify the subnet mask for the static route. You cannot specify an IPv6 address. |
-- |
Input |
O |
|
OS.defaultGWStaticRoute |
Default gateway (static route) |
Specify the default gateway for the static route. You cannot specify an IPv6 address. |
-- |
Input |
O |
|
plugin.destinationHost |
Host name of the execution target server |
Specify the host name or IP address of the server on which this plugin will be executed. IPv6 addresses are not supported. |
-- |
Input |
R |
|
common.returnValue |
Return value for the plugin |
The return value of this plugin stored. |
-- |
Output |
O |