Software Delivery: How to move the software delivery package library to a new location.

Document ID : KB000027669
Last Modified Date : 14/02/2018
Show Technical Document Details

Summary:                              

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.
 
 

Background:

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.
 
Environment:                                              
CA Client Automation - All Versions
 
 
Instructions:

 

Procedure to Move the Software Delivery Library:
1. Ensure any active software delivery jobs or distributions using the library are terminated and cleaned up before proceeding.
 
2. Stop the CAF service: caf stop
 
3. 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

4. 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.
 
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.
 
5. 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.

6. 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"
 
7. 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

8. Start the CAF service: caf start

 

Procedure to move the MSI Administrative Installation point:

1 . Ensure any active software delivery jobs or distributions using the library are terminated and cleaned up before proceeding.
 
2.  Stop the CAF service:    caf stop
 
3.  Record the current configuration values before making any changes:
        ccnfcmda -cmd GetParameterValue -ps itrm/usd/shared -pn MSIAdminPath
 
4.  Remove the MSILIB share:
       sd_sscmd removeshare MSILIB 

5.  Move the administrative install point from the current location, to the new location.

The default location of the software delivery library is:
       ...CA\DSM\SD\ASM\MSILIB
 
For instructional purposes this document will use "T:\NewLocation\MSILIB" to reference the new location.
 
6. Update the comstore for the new location:
        ccnfcmda -cmd SetParameterValue -ps itrm/usd/shared -pn MSIAdminPath -v "....\NewLocation\MSILIB"

7.  Enable the MSILIB share.
         sd_sscmd addshare MSILIB
 
8.  Start the CAF service:     caf start