System commands

System commands allow you to manage the operation of the Integration Appliance, which includes managing licenses for the Integration Appliance and connectors.

Note: Do not use reserved words in the user name, host name, or file name. Reserved words include: ftp, sftp, ibm, port, user, and file.
Table 1.
Command name Action Syntax
system autoreboot

Allows you to enable or disable automatic reboot for an Integration Appliance.

Note: During a Cast Iron® firmware upgrade, the Integration Appliance reboots even if the automatic reboot is disabled.
system autoreboot <on | off>
system autoreboot setting

Use the setting parameter to print autoreboot settings.

system autoreboot setting
system clean

Clears the system states of the Integration Appliance. When you issue a system clean all command, the IBM® DataPower® Cast Iron® Appliance may reboot.

Running the all option results in the removal of all data and configurations, including High Availability configurations, from disk. The results are equivalent to restoring factory default settings for the appliance. After the reboot, you will be asked to accept the license agreement before logging in to the Web Management Console for the appliance.

system clean{[running][ orchmon][deploy]}|all
where:
  • running - Removes currently running project data.
  • orchmon - Removes orchestration monitoring data.
  • deploy - Removes all projects and configurations.
  • all - Resets the appliance to factory default settings.
system persist

Enables or disables the disk cache on the Integration Appliance. The default and recommended setting is system persist on.

When persistence is enabled, writes are synchronized to ensure that all requested data is completely written to disk. This behavior helps protect data integrity, particularly when accessing external transactional systems such as databases.

When persistence is disabled, on an appliance that supports this feature, performance might be improved. However, there is a risk of losing job progress state.

system persist { on | off }
system persist setting

Displays the current system persist setting: on or off. Use the system persist command to specify whether the disk cache is enabled or disabled.

system persist setting
system poweroff

Shuts down all routing services and then powers off the Integration Appliance. If the force parameter is used, power is cut off immediately.

system poweroff
system reboot

Shuts down all routing services and then reboots the Integration Appliance.

Note:
  • Before making changes like Upgrade/Reboot of appliance, please stop all projects in the runtime. After appliance comes back, starts the projects one-by-one.
  • When the system reboots, any network settings that have not been saved are lost. To commit network settings to the Integration Appliance, use the net restart command.
system reboot
system restart

Restarts the runtime and Web Management Console, without affecting the network connectivity.

system restart
system show platform

Displays information about the Integration Appliance, such as: ROM version, appliance platform, serial number, and MAC addresses.

system show platform
system show status

Available for Standalone Integration Appliances as well as the Active Integration Appliance in an HA pair. Shows whether the following components are up or down: System, Network, and Runtime.

system show status

Example output:

Appliance Status
----------------
     System: Up
    Network: Up
    Runtime: Up
system show version

Displays the version of the Cast Iron operating system on the Integration Appliance.

system show version
system update cios image

Updates the Cast Iron Operating System on the Integration Appliance using an image from an FTP Server based file or an SFTP Server based file.

system update cios image from <source>
where source can specify an FTP Server or an SFTP Server:
  • ftp <hostname> [port <number>] [user <user>] file <filename>
  • sftp <hostname> [port <number>] user <user> file <filename>
  • http <hostname> [port <number>] [user <user>] file <filename>
  • https <hostname> [port <number>] user <user> file <filename>
Note: When using sftp, you must specify the user parameter. Anonymous logins are not allowed with sftp.



Feedback | Notices


Timestamp icon Last updated: Friday, February 5, 2016


http://pic.dhe.ibm.com/infocenter/wci/v7r0m0/topic/com.ibm.wci.cli.doc/CLI_system_commands.html