Modifica del database dei prodotti installati (swmodify)

SD-UX registra le installazioni nel sistema di software, prodotti e set di file tramite il database dei prodotti installati (IPD) ed il software nei depot tramite i file catalogo.

Il database dei prodotti installati ed i file catalogo sono creati e costantemente modificati da alcune operazioni di SD-UX (swinstall, swcopy e swremove); nel caso si desideri modificare le informazioni in essi contenute, non sono direttamente accessibili. Se fosse necessario modificare le informazioni contenute nel database dei prodotti installati o nei file catalogo dei depot, occorrerà utilizzare il comando swmodify.

Il comando swmodify aggiunge, modifica o elimina gli oggetti o gli attributi software definiti in un depot software, in una root principale o in una root alternativa. È un'interfaccia diretta ai file catalogo di un depot o al database dei prodotti installati di una root. Non modifica i file che costituiscono l'oggetto, opera solamente con le informazioni che lo descrivono.

Usando swmodify, è possibile

Aggiungere ad oggetti esistenti bundle, prodotti, sottoprodotti, set di file, script di controllo o definizioni di file
Rimuovere la descrizione di oggetti software dai file catalogo di un depot o dal database dei prodotti installati di una root
Cambiare i valori degli attributi di un qualsiasi oggetto esistente.
Definire gli attributi degli oggetti di nuova aggiunta.

Per un depot, i file catalogo sono l'equivalente dei file del database dei prodotti installati. Quando si crea o si modifica un depot con swcopy, i file catalogo che descrivono il depot ed il suo contenuto saranno compilati, per impostazione predefinita, in /var/spool/sw/catalog.

Contenuto del database dei prodotti installati

Situato nella directory /var/adm/sw/products, il database dei prodotti installati è costituito da una serie di file e sottodirectory che contengono le informazioni di tutti i prodotti che sono stati installati nella directory root (/). Queste informazioni comprendono “tag” o nome del prodotto, campo del titolo (di una riga), testo descrittivo (uno o più paragrafi), file README (di una certa lunghezza), informazioni sul copyright, informazioni del produttore ed i numeri di serie di ogni prodotto installato. Inoltre, il database dei prodotti installati contiene le informazioni sulla revisione ed il campo architecture destinato all'utente che comprende i quattro attributi uname (sistema operativo, release, versione e tipo di hardware). Ecco come si presenta il file INFO del database dei prodotti installati del prodotto “Accounting”:

fileset
tag ACCOUNTNG
data_model_revision 2.4
instance_id 1
control_directory ACCOUNTNG
size 292271
revision B.11.00
description Vendor Name: Hewlett-Packard Company
Product Name: Accounting
Fileset Name: ACCOUNTING
 
Text: "HP-UX System Accounting feature set. Use these 
features to gather billing data for such items as disk space 
usage, connect time or CPU resource usage.
"
timestamp 797724879
install_date 199504121614.39
install_source hpfclc.fc.hp.com:/release/11.00_gsL/goodsystem state configured
ancestor HPUX10.20.ACCOUNTNG
corequisite OS-Core.CMDS-MIN,r>=B.11.00,a=HP-UX_B.11.00_32/64,fa=HP-UX_B.11.00_32/64,v=HP

I file catalogo sono l'equivalente dei file del database dei prodotti installati, ma servono per il software archiviato in un depot. Quando si crea o si modifica un depot con swcopy, questi file saranno creati e salvati nel depot specificato, oppure nel depot predefinito /var/spool/sw. Essi descrivono il depot ed il suo contenuto.

I comandi swinstall, swconfig, swcopy e swremove, quando sono eseguiti, aggiungono, modificano e rimuovono automaticamente le informazioni contenute nei file catalogo e nel database dei prodotti installati. I comandi swlist e swverify leggono le informazioni del database e le utilizzano per modificare il comportamento dei comandi.

