Configurazione delle variabili di ambiente di installazione per IBM Software Hub Control Center

I comandi per l'installazione IBM Software Hub Control Center (Control Center) utilizzano variabili con il formato ${VARIABLE_NAME}. È possibile creare uno script per esportare automaticamente i valori appropriati come variabili di ambiente prima di eseguire i comandi richiesti. Dopo aver reperito lo script, potrai copiare la maggior parte dei comandi richiesti dalla documentazione ed eseguirli senza apportare alcuna modifica.

Chi deve completare questo compito?

Team operativo Il team IBM Software Hub operativo dovrebbe collaborare con l'amministratore del cluster per raccogliere informazioni sul cluster dove Control Center verrà installato.

Quando devi completare questo compito?
Ripeti secondo necessità Crea uno script di variabile d'ambiente per ogni cluster in cui prevedi di installare Control Center.
Ricorda: Control Center può essere installato una sola volta su un cluster.

Creazione di un file delle variabili d'ambiente

Il contenuto del file delle variabili d'ambiente dipende dalla posizione in cui si intende eseguire l'installazione Control Center. Segui i passaggi appropriati per il tuo ambiente:

Creazione di un file di variabili d'ambiente da installare Control Center sullo stesso cluster di IBM Software Hub

  1. Copia il seguente esempio in un editor di testo sul tuo file system locale:
    #===============================================================================
# IBM Software Hub Control Center installation variables
#===============================================================================

# ------------------------------------------------------------------------------
# Source your existing environment variables script
# ------------------------------------------------------------------------------
source ./cpd_vars.sh

# ------------------------------------------------------------------------------
# Control Center cluster
# ------------------------------------------------------------------------------

export CONTROL_OCP_URL=${OCP_URL}
export CONTROL_IMAGE_ARCH=${IMAGE_ARCH}
# export CONTROL_OCP_USERNAME=${OCP_USERNAME}
# export CONTROL_OCP_PASSWORD=${OCP_PASSWORD}
# export CONTROL_OCP_TOKEN=${OCP_TOKEN}
export CONTROL_SERVER_ARGUMENTS="--server=${CONTROL_OCP_URL}"
# export CONTROL_LOGIN_ARGUMENTS="--username=${CONTROL_OCP_USERNAME} --password=${CONTROL_OCP_PASSWORD}"
# export CONTROL_LOGIN_ARGUMENTS"--token=${CONTROL_OCP_TOKEN}"
export CONTROL_CPDM_OC_LOGIN="cpd-cli manage login-to-ocp ${CONTROL_SERVER_ARGUMENTS} ${CONTROL_LOGIN_ARGUMENTS}"
export CONTROL_OC_LOGIN="oc login ${CONTROL_SERVER_ARGUMENTS} ${CONTROL_LOGIN_ARGUMENTS}"

# ------------------------------------------------------------------------------
# Control Center storage
# ------------------------------------------------------------------------------

export CONTROL_STG_CLASS_BLOCK=${STG_CLASS_BLOCK}
export CONTROL_STG_CLASS_FILE=${STG_CLASS_FILE}

# ------------------------------------------------------------------------------
# Control Center projects
# ------------------------------------------------------------------------------

export CONTROL_PROJECT_OPERATORS=<enter your IBM Software Hub Control Center operator project>
export CONTROL_PROJECT_OPERANDS=<enter your IBM Software Hub Control Center operand project>
  2. Aggiorna il source comando se una delle seguenti affermazioni è vera:
  3. Aggiorna le seguenti sezioni nello script. Per informazioni sulle variabili e sui valori validi in ciascuna sezione dello script, consultare le sezioni seguenti:
  4. Salva il file come script shell. Ad esempio, salva il file come control_center_vars.sh.
  5. Verificare che lo script non contenga errori. Ad esempio, se hai chiamato lo script control_center_vars.sh, esegui:
    bash ./control_center_vars.sh
  6. Se hai memorizzato le password nel file, impedisci ad altri di leggere il file. Ad esempio, se hai chiamato lo script control_center_vars.sh, esegui:
    chmod 700 control_center_vars.sh

Creazione di un file di variabili di ambiente da installare Control Center su un cluster diverso

  1. Copia il seguente esempio in un editor di testo sul tuo file system locale:
    #===============================================================================
# IBM Software Hub Control Center installation variables
#===============================================================================

# ------------------------------------------------------------------------------
# Control Center cluster
# ------------------------------------------------------------------------------

