ConfigArchiveOperations command group for the AdminTask object

 

+

Search Tips   |   Advanced Search

 

You can use the Jython or Jacl scripting languages to configure servers in your environment. The commands and parameters in the ConfigArchiveOperations group can be used to export or import server configurations and entire cell configurations.

The ConfigArchiveOperations command group for the AdminTask object includes the following commands:

• exportServer
• exportWasprofile
• importServer
• importWasprofile

 

exportServer

Use the exportServer command to export the server configuration to a node that is defined in the configuration archive.

The exportServer command virtualizes the server configuration and exports a server to a configuration archive. This process breaks any existing associations between the server configurations in the configuration archive and the configurations in the system. This process also removes applications from the server specified, breaks the relationship between the server specified and the core group of the server, cluster, or service integration bus member.

The exportServer command exports the metadata file of the node where the server resides. You can use this information later when you import the configuration archive to verify that the target node is compatible to the node from which you are exporting the server.ship.

Target object None

Parameters and return values

-archive

The fully qualified path of the exported configuration archive. (String, required)

-nodeName

The node name of the server. This parameter is only required when the server name is not unique across the cell. (String, optional)

-serverName

The server name. (String, required)

Examples

Batch mode example usage:

wsadmin -lang jython -f exportServer.py

• Use Jacl:

  $AdminTask exportServer {-archive c:\myServer.ear -nodeName node1 -serverName server1}

• Use Jython string:

  AdminTask.exportServer('[-archive c:\myServer.ear -nodeName node1 -serverName server1]')

• Use Jython list:

  AdminTask.exportServer(['-archive', 'c:\myServer.ear', '-nodeName', 'node1', '-serverName', 'server1'])

Interactive mode example usage:

• Use Jacl:

  $AdminTask exportServer {-interactive}

• Use Jython string:

  AdminTask.exportServer ('[-interactive]')

• Use Jython list:

  AdminTask.exportServer (['-interactive'])

 

exportWasprofile

Use the exportWasprofile command to export the entire cell configuration to a configuration archive. The exportWasprofile command does not work between the distributed and z/OS platforms.

Target object None

Parameters and return values

-archive

The fully qualified file path of the exported configuration archive. (String, required)

Examples Batch mode example usage:

• Use Jacl:

  $AdminTask exportWasprofile {-archive c:\myCell.car}

• Use Jython string:

  AdminTask.exportWasprofile('[-archive c:\myCell.car]')

• Use Jython list:

  AdminTask.exportWasprofile(['-archive', 'c:\myCell.car'])

Interactive mode example usage:

• Use Jacl:

  $AdminTask exportWasprofile {-interactive}

• Use Jython string:

  AdminTask.exportWasprofile ('[-interactive]')

• Use Jython list:

  AdminTask.exportWasprofile (['-interactive'])

 

importServer

Use the importServer command to import a server that resides in a configuration archive to the system. This command imports all the server scope configurations defined in the configuration archive to system configuration.

Target object None

Parameters and return values

-archive

The fully qualified path of the configuration archive. (String, required)

-nodeInArchive

The node name of the server defined in the configuration archive. (String, optional if there is only one node defined in the configuration archive, required if there are multiple nodes defined in the configuration archive)

-serverInArchive

The name of the server defined in the configuration archive. (String, optional if there is only one server defined on the specified nodeInConfiguration archive, required if there are multiple servers defined under the specified nodeInConfiguration archive)

-nodeName

The node name where the server is imported. (String, optional if there is only one node)

-serverName

The server name where the server is imported. If the server name that you specify matches an existing server name under the node, an exception is created. (String, optional, default:serverInArchive)

-coreGroup

The core group name to which the server should belong. (String, optional)

Examples

Batch mode example usage:

• Use Jacl:

  $AdminTask importServer {-archive c:\myServer.ear -nodeInArchive node1 -serverInArchive server1}

• Use Jython string:

  AdminTask.importServer('[-archive c:\myServer.ear -nodeInArchive node1 -serverInArchive server1]')

• Use Jython list:

  AdminTask.importServer(['-archive', 'c:\myServer.ear', '-nodeInArchive', 'node1', '-serverInArchive', 'server1'])

Interactive mode example usage:

• Use Jacl:

  $AdminTask importServer {-interactive}

• Use Jython string:

  AdminTask.importServer ('[-interactive]')

• Use Jython list:

  AdminTask.importServer (['-interactive'])

 

importWasprofile

Use the importWas profile command to import a cell configuration in the configuration archive to the system. Only a base single server configuration is supported for this command. The importWasprofile command does not work between the distributed and z/OS platforms.

Target object None

Parameters and return values

-archive

The fully qualified file path of the configuration archive. (String, required)

Examples Batch mode example usage:

• Use Jacl:

  $AdminTask importWasprofile {-archive c:\myCell.ear}

• Use Jython string:

  AdminTask.importWasprofile('[-archive c:\myCell.ear]')

• Use Jython list:

  AdminTask.importWasprofile(['-archive', 'c:\myCell.ear'])

Interactive mode example usage:

• Use Jacl:

  $AdminTask importWasprofile {-interactive}

• Use Jython string:

  AdminTask.importWasprofile ('[-interactive]')

• Use Jython list:

  AdminTask.importWasprofile (['-interactive'])

---

 

Related tasks

Use the AdminTask object for scripted administration

 

Related Reference

Commands for the AdminTask object