====== Installazione dei prodotti Extend™ ====== Il primo passo è installare nel sistema il prodotto Extend(tm). La cosa più semplice è installare il pacchetto completo. ==== REQUISITI === 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. === Accesso come amministratore === 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''. === Pacchetto di installazione === Il modulo di installazione dei prodotto Extend(tm) consiste in un archivio in formato [[wpit>Tar_(software)|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(tm) versione 9.2.5 completo occorrerà quindi il file: ''acucob925pmk59sh.tar.gz''. **ATTENZIONE** Per quanto ci è noto, non è possibile -- o per lo meno non banale -- installare nello stesso sistema versioni diverse di Extend(tm) contemporaneamente. Inoltre, per poter utilizzare correttamente funzionalità legate ad altri componenti di sistema //(p.e. AcuXDBC)// è bene installare la versione con lo stesso "numero di bits" del sistema. === Codici di attivazione === Ogni modulo di Extend(tm) 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.// I codici di attivazione sono specifici per versione di Extend(tm) e piattaforma hardware/software. Le licenze sono associate ad un numero di serie nominativo. === Files di licenza === 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. ==== PROCEDURA ==== === Installazione di Extend === - Accedere come utente ''root'' ad un prompt di comandi ("shell"); - Spostarsi nella cartella ''/opt'' e creare (se non già presente) una cartella denominata ''microfocus''; - Spostarsi all'interno di ''/opt/microfocus'' e creare una cartella denominata ''acucbl//VVV//'', dove //VVV// è il numero di versione -- nel nostro caso: ''acucbl925''; - 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''; === Configurazione del sistema === 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: # 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)//. === Configurazione del sistema, parte 2 === 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(tm) ad altri software. Per fare ciò, creare -- o aggiornare se già presente -- il file ''/etc/profile.d/zz-acucobol.sh'' perché contenga: # 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. === Attivazione dei prodotti Extend === == Se si è in possesso dei codici di attivazione == - Spostarsi nella cartella di installazione di Extend(tm), p.e. ''cd /opt/microfocus/acucbl925''; - Spostarsi sotto la sottocartella ''bin''; - Avviare il comando ''./activator'' e seguire le istruzioni -- verranno richiesti i codici **PRODUCT CODE** e **PRODUCT KEY** di ogni modulo che si desidera attivare; == Se invece si è in possesso dei files di licenza già predisposti == - Creare, se non lo si è già fatto in precedenza, una cartella per contenere i files di licenza -- ad esempio ''/siscoxs/alc''; - 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; - Spostarsi nella cartella di installazione di Extend(tm), p.e. ''cd /opt/microfocus/acucbl925''; - Spostarsi nella sottocartella ''bin''; - 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)// //Se si sono utilizzati nomi "specializzati" per i files di licenza, assicurarsi che il link creato abbia il nome corretto, p.e.//\\ ln -s /siscoxs/alc/runcbl-mLINUX32-v900-u10-s224511.alc runcbl.alc === Ulteriori operazioni === 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(tm) 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(tm) appena installato è descritta separatamente.