export CONTROL_OCP_URL=<enter your Red Hat OpenShift Container Platform URL>
export CONTROL_IMAGE_ARCH=<enter your cluster architecture>
# export CONTROL_OCP_USERNAME=<enter your username>
# export CONTROL_OCP_PASSWORD=<enter your password>
# export CONTROL_OCP_TOKEN=<enter your token>
export CONTROL_SERVER_ARGUMENTS="--server=${CONTROL_OCP_URL}"
# export CONTROL_LOGIN_ARGUMENTS="--username=${CONTROL_OCP_USERNAME} --password=${CONTROL_OCP_PASSWORD}"
# export CONTROL_LOGIN_ARGUMENTS="--token=${CONTROL_OCP_URL}"
export CONTROL_CPDM_OC_LOGIN="cpd-cli manage login-to-ocp ${CONTROL_SERVER_ARGUMENTS} ${CONTROL_LOGIN_ARGUMENTS}"
export CONTROL_OC_LOGIN="oc login ${CONTROL_SERVER_ARGUMENTS} ${CONTROL_LOGIN_ARGUMENTS}"

# ------------------------------------------------------------------------------
# Control Center storage
# ------------------------------------------------------------------------------

export CONTROL_STG_CLASS_BLOCK=<RWO-storage-class-name>
export CONTROL_STG_CLASS_FILE=<RWX-storage-class-name>

# ------------------------------------------------------------------------------
# Control Center projects
# ------------------------------------------------------------------------------

export CONTROL_PROJECT_LICENSE_SERVICE=<enter your License Service project on the Control Center cluster>
export CONTROL_PROJECT_SCHEDULING_SERVICE=<enter your scheduling service project on the Control Center cluster>
export CONTROL_PROJECT_OPERATORS=<enter your IBM Software Hub Control Center operator project>
export CONTROL_PROJECT_OPERANDS=<enter your IBM Software Hub Control Center operand project>
  2. Aggiorna le seguenti sezioni nello script. Per informazioni sulle variabili e sui valori validi in ciascuna sezione dello script, consultare le sezioni seguenti:
  3. Salva il file come script shell. Ad esempio, salva il file come control_center_vars.sh.
  4. Verificare che lo script non contenga errori. Ad esempio, se hai chiamato lo script control_center_vars.sh, esegui:
    bash ./control_center_vars.sh
  5. Se hai memorizzato le password nel file, impedisci ad altri di leggere il file. Ad esempio, se hai chiamato lo script control_center_vars.sh, esegui:
    chmod 700 control_center_vars.sh

Ricerca delle variabili di ambiente

Salva una copia dello script sulla tua workstation ed eseguilo da un prompt bash prima di eseguire i Control Center comandi di installazione. Lo script esporta le variabili di ambiente nella sessione della riga di comando.

Importante: è necessario rieseguire lo script ogni volta che si apre un nuovo prompt bash.
  1. Passa alla directory in cui hai salvato lo script.
  2. Recupera le variabili d'ambiente. Ad esempio, se hai chiamato lo script control_center_vars.sh, esegui:
    source ./control_center_vars.sh

Control Center cluster

Le variabili nella sezione Cluster dello script specificano le informazioni relative al Red Hat® OpenShift® Container Platform cluster in cui si intende eseguire l'installazione Control Center.

Variabile Descrizione
CONTROL_OCP_URL URL dell' Red Hat OpenShift Container Platform server dove si desidera installare IBM Software Hub Control Center. Ad esempio, https://openshift1.example.com:8443.
Valore predefinito
Non esiste un valore predefinito.
Valori validi
Il valore dipende da dove si sta installando Control Center:
Stesso cluster
Il file di esempio include il valore corretto:
${OCP_URL}
Cluster diverso
Specificare l' URL e del Red Hat OpenShift Container Platform cluster in cui si desidera eseguire l'installazione Control Center.
CONTROL_IMAGE_ARCH L'architettura del cluster in cui si desidera installare il centro di controllo IBM Software Hub.
Valore predefinito
Non esiste un valore predefinito.
Valori validi
Il valore dipende da dove si sta installando Control Center:
Stesso cluster
Il file di esempio include il valore corretto:
${IMAGE_ARCH}
Cluster diverso
amd64
Specificare amd64 se il Red Hat OpenShift Container Platform cluster è in esecuzione su un hardware x86-64.
ppc64le
Specificare ppc64le se il Red Hat OpenShift Container Platform cluster è in esecuzione su Power hardware.
s390x
Specificare s390x se il proprio Red Hat OpenShift Container Platform cluster funziona su hardware Z.
CONTROL_OCP_USERNAME Il nome utente che utilizzi per autenticarti al cluster su cui desideri installare IBM Software Hub Control Center. È necessario disporre di privilegi sufficienti per completare l'operazione.

Per utilizzare la CONTROL_OCP_USERNAME variabile, è necessario rimuovere il commento dal export comando nel file delle variabili di ambiente.

