Uploading Local Configuration Files

The File Declaration declares the full target path name for installation of a file on hosts; it is not the file itself. In this procedure you upload your local versions of Configuration files to the local knowledge base.

To Add a Local Configuration File

1. Log in with full permissions or as the admin user.

2. From the drop-down list in the tool bar, select a distribution-architecture.

   The Components list shows Local components applied to the selected distribution.

3. From the Components list, select Local/Configuration Files/category/file declaration.

4. Do one of the following:

   • From the tool bar, click the Add Component button.

   • Right-click the selected category and choose Local -> Add.

   • From the Components menu, choose Local -> Add.

     The Add Configuration File window opens.

5. Type a display version-name for the file.

   This text field is called Version (rather than Name), because the files that you add to a specific file declaration should all be different versions of one file. The Version value will be displayed in the Components list as a suffix to the file name.

   When you install this file on a remote host, it is installed under the full path name of the file declaration.

6. Type a free-text description.

7. Check each distribution to which this file should be applied. Make sure that the file declaration is on all the selected distributions.

8. Select a source machine:

   • If the console has access to the file, select Console.

   • If a remote managed host has access to the file, select Managed Host.

     Note: remote upload is limited to 5Mb; console upload is unlimited. It is recommended that you upload from the console whenever possible.

To Upload a Configuration File from the Console Machine

If you selected console, follow this procedure. If you selected Managed Host, go to To Upload a Configuration File from a Managed Host.

1. Click the Select File button of the File Name field.

   The Choose File window opens.

2. Browse to and select the relevant file.

3. Click Open.

   The Choose File window closes, and the path name appears in the File Name field of the Add Configuration File window.

4. Click Apply.

   The Status column indicates when the upload is done. Click Close to close the window, or Reset to add more.

To Upload a Configuration File from a Managed Host

If you selected Managed Host, follow this procedure.

1. Click the Select Host button of the Host Name field.

   The Host Selection window opens.

2. Select the managed host that has the software, and click OK.

   The Host Selection window closes. The host name appears in the Host Name field of the Add Configuration File window.

3. In the File Name field, type the full path name of the file.

4. Click Apply.

Example 5–8 Uploading a Configuration File with the CLI

The Add Target Local command is the same for Pre-actions, Post-actions, Configuration files, Macros, and Probes. The following syntax is for Configuration files. This command creates a file declaration automatically. It cannot be used to add a file to an existing declaration.

In the CLI syntax, a category under the default Local categories is mandatory. See Example 5–1 on for the Add Local Category CLI command. See Add Target Local (-atl) Command.

#! /bin/bash 

function login { 
  echo -n “Type your user name:” 
  read user 
  echo -n “Type your password:” 
  read password 
} 
function distro { 
  echo “Active distributions are:” 
  uce_cli -ld -u “$user” -p “$password” 
  echo -n “To which distro should this file be added?” 
  read distro 
  echo } 
function category { 
  echo “Under which category should this file be added?” 
  echo “A file declaration will be created automatically.” 
  echo “Valid answers: any subcategory under Configuration files. See list:” 
  uce_cli -fc -T “Configuration files” -sons -D $distro -u “$user” -p “$password” > tmp.file 
  sed “s/ROOT\/Local\/Configuration files//” tmp.file 
  echo -n “Start your answer with / :” 
  read parent 
  rm tmp.file 
  echo 
} 
function setup { 
  echo -n “Type the full path name of the file to upload: “ 
  read pathname 
  echo -n “Type a version suffix for this version of the file: “ 
  read version 
  echo -n “Type a display name for the local file: “ 
  read displayName 
} 
login 
distro 
category 
setup 
uce_cli -atl -f “$pathname” -pT “Configuration files$parent” -tF “$displayName” -v “$version” \
-D $distro -u “$user” -p “$password”