Il database dei prodotti installati contiene inoltre il file swlock, che gestisce gli accessi simultanei di lettura e/o scrittura agli oggetti software.

Uso di swmodify

Sintassi

swmodify [-d] [-p] [-r] [-u] [-v [-V] [-a attributo=[valore]]
[-c catalogo][-C file_sessione] [-f file_software] [-P file_percorso]
[-s file_specificazione_prodotto] [-S file_sessione] [-x opzione=valore][-X file_opzioni] 
[selezioni_software] [@ selezione_destinazioni]

Opzioni ed operandi

-d

Esegue le modifiche in un depot (non in una root principale o alternativa). La selezione_destinazione deve essere un depot.

-p

Anteprima di una sessione senza alcuna modifica effettiva nella selezione_destinazione.

-r

Esegue le modifiche in una root alternativa invece che in una root principale. La selezione_destinazione deve essere una root alternativa.

-u

Se non è stata specificata l'opzione -a attributo, la selezione_software contenuta nella selezione_destinazione sarà eliminata. Quest'azione elimina dal catalogo del depot o dal database dei prodotti installati le definizioni degli oggetti software.

Se è stata specificata l'opzione -a attributo, allora queste saranno eliminate dalla selezione_destinazione.

-v

Attiva l'output dettagliato per stdout. (Il file di log di swmodify non è influenzato da questa opzione.)

-V

Elenca tutte le versioni_layout di SD supportate dal comando.

-a attributo=valore

Aggiunge, modifica o elimina il valore dell'attributo. Altrimenti, aggiunge o modifica l'attributo di ogni selezione_software, impostandolo al valore stabilito.

È possibile specificare più opzioni -a. Ciascuna modifica dell'attributo sarà applicata ad ogni selezione_software.

Le opzioni -s e -a si escludono a vicenda: l'opzione -s non potrà essere specificata se è stata utilizzata quella -a.

Non è possibile utilizzare l'opzione -a per modificare i seguenti attributi: tag, revision, instance_id, vendor_tag, corequisite o prerequisite.

-c catalogo

Scrive la struttura completa del catalogo nella directory specificata in catalogo. Saranno salvate le informazioni di tutti gli attributi fino al livello file e degli script di controllo. Vedere “Richiesta di risposta dall'utente (swask)”.

-C file_sessione

Esegue il comando e salva le opzioni e gli operandi correnti in un file_sessione, per riutilizzarlo in seguito. Vedere “File di sessione”.

-f file_software

Legge l'elenco delle selezioni del software da un file separato, invece di (oppure oltre a) specificarlo nella riga dei comandi. Vedere “File di selezione software”.

-P file_percorso

Specifica il file che contiene il percorso dei file da aggiungere o eliminare dal database dei prodotti installati.

-s file_specificazione_prodotto

Il File di specificazione del prodotto (PSF) dell'origine contiene le definizioni di prodotto, sottoprodotto, set di file, e/o file che saranno aggiunte o modificate da swmodify.

Specificando un file_specificazione_prodotto, swmodify selezionerà ogni singola selezione_software dall'insieme complessivo definito nel file di specificazione del prodotto. Se non è stata specificata una selezione_software, allora swmodify selezionerà tutto il software definito nel file di specificazione del prodotto. Il software selezionato da un file di specificazione del prodotto sarà applicato alla selezione_destinazione, cui saranno aggiunti, modificati o eliminati gli oggetti software selezionati.

Se non è stato indicato un file di specificazione del prodotto, allora sarà necessario specificare una selezione_software. Il comando swmodify sceglierà quindi la selezione_software nel software precisato in una data (o predefinita) selezione_destinazione.

Il file di specificazione del prodotto (PSF) utilizza per swmodify il medesimo formato dei file per swpackage, come spiegato in “Creazione del File di specificazione del prodotto (PSF)”.

-S file_sessione

Esegue il comando utilizzando le opzioni e gli operandi salvati in una precedente sessione di installazione e memorizzati in un file_sessione. Vedere “File di sessione”.

-x opzione=valore

Imposta una opzione del comando ad un dato valore, ignorando quello predefinito o quelli del file delle opzioni. Vedere “Modifica delle opzioni dei comandi ”.

-X file_opzioni

Legge le opzioni di sessione e funzionamento da un file_opzioni. Vedere “Modifica delle opzioni dei comandi ”.

selezioni_software

Gli oggetti software dei quali saranno modificate le informazioni. Vedere “Selezioni software”.

selezione_destinazione

Una singola selezione_destinazione locale. (Vedere “Selezioni della destinazione”.) Se si sta operando in una root principale, non sarà necessario specificare selezione_destinazione, perché sarà presupposta quella /.

Quando si agisce su un depot software, la selezione_destinazione specifica il percorso del depot. Se è stata specificata l'opzione -d ma non la selezione_destinazione, sarà allora utilizzata la directory_depot predefinita.




	NOTA: In generale, utilizzare con cautela l'opzione -u assieme a quella -a. Se è stata specificata l'opzione -u oltre a quella -a, l'opzione -a eliminerà l'`attributo` da una data `selezione_software`, oppure eliminerà il `valore` dall'insieme dei valori attualmente definiti per l'`attributo`.

Modifica delle opzioni dei comandi

È possibile modificare il funzionamento di questo comando specificando delle ulteriori opzioni al momento della sua esecuzione nella riga dei comandi, con l'opzione -x, oppure leggendo i valori memorizzati in un file. La tabella seguente mostra le opzioni ed i valori predefiniti di swmodify.

Tabella 3-7 Opzioni e valori predefiniti del comando swmodify

admin_directory=/var/adm/sw
allow_large_files=false
compress_index=false
control_files=
distribution_target_directory= /var/spool/sw
files=
installed_software_catalog=products
layout_version=1.0
log_msgid=0
logdetail=false

logfile=/var/adm/sw/swmodify.log
loglevel=1
patch_commit=false
run_as_superuser=true
software=
source_file=
target_directory=
targets=
verbose=1

Per ulteriori informazioni

Per la descrizione completa di ogni valore predefinito, vedere l'Appendice A.

Procedure con swmodify ed esempi

Seguono alcuni esempi dell'uso di swmodify per modificare i file catalogo o i database dei prodotti installati:

Aggiungere informazioni a IPD

Per aggiungere ad un set di file esistente le descrizioni dei file /tmp/a, /tmp/b e /tmp/c:

swmodify -x files=/tmp/a /tmp/b /tmp/c PRODOTTO.SET_DI_FILE

Se uno script di controllo aggiunge nuovi file nel filesystem installato, lo script potrà utilizzare swmodify per creare un record dei nuovi file.

Modifica delle informazioni IPD esistenti

Per creare le definizioni di un nuovo bundle per i prodotti di un depot esistente:

# swmodify -d -s definizioni_nuovo_bundle \
         \* @ /mfg/master_depot

Se il prodotto offe una procedura di configurazione più complessa, al termine dell'operazione uno script sarà in grado di impostare lo stato del set di file come configured.

Per cambiare il valore degli attributi di un set di file:

# swmodify -a state=installed PRODOTTO.SET_DI_FILE

Per cambiare l'attributo di un depot:

# swmodify -a title=Master Depot \
         -a description=/tmp/mfg.description \
         @ /mfg/master_depot

Definizione di nuovi oggetti

È possibile importare un'applicazione esistente, non installata con SD-UX, creando un semplice file di specificazione del prodotto (PSF) che lo descrive, quindi eseguire swmodify per inserire la sua definizione nel database dei prodotti installati.

Per creare una nuova definizione di set di file (se il file di specificazione del prodotto contiene le definizioni dei file, quindi aggiungerli al nuovo set di file):

swmodify -s nuova_definizione_set_di_file