Suggerimento: si consiglia di impedire ad altri utenti di leggere il contenuto dello script della variabile di ambiente eseguendo chmod 700. Tuttavia, se hai ancora dubbi riguardo alla memorizzazione delle tue OpenShift credenziali in questo file, puoi:
  • Inserisci direttamente le credenziali invece di utilizzare la variabile di ambiente nei comandi.
  • Esporta manualmente le credenziali prima di eseguire i comandi.
Valori validi
Il valore dipende da dove si sta installando Control Center:
Stesso cluster
Il file di esempio include il valore corretto:
${OCP_USERNAME}
Cluster diverso
Specifica il tuo nome utente.
CONTROL_OCP_PASSWORD La password utilizzata per l'autenticazione al cluster in cui si desidera installare IBM Software Hub Control Center.

Per utilizzare la CONTROL_OCP_PASSWORD variabile, è necessario rimuovere il commento dal export comando nel file delle variabili di ambiente.

Valori validi
Il valore dipende da dove si sta installando Control Center:
Stesso cluster
Il file di esempio include il valore corretto:
${OCP_PASSWORD}
Cluster diverso
Specificare la password.
CONTROL_OCP_TOKEN

È possibile utilizzare un token al posto del nome utente e della password per accedere al cluster Red Hat OpenShift Container Platform in cui si desidera eseguire l'installazione IBM Software Hub Control Center.

Puoi ottenere il tuo token dalla console Red Hat OpenShift Container Platform web. Dal menu a tendina del nome utente, seleziona Copia comando di accesso. Quando richiesto, clicca su Visualizza token.

Per utilizzare la CONTROL_OCP_TOKEN variabile, è necessario rimuovere il commento dal export comando nel file delle variabili di ambiente.

Valori validi
Il valore dipende da dove si sta installando Control Center:
Stesso cluster
Il file di esempio include il valore corretto:
${OCP_TOKEN}
Cluster diverso
Specifica il tuo token.
CONTROL_SERVER_ARGUMENTS L'argomento server da passare per accedere al cluster IBM Software Hub Control Center.

Non modificare questo export comando.

La variabile CONTROL_SERVER_ARGUMENTS di ambiente dipende dalla variabile CONTROL_SERVER_ARGUMENTS di ambiente.
CONTROL_LOGIN_ARGUMENTS Gli argomenti delle credenziali da passare per accedere al cluster IBM Software Hub Control Center.
La variabile di CONTROL_LOGIN_ARGUMENTS ambiente dipende dalle credenziali utilizzate per effettuare l'accesso.
Un nome utente e una password
Se si specificano nome utente e password, la variabile CONTROL_LOGIN_ARGUMENTS di ambiente dipende dalle seguenti variabili di ambiente:
  • CONTROL_OCP_USERNAME
  • CONTROL_OCP_PASSWORD

Se stai lavorando dallo script delle variabili di ambiente di esempio, rimuovi il commento export CONTROL_LOGIN_ARGUMENTS dalla voce che include le voci relative al nome utente e alla password.

Non modificare questo export comando.

Un gettone
Se si specifica un token, la variabile CONTROL_LOGIN_ARGUMENTS di ambiente dipende dalla variabile CONTROL_OCP_TOKEN di ambiente.

Se stai lavorando dallo script delle variabili di ambiente di esempio, rimuovi il commento CONTROL_LOGIN_ARGUMENTS dalla voce che include la voce del token.

Non modificare questo export comando.
CONTROL_CPDM_OC_LOGIN Scorciatoia per il cpd-cli manage login-to-ocp comando relativo al cluster in cui si desidera eseguire l'installazione IBM Software Hub Control Center.

Non modificare questo export comando.

La variabile CONTROL_CPDM_OC_LOGIN di ambiente dipende dalle seguenti variabili di ambiente:
  • CONTROL_SERVER_ARGUMENTS
  • CONTROL_LOGIN_ARGUMENTS
CONTROL_OC_LOGIN Scorciatoia per il oc login comando relativo al cluster in cui si desidera eseguire l'installazione IBM Software Hub Control Center.

Non modificare questo export comando.

La variabile CONTROL_OC_LOGIN di ambiente dipende dalle seguenti variabili di ambiente:
  • CONTROL_SERVER_ARGUMENTS
  • CONTROL_LOGIN_ARGUMENTS

Control Center Archiviazione

Archiviazione

Le variabili nella sezione Storage dello script specificano le classi di archiviazione che Control Center l'installazione deve utilizzare.

Control Center utilizza lo stesso spazio di archiviazione di IBM Software Hub.

