Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

--- aculinux:install [2016-11-16 00:12] – Modificato schema nome file "parlante" per licenza federico
+++ aculinux:install [2018-04-22 19:55] (versione attuale) – modifica esterna 127.0.0.1
@@ Linea 7: / Linea 7: @@
   * accesso al sistema con operatore ''root'' (amministratore di sistema);
   * pacchetto di installazione appropriato per il proprio sistema;
-  * i files di licenza per le parti del prodotto acquistate.
+  * i codici di attivazione dei moduli di prodotto acquistati, o in alternativa i files di licenza già preparati per gli stessi.
 === Accesso come amministratore ===
@@ Linea 13: / Linea 13: @@
 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 stesso, tale utente dovrà avere permessi equivalenti a ''root''.
+È 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 ===
@@ Linea 27: / Linea 27: @@
 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''.
+<WRAP center round important 80%>
+**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.
+</WRAP>
+=== 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.//
+<WRAP center round important 80%>
+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.
+</WRAP>
 === Files di licenza ===
-Ogni prodotto Extend(tm) necessita di essere attivato tramite un "file di licenza". 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.
+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");
-  - Creare, se non lo si è già fatto in precedenza, una cartella ''/siscoxs'';
-  - Al suo interno creare una sottocartella ''alc''
-  - Nella cartella ''/siscoxs/alc'' 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 ''/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:
+<file - zz-acucobol.conf>
+# Shared libraries for Extend products (v.9.2.5)
+/opt/microfocus/acucbl925/bin
+/opt/microfocus/acucbl925/lib
+</file>
+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:
+<file bash 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
+</file>
+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'';
-  - Creare i link simbolici ai files di licenza con comandi del tipo ''ln -s /siscoxs/alc/runcbl.alc runcbl.alc''
+  - 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)//
 <WRAP center round tip 75%>
 //Se si sono utilizzati nomi "specializzati" per i files di licenza, assicurarsi che il link creato abbia il nome corretto, p.e.//\\
 <code>
-  ln -s /siscoxs/alc/runcbl-LINUX32-900-10u.alc runcbl.alc
+  ln -s /siscoxs/alc/runcbl-mLINUX32-v900-u10-s224511.alc runcbl.alc
 </code>
 </WRAP>
+=== 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:
+<code>
+/opt/microfocus/acucbl925/runcbl -vv
+</code>
+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.