Il primo passo è installare nel sistema il prodotto Extend™. La cosa più semplice è installare il pacchetto completo.

Occorrono:

• accesso al sistema con operatore root (amministratore di sistema);
• pacchetto di installazione appropriato per il proprio sistema;
• i codici di attivazione dei moduli di prodotto acquistati, o in alternativa i files di licenza già preparati per gli stessi.

Il nome dell'utente amministratore di sistema è normalmente root. La relativa password viene di solito impostata al momento dell'installazione iniziale del sistema stesso, e deve, ovviamente, essere nota per poter utilizzare l'accesso.

È possibile utilizzare anche un altro utente qualsiasi, ma visto che si dovrà intervenire su numerosi parametri di configurazione del sistema, tale utente dovrà avere permessi equivalenti a root.

Il modulo di installazione dei prodotto Extend™ consiste in un archivio in formato TAR+GZip, il cui nome è normalmente composto da:

acucob + numero_di_versione + pmk + identificativo_piattaforma + tipo_eseguibili + .tar.gz.

dove:

• numero_di_versione è il numero della versione generale del prodotto senza punti di separazione, p.e. per la versione 9.2.5 è 925, mentre per la versione 10.0.1 è 1001;
• identificativo_piattaforma è un codice numerico interno di Micro Focus che identifica la piattaforma hardware/software – quelli che ci interessano sono 60 per Linux su x86 (sistema a 32 bits) e 59 per Linux su x86_64 (sistema a 64 bits);
• tipo_eseguibili è una sigla che specifica se i programmi eseguibili contenuti sono stati preparati in modalità “Static libraries” (st) o “Shared libraries” (sh) – solo nel secondo caso il pacchetto include tutte le funzionalità, in quanto alcune di esse dipendono inerentemente dalla modalità shared, come per esempio AcuXDBC.

Per installare su un sistema Linux a 64 bits il software Extend™ versione 9.2.5 completo occorrerà quindi il file: acucob925pmk59sh.tar.gz.

Ogni modulo di Extend™ acquistato necessita di essere attivato tramite i codici specifici denominati PRODUCT CODE (codice prodotto) e PRODUCT KEY (chiave prodotto).

Questi codici sono composti da una sequenza di lettere maiuscole e cifre, e devono essere forniti assieme al prodotto stesso, sia in forma cartacea che elettronica.

L'attivazione avviene tramite un apposito comando da avviare una volta completata l'installazione, che risulterà nella creazione di uno specifico file di licenza.

In alcuni casi una singola coppia PRODUCT CODE/PRODUCT KEY può generare due o più files di licenza separati.

In alternativa i files di licenza possono essere già stati preparati e forniti tramite supporto elettronico. Questi files hanno normalmente l'estensione .alc (ma esistono varie eccezioni, con l'unica costante delle lettere lc finali). Ad esempio, la licenza per l'esecuzione del runtime cobol è denominata runcbl.alc, quella per il servizio di thin-client acurcl.alc, e così via.

Si consiglia di creare una apposita cartella per contenere tutte le licenze acquistate. In caso di licenze associate ai prodotti XS si può utilizzare la sottocartella alc della cartella di base dell'applicazione (p.e. /siscoxs/alc).

Se si ha la necessità di memorizzare in questa cartella licenze “omonime” può essere utile rinominarle esplicitamente – ad esempio una licenza per runtime Linux x86 a 32 bits in versione 9.x, 5 utenti, numero di serie “182019”, potrebbe essere rinominata in runcbl-mLINUX32-v900-u5-s182019.alc. L'importante è che appaia con il nome corretto (per copia o link simbolico) nella cartella di installazione del runtime, come specificato più avanti.

1. Accedere come utente root ad un prompt di comandi (“shell”);
2. Spostarsi nella cartella /opt e creare (se non già presente) una cartella denominata microfocus;
3. Spostarsi all'interno di /opt/microfocus e creare una cartella denominata acucblVVV, dove VVV è il numero di versione – nel nostro caso: acucbl925;
4. Spostarsi nella nuova cartella e decomprimere il pacchetto software – che avremo trasferito o scaricato, per esempio, nella cartella /tmp – con il comando: tar xvfz /tmp/acucob925pmk59sh.tar.gz;