Hai bisogno di ulteriori informazioni sullo storage? Vedere:
Variabile Descrizione
CONTROL_STG_CLASS_BLOCK Il nome di una classe di archiviazione a blocchi sul cluster in cui si desidera installare IBM Software Hub Control Center. La classe di archiviazione deve essere associata a un'opzione di archiviazione supportata.
Valore predefinito
Non esiste un valore predefinito.
Valori validi
Il valore dipende da dove si sta installando Control Center:
Stesso cluster
Il file di esempio include il valore corretto:
${STG_CLASS_BLOCK}
Cluster diverso
Specificare il nome di una classe di archiviazione che punta all'archiviazione a blocchi (archiviazione che supporta l'accesso in sola lettura ( ReadWriteOnce,, RWO)).
Il seguente elenco fornisce le classi di archiviazione consigliate per le opzioni di archiviazione supportate. Se si utilizzano classi di archiviazione diverse, identificare una classe di archiviazione equivalente sul cluster.
  • OpenShift Data Foundation: ocs-storagecluster-ceph-rbd
  • IBM Fusion Data Foundation: ocs-storagecluster-ceph-rbd
  • IBM Fusion Global Data Platform: Una delle seguenti classi di archiviazione, a seconda dell'ambiente:
    • ibm-spectrum-scale-sc
    • ibm-storage-fusion-cp-sc
  • IBM Storage Scale Container Native: ibm-spectrum-scale-sc
  • Portworx: portworx-metastoredb-sc
  • NFS: managed-nfs-storage
  • Amazon Elastic Block Store: Una delle seguenti classi di archiviazione, a seconda dell'ambiente:
    • gp2-csi
    • gp3-csi
  • Nutanix: nutanix-volume
CONTROL_STG_CLASS_FILE Il nome di una classe di archiviazione file sul cluster in cui si desidera installare IBM Software Hub Control Center. La classe di archiviazione deve essere associata a un'opzione di archiviazione supportata.
Valore predefinito
Non esiste un valore predefinito.
Valori validi
Il valore dipende da dove si sta installando Control Center:
Stesso cluster
Il file di esempio include il valore corretto:
${STG_CLASS_BLOCK}
Cluster diverso
Specificare il nome di una classe di archiviazione che punta all'archiviazione file (archiviazione che supporta l'accesso in lettura/scrittura, denominato anch ReadWriteMany,, RWX).
Il seguente elenco fornisce le classi di archiviazione consigliate per le opzioni di archiviazione supportate. Se si utilizzano classi di archiviazione diverse, identificare una classe di archiviazione equivalente sul cluster.
  • OpenShift Data Foundation: ocs-storagecluster-cephfs
  • IBM Fusion Data Foundation: ocs-storagecluster-cephfs
  • IBM Fusion Global Data Platform: Una delle seguenti classi di archiviazione, a seconda dell'ambiente:
    • ibm-spectrum-scale-sc
    • ibm-storage-fusion-cp-sc
  • IBM Storage Scale Container Native: ibm-spectrum-scale-sc
  • Portworx: portworx-rwx-gp3-sc
  • NFS: managed-nfs-storage
  • Amazon Elastic File System: efs-nfs-client
  • Nutanix: nutanix-file

Control Center Progetti

Le variabili nella sezione Progetti dello script specificano dove sono installati i componenti IBM Software Hub Control Center che compongono.

Variabile Descrizione
CONTROL_PROJECT_LICENSE_SERVICE Il progetto OpenShift in cui si desidera installare i servizi fondamentali IBM Cloud Pak License Service sul cluster in cui si desidera installare IBM Software Hub Control Center.

Questa variabile d'ambiente si applica solo se si intende eseguire l'installazione Control Center su un cluster diverso.

Valore predefinito
ibm-licensing
Valori validi
È possibile utilizzare qualsiasi Red Hat OpenShift progetto; tuttavia, si consiglia vivamente di utilizzare ibm-licensing. Non collocare il License Service insieme ad altri software.
CONTROL_PROJECT_SCHEDULING_SERVICE Il progetto OpenShift in cui si desidera installare il servizio di pianificazione sul cluster in cui si desidera installare IBM Software Hub Control Center.

Questa variabile d'ambiente si applica solo se si intende eseguire l'installazione Control Center su un cluster diverso.

Valore predefinito
Non esiste un valore predefinito.
Valori validi
È possibile utilizzare qualsiasi Red Hat OpenShift progetto; tuttavia, si consiglia vivamente di utilizzare ibm-cpd-scheduler. Non collocare il scheduling service insieme ad altri software.
CONTROL_PROJECT_OPERATORS Il progetto in cui desideri installare gli operatori IBM Software Hub Control Center.
Valore predefinito
Non esiste un valore predefinito.
Valori validi
È possibile utilizzare qualsiasi Red Hat OpenShift progetto, ma non collocare gli Control Center operatori insieme ad altro software.
CONTROL_PROJECT_OPERANDS Il progetto in cui desideri installare IBM Software Hub Control Center.
Valore predefinito
Non esiste un valore predefinito.
Valori validi
È possibile utilizzare qualsiasi Red Hat OpenShift progetto, ma non collocarlo Control Center insieme ad altro software.