Istruzioni per l'installazione

Con questa versione, sia pur limitata, potete comunicare con un altro PC, ovunque nel mondo, conoscendo il suo indirizzo IP. 

Se non avete mai eseguito nessuna Java application (escluse Applet) sul vostro PC questa potrebbe essere una buona occasione per fare questa interessante esperienza... Installare il Java Runtime Environment (JRE, necessario per eseguire qualsiasi applicazione Java) sul vostro PC sarà un gioco da ragazzi. Ho fatto eseguire l'installazione ad un mio amico avvocato, che le uniche istruzioni che conosce bene sono quelle del suo telefonino, e devo dire che se l'è cavata brillantemente. 
Chi invece lo ha già installato, può passare alla sezione successiva.

N.B. Troverete questa pagina, chiamata "Leggimi.html" sulla directory _info dopo aver unzippato ChatAnt,  e avrete tutto il tempo di leggerla off-line.

Come si installa JRE (in 2 mosse). Spazio richiesto 17 Mb.

    • Scaricare il JRE per Windows 98/2000/XP tramite questo sito cliccando su Download ChatAnt. Potete salvare file denominato "j2re-1_3_1_03-win.exe"  in una directory a piacere.
    • Doppio click su j2re-1_3_1_03-win.exe, accettare i termini imposti (i diritti della Sun) ed installare il tutto sulla directory di default.  Scegliere il drive di installazione, per default viene proposta la directory "C:\Programmi\JavaSoft\Jre\1.3.1_03". Se non volete installare su C: potete cambiare il drive, ma non consiglio di cambiare il path proposto perchè servirà  a far partire l'applicazione ChatAnt. Dare il check sul proprio browser di default quando verrà chiesto, e l'installazione è terminata. 
Se tutto è avvenuto correttamente verranno create le seguenti directories:

Come si installa ChatAnt (in 2 mosse):

    • Scaricare ChatAnt versione Trial da questo sito in una directory a piacere dopo aver digitato il vostro nome ed e-mail.
    • Scompattare ChatAntv2.7.zip scaricato con la funzione "Extract to:" di WinZip (non con il semplice drag&drop !). Estraete il contenuto sul drive dove avete in precedenza installato il JRE (*NON* non su una sottodirectory da voi creata). Penserà WinZip a creare le necessarie sottodirectory. 
      Spazio richiesto 232 Kb (scusate se è troppo poco...) 
Se tutto è Ok, verrà creato il seguente albero di directory:

Come vedete c'è tutto l'occorrente per eseguire sia il server che il client, e per gestire i Forum.
E' presente anche la directory _info che contiene queste istruzioni e può essere tranquillamente cancellata o spostata.

Non frapponiamo più nessun indugio e andiamo senz'altro a provare ChatAnt:

Come si lancia ChatAnt (in 3 mosse):

    • Nel caso abbiate installato JRE e ChatAnt su un drive diverso da C: modificate opportunamente il file start-server.bat ("C:" dovrà essere cambiato con "X:" dove X = vostro drive di installazione) altrimenti lasciate tutto com'è.
    • Doppio click sul file start-server.bat sulla directory "C:\ChatAnt\server" ed aspettate alcuni secondi per l'attivazione del server di ChatAnt: da questo momento siete in grado di accettare connessioni da qualsiasi pc, dovunque collegato in rete! 
       
      (Nel caso di non attivazione automatica della finestra DOS con il doppio click, andate in modalità DOS (start->esegui->"cmd") ed digitate "start-server" dalla directory  "C:\ChatAnt\server").
    • Doppio click sul file start-client.bat sulla directory "C:\ChatAnt\client". Verrà automaticamente aperta una finestra DOS e attivato il Client ovvero la finestra della Chat. Se riceverete il messaggio di benvenuto del server vuol dire l'installazione non ha avuto problemi. 
      Cliccate allora sul pulsante "LOGIN", ben evidenziato in arancione, e datevi un nome d'arte. 
      (Ignorate il campo e-mail, non digitabile, che è stato lasciato appositamente per ricordarmi di implementare anche le funzioni di Posta).
      Ora siete in grado di dialogare... con voi stessi... Provate anche a lanciare 2 volte ChatAnt sul vostro stesso PC.
    • Per uscire cliccare il "x" in alto a destra come qualsiasi altra finestra. Non uscire mai  chiudendo la finestra DOS, chiudere finestra DOS solo dopo essersi scollegati.