Se si è installata la versione con shared libraries è necessario informare il linker/loader di sistema della presenza del nuovo software. I files di configurazione rilevanti sono nella cartella /etc/ld.so.conf.d. Creare – o aggiornare se già presente – il file zz-acucobol.conf in modo che contenga:

zz-acucobol.conf

# Shared libraries for Extend products (v.9.2.5)
/opt/microfocus/acucbl925/bin
/opt/microfocus/acucbl925/lib

dopodiché eseguire il comando ldconfig, in modo da riconfigurare il linker/loader includendo le nuove informazioni. (ovviamente i nomi delle cartelle ed il numero di versione devono rispecchiare il prodotto effettivamente presente).

A prescindere dall'utilizzo della versione con static– o shared libraries, è utile impostare alcune variabili di ambiente a livello di sistema per segnalare la presenza dei prodotti Extend™ ad altri software.

Per fare ciò, creare – o aggiornare se già presente – il file /etc/profile.d/zz-acucobol.sh perché contenga:

zz-acucobol.sh

# ACU COBOL product pointers
ACU_INSTALL_DIR=/opt/microfocus/acucbl925
export ACU_INSTALL_DIR
GENESIS_HOME=$ACU_INSTALL_DIR
export GENESIS_HOME
VORTEX_HOME=$ACU_INSTALL_DIR
export VORTEX_HOME
if [ -z "$LD_LIBRARY_PATH" ]
then
	LD_LIBRARY_PATH="$VORTEX_HOME/bin"
else
	LD_LIBRARY_PATH="$VORTEX_HOME/bin:$LD_LIBRARY_PATH"
fi

con la usuale attenzione ai nomi delle cartelle ed al numero di versione.

Notare che le modifiche a questo file risulteranno effettive al successivo login, e per i servizi al successivo riavvio del sistema.

1. Spostarsi nella cartella di installazione di Extend™, p.e. cd /opt/microfocus/acucbl925;
2. Spostarsi sotto la sottocartella bin;
3. Avviare il comando ./activator e seguire le istruzioni – verranno richiesti i codici PRODUCT CODE e PRODUCT KEY di ogni modulo che si desidera attivare;

1. Creare, se non lo si è già fatto in precedenza, una cartella per contenere i files di licenza – ad esempio /siscoxs/alc;
2. In questa cartella copiare i files di licenza da utilizzare; è possibile rinominare le licenze in modo da indicare esplicitamente versione enumero di serie – questa tattica consentirà eventualmente di memorizzare nella stessa cartella licenze diverse anche se omonime;
3. Spostarsi nella cartella di installazione di Extend™, p.e. cd /opt/microfocus/acucbl925;
4. Spostarsi nella sottocartella bin;
5. Creare i link simbolici ai files di licenza rilevanti con comandi del tipo ln -s /siscoxs/alc/runcbl.alc runcbl.alc (assumendo che /siscoxs/alc sia la cartella dove li abbiamo memorizzati)

  ln -s /siscoxs/alc/runcbl-mLINUX32-v900-u10-s224511.alc runcbl.alc

La procedura fin qui è sufficiente per l'attivazione dei prodotti più semplici (runtime, compilatore, …).

La corretta configurazione del runtime, ad esempio, può a questo punto essere verificata digitando da qualsiasi posizione il comando:

/opt/microfocus/acucbl925/runcbl -vv

che, se eseguito correttamente, deve mostrare le informazioni del prodotto incluse il numero di versione e il numero di serie rilevato dai files di licenza.

Altri moduli di Extend™ richiedono ulteriori passi di configurazione per poter essere utilizzati, e sono descritti separatamente:

• Configurazione di AcuRCL (server per thin-client AcuCobol)
• Configurazione di AcuXDBC (driver ODBC per accedere ai files VISION utilizzati da AcuCobol).

La configurazione delle procedure XS per l'utilizzo di Extend™ appena installato è descritta separatamente.