Client Automation - How to move the Software Delivery package library to a new location.

Products

CA Client Automation - IT Client Manager CA Client Automation CA Client Automation - Software Delivery

Issue/Introduction

This document provides the procedure for moving the software delivery library and MSI Administrative Installation point to a new location. This procedure is commonly performed when you need to move the library to a location containing more free disk space. This procedure is applicable to an Enterprise Manager, Domain Manager or Scalability Server.

Environment

Client Automation - All Versions

Resolution

Procedure to Move the Software Delivery Library:

Ensure any active software delivery jobs or distributions using the library are terminated and cleaned up before proceeding
Stop the CAF service: caf stop
Record the current configuration values before making any changes:

ccnfcmda -cmd GetParameterValue -ps itrm/usd/shared -pn ARCHIVE

ccnfcmda -cmd GetParameterValue -ps itrm/usd/shared -pn ASMTemp

Verify if the software library is configured for Windows file share access.

Run "net share" on the command prompt and check for the presence of the SDLIBRARY$ share in the list.
If the SDLIBRARY$ share is present, this means the library is enabled for Windows file share access, and we will need to reconfigure this after moving the library.

If the SDLIBRARY$ share is present remove it with :
sd_sscmd removeshare SDLIBRARY

Additional information:
By default, when an agent connects to the scalability server to execute a software package, it first attempts a download method called, "Internal NOS", where instead of downloading the source files for the software package, it maps a temporary drive share to the location of the package in the library, and executes the procedure remotely.

In the absence of the SDLIBRARY$ share, the agent will automatically fall back to a download method called, "Internal NOS-less", where the source files for the software package are instead downloaded to a temporary folder on the agents local disk, and the procedure is executed locally.
Move the library from the current location, to the new location.

The default location of the software delivery library is:

C:\Program Files (x86)\CA\DSM\SD\ASM\LIBRARY

For instructional purposes this document will use "T:\NewLocation\LIBRARY" to reference the new library location.

Update the comstore for the new library location:

ccnfcmda -cmd SetParameterValue -ps itrm/usd/shared -pn ARCHIVE -v "T:\NewLocation\LIBRARY"
ccnfcmda -cmd SetParameterValue -ps itrm/usd/shared -pn ASMTemp -v " T:\NewLocation\LIBRARY"

Restore library access using Windows file shares.

If Windows file share access was previously enabled, run the following command to recreate the SDLIBRARY$ share at the new library location:
sd_sscmd addshare SDLIBRARY
Start the CAF service: caf start

Procedure to move the MSI Administrative Installation point:

Ensure any active software delivery jobs or distributions using the library are terminated and cleaned up before proceeding.
Stop the CAF service: caf stop
Record the current configuration values before making any changes:

ccnfcmda -cmd GetParameterValue -ps itrm/usd/shared -pn MSIAdminPath
Remove the MSILIB share if it is present (could be check with net share command)

sd_sscmd removeshare MSILIB
Move the administrative install point from the current location, to the new location.
The default location of the software delivery library is:

C:\Program Files (x86)\CA\DSM\SD\ASM\MSILIB

For instructional purposes this document will use "T:\NewLocation\MSILIB" to reference the new location.
Update the comstore for the new location:
ccnfcmda -cmd SetParameterValue -ps itrm/usd/shared -pn MSIAdminPath -v "....\NewLocation\MSILIB"
Enable the MSILIB share if it was enabled.
sd_sscmd addshare MSILIB
Start the CAF service: caf start

Additional Information

You must terminate any ongoing/active software delivery jobs (or distributions) that may be using the library or MSI Admin installation point. This is because active software jobs may be using temporary NTFS junction points created in the filesystem, to access source files from within the library. When the library is moved, these junction points will be removed, causing unexpected software job results.

Example :

How to move the SD LIBRARY and MSILIB folders from C:\Program Files (x86)\CA\DSM\SD\ASM\LIBRARY and C:\Program Files (x86)\CA\DSM\SD\ASM\MSILIB to C:\DSM\LIBRARY and C:\DSM\MSILIB ?

1- Stop caf

caf stop

2- Check the current location of SD LIBRARY and MSILIB in the comstore with these commands :

ccnfcmda -cmd GetParameterValue -ps itrm/usd/shared -pn ARCHIVE

ccnfcmda -cmd GetParameterValue -ps itrm/usd/shared -pn ASMTemp

ccnfcmda -cmd GetParameterValue -ps itrm/usd/shared -pn MSIAdminPath

3- Check if the shares SDLIBRARY$ and SDMSILIB are present with command net share :

4- If the shares are present, remove them with :

sd_sscmd removeshare SDLIBRARY

sd_sscmd removeshare MSILIB

Remark : Check the Share Permissions and NTFS permissions set before. Then same permissions could be applied on the new shares

5- Move the library and msilib folders from old to new locations.

Example :

Move all files and directories from C:\Program Files (x86)\CA\DSM\SD\ASM\LIBRARY to C:\DSM\LIBRARY

Move all files and directories from C:\Program Files (x86)\CA\DSM\SD\ASM\MSILIB to C:\DSM\MSILIB

6- Execute these commands to set the new location in comstore :

ccnfcmda -cmd SetParameterValue -ps itrm/usd/shared -pn ARCHIVE -v "C:\DSM\LIBRARY"
ccnfcmda -cmd SetParameterValue -ps itrm/usd/shared -pn ASMTemp -v "C:\DSM\LIBRARY"

ccnfcmda -cmd SetParameterValue -ps itrm/usd/shared -pn MSIAdminPath -v "C:\DSM\MSILIB"

7- If the shares were present before recreate them with :

sd_sscmd addshare SDLIBRARY

sd_sscmd addshare MSILIB

And set the correct share permissions and NTFS permissions on these folders.

8- Start caf

caf start