N.B. Nella versione Trial è disabilitata la possibilità di utilizzare le Stanze o di crearne delle nuove, ed è possibile dialogare in due persone massimo. 

Dialogare in rete.

    • Stabilite qual'è il vostro IP-Address (con il comando "ipconfig" dalla finestra DOS ).
    • Modificate il file client-config.props sostituendo "localhost" con il vostro indirizzo di rete (es. "156.54.32.112"). Ora il vostro Pc funziona da chat server.
    • Fate copiare tutto il contenuto della directory "ChatAnt\client" ad un vostro amico o fategli scaricare ChatAnt da questo sito e ditegli di modificare il suo file client-config.props come avete fatto voi (in sostanza "localhost" deve essere sostituito con il vostro indirizzo di rete). Anche per lui vale la regola di aver installato prima JRE, ed essere ovviamente collegato in rete. Il vostro interlocutore non avrà bisogno della directory, "server", quindi potrà anche cancellarla.
    • Fategli eseguire start-client.bat. Dovrebbe essere in grado di collagarsi con voi, di dialogare, scambiare files e scrivere sul forum. 

Scambiare file.

La funzione di file-sharing è attivata. Il programma crea una directory per lo scambio di file sul drive da voi scelto per l' installazione di ChatAnt, denominata "MieiFiles". Metteteci i files che desiderate condividere. Una volta entrati in chat sarete in grado di vederli e di scambiarli. 
Se avete apportato delle modifiche sui vostri file da scambiare mentre siete collegati, nessun problema, è stato predisposto il tasto ""RefreshFiles" per spedire la situazione aggiornata a tutti i partecipanti a ChatAnt.
E' possibile, per prova, anche scambiare dei file con se stessi. A tale scopo, in questa versione trial i file vengono rinominati con il prefisso "ant_".

 Il forum.

Sulla directory server\ChatProperties c'è il file Forum.txt che contiene i titoli dei forum ed il rispettivo file .html (a destra del segno "=") che farà da archivio per gli interventi . Potete aprirlo e modificarlo a vostro piacere. 

Per visualizzare il forum, con questa versione, è necessario aver installato un Web-Server sul PC sul quale è attivo il mio chat-server e collegarsi poi a tale PC tramite l'indirizzo IP:[porta]\ChatForum\NomeForum.html oppure eseguire ChatAnt come Applet. Queste operazioni tuttavia, sono un po' più complesse, e richiedono assistenza per l'installazione. (Nella versione 2.8 che metterò in linea, ho comunque risolto l'inconveniente).
Se fate da server potete comunque visualizzazione in forum cliccando direttamente sul file .html presente sulla directory server\ChatForum.


Per coloro che hanno già JRE o J2SK (ambiente di sviluppo Java)

    • Verificate che la versione sia la 1.3 o successiva.
albero di una tipica installazione di J2SDK (Java 2 Standard Edition) da me rinominata jdk1.3.1.

Path del JRE:

Ecco il famoso JRE, di cui si è tanto parlato.  Lì troverete l'ancor più famoso Java.exe che in questa installazione sta in X:\jdk1.3.1\jre\bin. 

    • Verificate che dal Drive dove avete installato la directory ChatAnt sia possibile eseguire il comando "Java". In caso negativo aggiungere il path del vostro Jre alla variabile di ambiente "path" del vostro PC o in alternativa cambiate il comando "java" in "X:\jdk1.3.1\jre\bin\java" (se avete installato il jre1.3.1) sui file start-server.bat  e start-client.bat forniti con l'installazione.
    • Passate ora alle istruzioni su come si installa ChatAnt.

Per qulasiasi problema o segnalazione scrivete a ChatAnt. Sarete al più presto ricontattati.