AWS Perl README Italiano



Traduzione del README AWS tool
ultimo aggiornamento: 17 gen 2012

Questo sono scriupt di esempio mostrano come usare Amazon Email Service
(Amazon SES) dalla linea di comando.
Per approfondire, fare riferimento a Amazon SES Developer Guide

PREREQUISITI
-------------
Prima di eseguire questi scripts, bisogno verificare i seguenti requisiti:

* Devi avere un account Amazon Web Services, e devi inoltre registrarti per l'utilizzo di SES. Vedi Amazon SES Getting Started Guide per ulteriori dettagli
* Devi installare Perl version 5.6.0 o superiore. Puoi verificare la versione di Perl tramite:

perl -v

alla riga di comando. Se non hai Perl installato, procedi seguendo le istruzioni riportate su http://www.perl.org

* A seconda della versione di Perl che stai usando, potresti aver bisogno di installare alcuni moduli Perl aggiuntivi
* Depending on the version of Perl that you are using, you may need to install. Per installare i moduli , eseguire:

perl -MCPAN -e 'install Digest::SHA'
perl -MCPAN -e 'install URI::Escape'
perl -MCPAN -e 'install Mozilla::CA'
perl -MCPAN -e 'install Bundle::LWP'
perl -MCPAN -e 'install LWP::Protocol::https'
perl -MCPAN -e 'install MIME::Base64'
perl -MCPAN -e 'install Crypt::SSLeay'
perl -MCPAN -e 'install XML::LibXML'

[nda: se richiesto, utilizzare il "sudo" prima del comando di installazione]

Prego accertatai di utilizzare l'ultima versione dei moduli sopra elencati. Se vuoi
eseguire l'upgrade di tutti i tuoi modulli Perl installati nel tuo sistema, esegui:


perl -MCPAN -e 'upgrade'

INSTALLAZIONE
------------
Per installare questi scripts, copiali in una directory di tua scelta.. E' consigliato utilizzare la directory:

/opt/third-party/amazon/ses

Potresti aver bisogno dei privilegi amministrativi per eseguire questa operazione,

E' disponibile Aiuto per questi script, semplicemente eseguendoli con il parametro "--help"
Esempio:


ses-get-stats.pl --help
Usage:
ses-get-stats.pl [--help] [-e URL] [-k FILE] [--verbose] -s | -q

Per maggiori informazioni, fai riferimento a Amazon SES Developer Guide.

File della Credenziali di AWS
--------------------
Ognuno di questi script Amazon SES richiede l'autenticazione AWS. Per preparare il tuo file di credenziali
segui le seguenti istruzioni:

* Crea un file di testo/ Nel nostro esempio losaverfemo con il nome "aws-credentials".

* Vai su http://aws.amazon.com e leggi le tue credenziali: Click su
Account, poi Security Credentials.

* Copy i tuoi Access Key ID e Secret Access Key nel file "aws-credentials" .

* Cambia i permessi del file in modo che tu sia il solo ad avere accesso read/write .
(Questo passaggio e' *molto* importante, in quanto nessun altro dovrebbe avere accesso alle tue Credenziali)

* Il tuo file di credenziali dovrebbe essere simile a:
AWSAccessKeyId=022QF06E7MXBSH9DHM02
AWSSecretKey=kWcrlUX5JEDGM/LtmEENI/aVmYvHNif5zB+d9+ct

Puoi ora usare il tuo file di Credenziali AWS con il parametro "-k" per i vari script Amazon SES.
Esempio:

ses-get-stats.pl -k aws-credentials -s

RISOLUZIONE DEI SOLUZIONI COMUNI
---------------

* Command not found:

Questo significa che l'interprete della tua linea di comando (o shell) non trova il file contenente lo script.
Prova ad eseguirlo di nuovo con un fully qualified path name, esempio:

/opt/third-party/amazon/ses/bin/ses-send-email.pl

Se invece ti trovi nella stessa directory degli script puoi esegiurli come da esempio:

./ses-send-email.pl

In alternativa, puoi includere la tua corrente directory di lavoro nella tua variabile PATH, in modo da poter eseguire gli script senza anteporre "./".


* /usr/bin/perl: bad interpreter: No such file or directory:

Per default, questi scripts si cercano il Perl interpreter in
"/usr/bin/perl". Se l'interprete Perl e' installato altrove, o non installato in assoluto, ricevi il messaggio sopra indicato.

Per corregge questo problema, modifica la prima linea dello script, con il percoso all'interprete Perl (esempio, /opt/third-party/bin/perl).
In alterenativa, puoi specificare il percorso da riga di comando:

/opt/third-party/bin/perl ./ses-send-email.pl

* Can't locate SES.pm in @INC:

Ogni script Amazon SES richiede il Modulo Perl "SES.pm". Questo essere significa che Perl non riesce a trovarlo
fra l'elenco delle directory contenenti i moduli Perl.
Per default, gli script Amazon SES cercano lo script nella stessa loro direcroty. Per correggere questo errore abbiamo diverse soluzioni:

1) Prima di eseguire lo script , inpostare la variabile PERL5LIB con la directory contenente il modulo SES.pm. Esempio:
export PERL5LIB=/opt/third-party/amazon/ses

2) Modifica gli scripts in modo che possano trovare il modulo:
use lib '/opt/third-party/amazon/ses';

3) Usa lo switch di riga di comando "-I" per aggiungere il percorso speficifato all'elenco di directory dei moduli Perl:
perl -I/opt/third-p