Installazione, aggiornamento, rinnovo, esecuzione

Installazione

Di seguito viene illustrato un esempio completo di installazione passo per passo della versione a 64 bit di pTabs2 per Windows. [1]

Attenzione

Non è possibile installare la versione a 64 bit in un computer a 32 bit o in un computer in cui è stato installata una versione di Windows a 32 bit.

E’ possibile scegliere qualsiasi cartella di installazione, ma è necessario attenersi a queste regole:

  • non installare pTabs2 direttamente nella radice di un disco
  • non utilizzare un percorso che comprenda degli spazi nei nomi di cartelle
  • non installare all’interno di Program Files o Program Files (x86)

Nell’esempio pTabs2 viene installato nella cartella C:\stat\pTabs2 (lo stesso percorso proposto dal programma di installazione).

1) pTabs2

Scaricare dal link fornito il programma di installazione pTabs2_setup-x64.#.#.#.#.exe ed eseguirlo. Attenzione: non scaricare l’eseguibile di installazione all’interno della cartella in cui si vuole installarlo.

  • Indicare come cartella d’installazione C:\stat\pTabs2
  • Mettere la spunta ad Aggiunge la cartella dell’applicazione al path di sistema (è necessario solo la prima volta che si installa pTabs2)
  • Proseguire fino alla fine dell’installazione

Oltre alla cartella di installazione verrà creata la cartella pTabs2-user sotto la cartella genitore della cartella d’installazione, quindi nel caso del nostro esempio: C:\stat\pTabs2-user. La cartella pTabs2-user conterrà una serie di file che l’utente potrà utilizzare per personalizzare pTabs2.

2) Attivazione

  1. Eseguire il file getinfo.bat presente nella cartella di installazione di pTabs2. Verrà creato il file info.dat da inviare allo sviluppatore per la generazione del file di licenza.
  2. In seguito, copiare il file di licenza fornito nella cartella in cui risiede la cartella di installazione di pTabs2 (per esempio C:\stat\) rinominandolo come ptabs2.lic.

3) Verifica dell’installazione

Per verificare la corretta installazione di pTabs2, posizionarsi nella cartella C:\stat\ptabs2\check_install ed eseguire il batch file run.bat.

Controllare che non compaiano messaggi di errore e verificare che siano stati prodotti i vari output.

Il file LEGGIMI.TXT contiene l’elenco dei file che devono essere generati dal test.

4) Problemi ed ulteriori elementi

Attenzione

In caso di errori o problemi, consultare la sezione Risoluzione dei problemi

4.1) SciTe_HOME

Il programma di installazione cerca di impostare la variabile d’ambiente SciTE_HOME. [2] In alcuni casi il processo non va a buon fine. In tal caso potrebbero verficarsi i sequenti problemi:

  • la sintassi non viene colorata
  • il font della sintassi non è corretto, i caratteri non sono allineati
  • il tasto F5 non è associato all’esecuzione dello script

Come dovrebbe apparire (cliccare l’immagine per ingrandire):

_images/scite.png


Verificare pertanto l’esistenza della variabile SciTe_HOME nelle variabili di ambiente. Se non presente, inserirla. La variabile deve puntare alla cartella pSciTE all’interno del percorso di installazione di pTabs2, quindi nel caso dell’esempio: C:\stat\pTabs2\pSciTE.

Suggerimento

Si può accedere alle variabili d’ambiente tramite il Pannello di controllo ‣ Sistema ‣ Informazioni sul sistema ‣ Informazioni di sistema ‣ Impostazioni di sistema avanzate ‣ Variabili d’ambiente. Vedi ulteriori istruzioni nella sezione relativa a SciTE in Risoluzione dei problemi

4.2) wkhtmltopdf

SOLO se si desidera salvare i report in formato PDF è necessario installare anche wkhtmltopdf (http://wkhtmltopdf.org/downloads.html).

  • Scaricare da http://wkhtmltopdf.org/downloads.html il programma di installazione wkhtmltox-x.xx.x-installer.exe (versione 0.12.3.2)

  • Eseguire il programma di installazione

  • Confermare il percorso di installazione suggerito

  • Se si è installato wkhtmltopdf in un percorso diverso da quello standard o se comunque pTabs2 non riesce a trovare wkhtmltopdf, aggiungere al file C:\stat\ptabs2-user\ptabs.yml la seguente riga, dove al posto di M:/y/path/to/wkhtmltopdf/ bisogna indicare il percorso in cui è installato l’eseguibile wkhtmltopdf.exe.:

    :wkhtmltopdf: M:/y/path/to/wkhtmltopdf/wkhtmltopdf.exe

4.3) R

SOLO per l’esecuzione delle procedure del modulo stats è necessario installare il software statistico R.

Aggiornamento

1) pTabs2

  • Scaricare dal link fornito il programma di installazione pTabs2_setup-x64.#.#.#.#.exe ed eseguirlo

Suggerimento

Prima di installare una nuova versione di pTabs2 è possibile rinominare la cartella pTabs2 in modo da conservare la precedente installazione ed eventualmente riattivarla semplicemente scambiando i nomi delle cartelle.

Rinnovo

Rinnovo della validità della licenza:

  • rinominare il file di licenza ricevuto con il nome di ptabs2.lic
  • copiare il file ptabs2.lic nella stessa cartella in cui risiede la cartella di intallazione di pTabs2 (per esempio C:\stat\) sovrascivendo il file preesistente

Patch

In alcuni casi vengono rilasciate delle patch per correggere alcuni problemi presenti in una versione.

Le patch sono archiviate per numero di versione nella sottocartella patch rispetto alla cartella degli eseguibili di installazione.

Le patch vanno copiate nella cartella patch della propria installazione; verranno rimosse da una successiva installazione di pTabs2. Utilizzare solo le path specifiche di una versione.

Esecuzione

Con l’editor SciTE

L’installazione di pTabs2 include una versione di SciTE configurata per creare, modificare ed eseguire gli script di pTabs2.

_images/pSciTE2.png


Include:

  • evidenziazione della sintassi
  • abbreviazioni
  • code folding
  • evidenziazione parentesi
  • esecuzione dello script (F5) e cattura dell’output
  • help (F1)
  • suggerimenti per la sintassi (calltips)
  • menu con funzionalità aggiuntive

I più importanti hotkeys e funzioni disponibili nell’editor SciTE sono elencati qui: SciTE.

Da linea di comando

pTabs2 può anche essere eseguito da linea di comando passando il nome dello script come parametro:

C:\my\folder>ptabs2 script_name

Esecuzione automatica

Utilizzando nel nome dello script l’estensione pt2x, con un doppio click lo script viene eseguito automaticamente.

Note

[1]

Gli utenti della prima versione di pTabs, devono installare questa nuova versione (pTabs2) sullo stesso computer in cui è stato installato pTabs. Per installare pTabs2 su un computer diverso da quello associato alla licenza di pTabs, è necessario una nuova licenza.

E’ possibile installare pTabs2 sullo stesso computer dove è installata la prima versione di pTabs. Entrambe e versioni saranno utilizzabili senza interferire l’una con l’altra.
[2]

Se sul computer è già installato pTabs (la versione precedente di pTabs2), la variabile SciTE_HOME non viene sovrascritta e bisogna pertanto provvedere a modificarla manualmente in modo che punti nella sottocartella pSciTE all’interno del percorso di installazione di pTabs2.

La nuova versione di SciTE contiene anche la configurazione per la prima versione di pTabs, quindi può essere usata indifferentemente con pTabs e con pTabs2.