Web Services Reference › Methods › Software › Software Package Volumes › CopyElementsToSoftwarePackageVolume

CopyElementsToSoftwarePackageVolume

The CopyElementsToSoftwarePackageVolume method copies the software elements pointed to by a series of directory paths, into the given software package volume.

Parameters

xsd:string sessionId (^m)

The session identifier.

xsd:string softwarePackageVolumeId (^m)

The UUID identifying the software package volume to which the elements should be copied.

xsd:string softwarePackageVolumeSubPath (^m)

The path in the volume to where the elements will be copied to.

ArrayOfFileSystemElementPath fileSystemElementPath (^m)

An array of paths to the file system elements that should be copied to the given software package volume.

Return Values

This is a void method that does not expose a return value.

Remarks

None

CopyElementsToSoftwarePackageVolume2

The CopyElementsToSoftwarePackageVolume2 method copies the software elements pointed to by a series of directory paths into the given software package volume. This method has an extra parameter, sourceOnManager, that enables user to initiate copying of software elements from the manager or Web Services.

Parameters

xsd:string sessionId (m)

The session identifier.

xsd:string softwarePackageVolumeId (m)

The UUID identifying the software package volume to which the elements should be copied.

xsd:string softwarePackageVolumeSubPath (m)

The path in the volume to where the elements will be copied to.

xsd:Boolean sourceOnManager

If sourceOnManager is true, the manager initiates the copying of software elements. If sourceOnManager is false, the Client Automation Webservice initiates the copying of software elements.

If the manager initiates copying, the value of fileSystemElementPath is from the context of the manager machine. If the webservice initiates copying, the value of fileSystemElementPath is from the context of the webservice (and the machine the web service is running on).

ArrayOfFileSystemElementPath fileSystemElementPath (m)

An array of paths to the file system elements that should be copied to the given software package volume.

Return Values

This is a void method that does not expose a return value.

Remarks

If SourceOnManager is true, then the copying of the elements is performed from the context of the user used to run CAF (caf user) at the manager.

If sourceOnManager is false, then the copying of the elements is performed from the context of the web service. The user associated with the thread (web service user) performing the copying at the web service must have permission to do the copy.

The web service user or caf user must have the following permissions:

• Read permission on the source elements to be copied (the files referred to by fileSystemElementPath[…]).
• Write permission on %INSTALL DIR%\SD\ASM\LIBRARY

If Client Automation Webservice is installed on Windows 2000 Advance Server and fileSystemElementPath contains UNC paths to access remote files, then sourceOnManager must be set to False and the user must have the above specified permission to access the remote files.

Definition of the Web Service User

Web Service on Windows

If the web service is running on Windows and the security provider used for authentication (in the web service login method) is WINNT, the web service will attempt to impersonate the user used in logon to perform the copying rather then use the user set by IIS (for the thread).

Note: If the web service is running on Windows Advanced Server 2000, then to impersonate the supplied credentials (in login) the user associated with the thread must have the following local security privileges:

• Act as a part of the operating System
• Bypass traverse checking
• Log on locally

The user associated with the current thread (before impersonation takes place) is whatever has been configured in IIS, by default the IIS anonymous user.

If the web service is running on Windows but the WINNT security provider is not used (for example LDAP could be used), or an impersonation attempt fails, then the web service user will be the user associated with the current thread as configured by IIS.

Web Service on Linux

If the web service is running on Linux, the user will be the user associated with the process, by default root.