File: INSTALL.it

package info (click to toggle)
http-analyze 2.4-2.1
  • links: PTS
  • area: non-free
  • in suites: woody
  • size: 3,344 kB
  • ctags: 924
  • sloc: ansic: 11,678; perl: 241; sh: 215; makefile: 214
file content (598 lines) | stat: -rw-r--r-- 25,804 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
http-analyze 2.4 - Analizzatore del file log dei servers web
============================================================

ISTRUZIONI INSTALLAZIONE PER SISTEMI UNIX
------------------------------------------

Ultimo aggiornamento: 19/5/1999
Traduzione Italiana Roberto Pagoria <robpag@nube.com>

http-analyze e` disponibile in formato binario e in sorgente.
Per installare entrambi i formati e` necessario seguire i seguenti steps:

	1.  Decomprimere i files dal software.
	2.  Acquisire il pacchetto software GD e creare i files binari dai
	    sorgenti GD e http-analyze (quest`ultimo solo nel caso di utilizzo 
	    di DISTRIBUZIONE SORGENTE).
	3.  Lanciare l`analizzatore per un primo test.
	4.  Installare il programma con i relativi files di supporto.
	5.  Opzionalmente installare i cataloghi multi-lingue.
	6.  Creare un file di configurazione per il vostro server.
	7.  Registrare il vostro analizzatore ed attivare il software.


Tutti questi steps sono decritti in grande dettaglio qui sotto. Ulteriori 
informazioni relative alla configurazione, uso e interpretazione dei risultati 
sono disponibili su altri files di aiuto in HTML

Come sempre vi invitiamo a testare il software prima di installarlo sul vostro 
sistema. Seguite le istruzioni qui sotto per effettuare un veloce test dopo
aver installato il programma.


------------------------------------------
STEP 1: DECOMPRIMERE I FILES DALL`ARCHIVIO
------------------------------------------

DISTRIBUZIONE FORMATO BINARIO:
-----------------------------
Il file distribuito in formato binario e` compresso secondo il sistema 
gzip'/archivio TAR.  Per decomprimere i files portatevi nella directory
dove volete installarli ed eseguite questo comando:

    gzip -dc http-analyze2.4-solaris.tar.gz | tar xvof -

Questo creera` una directory chiamata http-analyze2.4 con tutti i files 
raggruppati in alcune sub-directories.  Per una loro descrizione guardate
il file `FILELIST' (in inglese).

Passate quindi allo step 4 (DISTRIBUZIONE BINARIA).


DISTRIBUZIONE SORGENTE:
-----------------------
Il file distribuito in sorgente e` compresso secondo il sistema
gzip'/archivio TAR. Per decomprimere i files , portatevi sulla directory
dove volte installarli e date i seguenti comandi:

    gzip -dc http-analyze2.4-src.tar.gz | tar xvof -

Questo creera` una directory chiamata http-analyze2.4 con tutti i files 
raggruppati in alcune sub-directories.  Per una loro descrizione guardate
il file `FILELIST' (in inglese).

Per compilare http-analyze sul vostro sistema avrete bisogno dell`ultima
versione della libreria GD (di Thomas Boutell) per una creazione veloce dei 
files GIF. Se non ne siete in possesso potete effettuare il download da:

	http://www.boutell.com/gd/

Passate quindi allo step 2.


-----------------------------------------------------------
STEP 2: GENERATE L`ESEGUIBILE (SOLO DISTRIBUZIONE SORGENTE)
-----------------------------------------------------------

Per compilare http-analyze, portatevi nella directory "http-analyze2.4"
(oppure nella sub-directory "src"), editate quindi il file Makefile definendo 
le seguenti macros. Lanciate quindi il comando "make". Le specifiche relative
al valore delle macros sono:

    Make macro	Default

    REQLIBS	-L /usr/local/lib -lgd -lpng -lz
		e` il nome della path (pathname) della libreria GD 
		necessaria per creare immagini velocemente.

    REQINCS	/usr/local/include
		e` il nome della path (pathname) della directory che 
		contiene i files GD.

    DEFINES	le specifiche relative al sistema operativo per compilare
		il programma. Le configurazioni previste sono sono 
		possibili per diverse piattaforme, come IRIX, SUN, AIX, 
		DEC, HPUX, Linux, SCO, BSD, SVR4, SVR3. Vedere le 
		definizioni nel Makefile.

    PLATFORM  ulteriori opzioni relative alla piattaforma di 
		compilazione ad esempio	(-ansi o -xansi). Vedere 
		definizioni nel Makefile (in lingua inglese).

    HA_LIBDIR	/usr/local/lib/http-analyze
		la directory dove sono installati i relativi files di 
		supporto come i bottoni e i loghi.
    		Per la loro installazione vedere lo step 4.

    HA_BINDIR	/usr/local/bin
		la directory di installazione di http-analyze binario.

    HA_MANDIR	/usr/local/man/cat1
		la directory per le pagine man (manpage) di http-analyze.


Se si desidera installare il supporto multi-lingua, riferirsi al file
`config.h' e leggere le istruzioni allo step 5 qui sotto, questo prima
di compilare il sorgente. http-analyze supporta X/Open MNLS, System V
MNLS ed una propria implementazione per sistemi senza support MNLS.
Guardare le macros USE_XPGCAT (default), USE_SVR4CAT ed USE_MYCAT.

Successivamente, lanciare il comando `make'. La complilazione di 
http-analyze dovrebbe avvenire senza errori. Da notare che http-analyze 
e` stato portato con successo su tante piattaforme senza necessita` di 
modifiche ai files sorgenti. Vedere il file `lint.out' per alcune 
avvertenze.

Se si desidera procedere passo passo, cosi` come descritto sopra, 
digitate i comandi in questo modo:

    $ cd http-analyze2.4
    $ make DEFINES="-DIRIX" PLATFORM="-xansi" \
    >      REQINCS=/usr/local/include REQLIBS=-L /usr/local/lib -lgd -lpng -lz
      (cd src; make \
        CC=cc DEFINES="-DIRIX" PLATFORM="-xansi" \
        EXTRA_LIBS="" HA_LIBDIR="/usr/local/lib/http-analyze" \
        REQINCS="/usr/local/include" REQLIBS="-L /usr/local/lib -lgd -lpng -lz")
      cc -O -xansi -DIRIX -c http-analyze.c
      cc -O -xansi -DIRIX -c -I/usr/local/include images.c
      cc -O -xansi -DIRIX -c cntrycode.c
      cc -O -xansi -DIRIX -c utils.c
      cc -O -xansi -DIRIX -c vrml.c
      cc -o http-analyze http-analyze.o images.o cntrycode.o utils.o vrml.o 
	-L /usr/local/lib -lgd -lpng -lz
    $

Normalmente e` sufficiente definire le macros REQLIBS/REQINCS e 
selezionare il proprio sistema operativo nella macro DEFINES. 
Se il vostro ambiente C manca di una o piu` funzioni usate 
da http-analyze oppure se volete generare una versione 
particolare del programma e` possibile intervenire sul file 
`config.h', che contiene tutte le definizioni richieste dalle
piattaforme selezionate.

Nel caso dovessero mancare alcune funzioni vedere il file `config.h' 
ed anche per eventuali personalizzazioni. Esistono delle funzioni
sostitutive a quelle mancanti su certi sistemi operativi e che 
possono essere attivate definendo le appropriate macros nel 
`config.h'. Comunque, se si dispone dell`ambiente ANSI-C , cio` non 
dovrebbe essere necessario.

Procedere con lo step 3 o lo step 4.


-------------------------------
STEP 3: TESTARE L` ANALIZZATORE
-------------------------------

Per provare l`analizzatore, creare una directory per i report 
statistici (ad esempio `testd') e lanciate l`analizzatore sul file 
log del vostro server o su alcuni esempi di file log contenuti nella 
sub-directory `files'. Da notare che non c`e` necessita` di installare 
i necessari files di supporto nella directory di output della 
statistica cosi` come richiesto dalla versione precedente di http-analyze.

Nell`esempio seguente viene usato un semplice file log `files/logfmt.elf' 
incluso nella distribuzione. In questo modo, per un test veloce, e` 
possibile digitare esattamente questi comandi sul vostro sistema . La 
slash `./' davanti alla stringa dei comandi assicura che eseguite il 
nuovo file binario, non uno vecchio magari in un`altra directory 
utilizzata dalla path della vostra shell. In questo esempio tutto e` in 
lingua inglese in quanto non si utilizza ancora il catalogo italiano multi-
lingua:

    $ cd http-analyze2.4/src
    $ mkdir testd
    $ ./http-analyze -v3f -o testd ../files/logfmt.elf
    http-analyze 2.4 (IP22; IRIX 6.2), Copyright 1999 by RENT-A-GURU(TM)
    Generating full statistics in output directory `testd'
    Reading data from `../files/logfmt.elf'
    Best blocksize for I/O is set to 64 KB
    Hmm, looks like Extended Logfile Format (ELF)
    Start new period at 01/Jan/1999
    NOTE: output files will be created in subdirectory `www1999'
    Creating VRML model for January 1999
    Creating full statistics for January 1999
    [...]
    $


Lanciate quindi il vostro browser e puntate alla pagina principale del
report statistico contenuta nel file `testd/index.html'.


-------------------------------
STEP 4: INSTALLARE IL PROGRAMMA
-------------------------------

Tutti i files di supporto dovrebbero essere installati nella directory centrale
HA_LIBDIR, che di default e` /usr/local/lib/http-analyze. Il binario e` 
installato in HA_BINDIR, mentre le pagine man vanno su HA_MANDIR.

Se si desidera cambiare queste directories - perche` magari non si hanno 
i pieni permessi di scrittura per queste partizioni del server - cambiate le
seguenti macros nel Makefile prima di procedere alla compilazione del software
(DISTRIBUZIONE SORGENTE) oppure definite le variabili d`ambiente (environment 
variables) con gli stessi nomi usati nello shell script makeinstall 
(DISTRIBUZIONE BINARIA):

    HA_BINDIR	/usr/local/bin
		la directory di installazione di http-analyze binario.

    HA_LIBDIR	/usr/local/lib/http-analyze
		la directory dove sono installati i relativi files di supporto 
		come i bottoni e i loghi.

    HA_MANDIR	/usr/local/man/cat1
		la directory per le pagine man (manpage) di http-analyze.

    EXTENSION	1
		l`estensione delle pagine man (manpage): `1' per text 
		pre-formattato ASCII oppure `man' per il formato sorgente nroff.

    COMPRESS	(no default)
		questa e` l`utility da usare per la compressione delle pagine
		man (manpage).


DISTRIBUZIONE SORGENTE:
-----------------------
Portatevi nella directory "http-analyze2.4", definite le macros di cui sopra
o editando il Makefile oppure attraverso i comandi passo passo come descritto 
sopra. Installate il binario ed i files di supporto necessari digitando 
"make install".
Il programma si portera` sulle directories "src", "man" e "msgcat" ed eseguira` 
il "make install" li`. Una eventuale versione vecchia di http-analyze binario
e le sue librerie saranno salvate aggiungendo il suffisso`.O' al nome dei loro 
files:

    # cd http-analyze2.4
    # make install HA_BINDIR=/usr/local/bin \
    >              HA_LIBDIR=/usr/local/lib/http-analyze \
    >              HA_MANDIR=/usr/local/man/cat1 COMPRESS="compress -f"
    Installing http-analyze in /usr/local/bin
    Installing buttons and files in /usr/local/lib/http-analyze
    Installing http-analyze.1 in /usr/local/man/cat1
    [...]
    Installation completed.

    Please see following new options in the documentation:

    http-analyze -B [-v] [-o outdir]                to create buttons in outdir
    http-analyze -i new_cfg [-v] [-c cfgfile]       to create a new config file
    http-analyze -r company regID [free|comm]       to register your copy
    #


DISTRIBUZIONE FORMATO BINARIO:
------------------------------
Portatevi nella directory "http-analyze2.4" ed installate il binario, i
files di supporto necessari e le pagine man (manpage) digitando "makeinstall".
Verranno mostrati tutti i files binario disponibili per l`installazione. 
Il piu` delle volte si tratta di un solo file per la maggior parte delle
piattaforme, ma e` anche disponibile una distribuzione multi-piattaforma 
con diversi files binario per ambienti misti.

Rispondete alle domande del "makeinstall". nella maggioranza dei casi, i 
settaggi di default suggeriti dovrebbero essere o.k. ameno che non possiate
operare come root. In questo caso, scegliete alcune directories dove avete i 
permessi per scrivere e cambiare agli attributi dei files. Modificate 
eventualmente le variabili d`ambiente di HA_LIBDIR:

    # ./makeinstall
    HTTP-ANALYZE BINARY INSTALLATION
    --------------------------------

    This script will install http-analyze from a binary distribution.
    Please answer the few question for customization of the places
    where the files will be installed. Where appropriate, use the
    default values.
    	(TRADUZIONE IN ITALIANO)     
    	Questo script installera' http-analyze da una distribuzione di tipo
	binario. Per favore rispondete a queste poche domande per stabilire
	dove i files verranno installati. Ove possibibile, usate i valori di
	default.	

    Binaries are available for the following platforms:
	(TRADUZIONE IN ITALIANO) I files binario son disponibili 
	per queste piattaforme:

            Suffix          Platform
            -------------------------------------
            irix            SGI IRIX 5.X/6.X
            irixN32         SGI IRIX 6.X (n32)
            solaris         Sun Solaris 5.5.1
	    [...]
            -------------------------------------

    Your system appears to be an IP22 running IRIX 6.2.
    The recommended binary for this platform is 'irix'.
    You can also choose the 'irixN32' version if the
    N32 libraries have been installed on your system.
	(TRADUZIONE IN ITALIANO) Il vostro sistema sembra essere un IP22 con
	IRIX 6.2 Il file binario raccomandato per questa piattaforma e` 'irix'.
	Potete anche scegliere la versione 'irixN32' se le librerie N32 sono
	installate sul vostro sistema

    Please specify the binary to install: [irix] irixN32
	(TRADUZIONE IN ITALIANO) Specificate il tipo di binario da installare:

    Now specify the various places to install the files in.
	(TRADUZIONE IN ITALIANO) Adesso specificate dove installarli

    Name of installation base directory: [/usr/local] <RET>
    Name of HA_BINDIR (for the executable): [/usr/local/bin] <RET>
    Name of HA_LIBDIR (for the buttons): [/usr/local/lib/http-analyze] <RET>
    Name of HA_MANDIR (for the manpage): [/usr/local/man/cat1] <RET>
    Type of manpage (p)re-formatted or (s)ource: [pre-formatted] <RET>
	(TRADUZIONE IN ITALIANO)
	Nome della directory base di installazione:
	Nome della HA_BINDIR (per l`eseguibile)
	Nome della HA_LIBDIR (per i bottoni grafici)
	Nome della HA_MANDIR (per le pagine man (man manpage))
	Tipo di pagine man (p)re-formattato o (s)orgente

    This are the current configuration settings:
	(TRADUZIONE IN ITALIANO) Ecco i settaggi scelti
    Selected platform:      SGI IRIX 6.X (n32) (http-analyze.irixN32)
    Name of the executable: /usr/local/bin/http-analyze
    Name of the libdir:     /usr/local/lib/http-analyze
    Name of the manpage:    /usr/local/man/cat1/http-analyze.1
    XPG4 MNLS support:      the system's locale (/usr/lib/locale)
	(TRADUZIONE IN ITALIANO)
	Nome dell`eseguibile
	Nome della libdir
	Nome della pagina man
	XPG4 MNLS (Multi-National-Language-Support)

    (C)hange settings, (i)nstall the software or (q)uit? [install] <RET>
	(TRADUZIONE IN ITALIANO)
	(C)ambia settaggi, (i)nstalla il software o (q)uit
    
    Creating directories, saving old version
    Installing the http-analyze binary in /usr/local/bin
    Installing buttons and files in /usr/local/lib/http-analyze
    Installing the manpage in /usr/local/man/cat1
    Installing XPG4 MNLS support in the system's locale (/usr/lib/locale)
	(TRADUZIONE IN ITALIANO)
	Creo le directories, salvo la vecchia versione 
	Installo il binario di http-analyze in 
	Installo bottoni e files grafici in 
	Installo le pagine man (manpage) in
	Installo il supporto XPG4 MNLS in

    Installation completed.
	(TRADUZIONE IN ITALIANO)
	Installazione completata.

    Please see following new options in the documentation:

    http-analyze -B [-v] [-o outdir]             to create buttons in outdir
    http-analyze -i new_cfg [-v] [-c cfgfile]    to create a new config file
    http-analyze -r company regID [free|comm]    to register your copy
    # 
	(TRADUZIONE IN ITALIANO)
	Nuove opzioni disponibili (vedi documentazione)

    http-analyze -B [-v] [-o outdir]             per creare i bottoni in outdir
    http-analyze -i new_cfg [-v] [-c cfgfile]    per creare un nuovo file di 	
								 configurazione
    http-analyze -r company regID [free|comm]    per registrare la vostra copia
	


Da notare: Una volta che l`analizzatore e` installato, i files e i bottoni 
verranno copiati automaticamente sulla directory di output della statistica
nel caso questi non esistano o nel caso dovessero essere di una versione
precedente. Lo script di aiuto `ha-setup' usato nelle versioni precedenti,
non e` piu` necessario, tutto adesso e` integrato in http-analyze.


---------------------------------------------------------------
STEP 5: MULTI-NATIONAL LANGUAGE SUPPORT - SUPPORTO MULTI-LINGUE 
---------------------------------------------------------------

Se non si vuole utilizzare il supporto multi-lingue, passare allo step 6.

http-analyze supporta X/Open e SVR4 multi-national language support
(MNLS) sui sistemi Unix.

Mentre il metodo MNLS (USE_XPGCAT, USE_SVR4CAT o USE_MYCAT) deve essere 
specificato prima della compilazione di http-analyze nel suo Makefile,
il catalogo dei messaggi che contiene tutte le stringhe tradotte, e` 
indipendente dai files sorgenti. Cio` significa che se piu` linguaggi
diventano disponibili, l`analizzatore non deve essere ricompilato.
La sola azione richiesta per aggiungere una nuova lingua, e` quella di
installare l`apposito catalogo.

La sub-directory `msgcat' contiene tutti i files sorgenti dei messaggi
e il Makefile per la compilazione e l`installazione dei cataloghi.

L` X/Open MNLS e` il metodo preferito per il supporto multi-lingua.  
I files sorgenti dei messaggi sono sempre creati con il formato X/Open.
Lo shell script `gen-msgcat' e` usato per creare il formato SVR4 sia nel
caso che sia usato il methodo SVR4 o il metodo interno (built-in).

Per installare i cataloghi dei messaggi, digitare uno dei seguenti comandi
a seconda del metodo che avete selezionato. L`esempio qui sotto installa
i cataloghi dei messaggi in Inglese (en), Tedesco (de) e Russo (ru):

    o X/Open MNLS (se USE_XPGCAT e` stato definito nello step 2):

	# make xpgcat
	 gencat /usr/lib/locale/en/LC_MESSAGES/http-analyze ha-en.str
	 gencat /usr/lib/locale/de/LC_MESSAGES/http-analyze ha-de.str
	 gencat /usr/lib/locale/ru/LC_MESSAGES/http-analyze ha-ru.str
	#

	Per richiedere l`uso di una certa lingua quando lanciate http-analyze, 
	usate le variabili d`ambiente `LANG' oppure `LC_MESSAGES' oppure
	l`opzione `-L lang'. Vedere setlocale(3C) per informazioni su come
	usarlo e catopen(3C), catgets(3C), catclose(3C) e nl_types(5) per
	ulteriori informazioni su X/Open MNLS.


    o SVR4 MNLS (se USE_SVR4CAT e` stato definito nello step 2):

	# make svr4cat
	 ./gen-msgcat ha-en.str >ha-en.cat
	 ./gen-msgcat ha-de.str >ha-de.cat
	 ./gen-msgcat ha-ru.str >ha-ru.cat
	 mkmsgs -o -i en ha-en.cat http-analyze
	 mkmsgs -o -i de ha-de.cat http-analyze
	 mkmsgs -o -i ru ha-ru.cat http-analyze
	#

	Per richiedere l`uso di una certa lingua quando lanciate http-analyze, 
	usate le variabili d`ambiente `LANG' oppure `LC_MESSAGES' oppure
	l`opzione `-L lang'. Vedere setlocale(3C) per informazioni su come
	usarlo e gettxt(3C) per ulteriori informazioni su SVR4 MNLS.


    o Built-in MNLS (se USE_MYCAT e` stato definito nello step 2):

	# make mycat HA_LIBDIR=/usr/local/lib/http-analyze
         ./gen-msgcat ha-en.str >ha-en.cat
         ./gen-msgcat ha-de.str >ha-de.cat
         ./gen-msgcat ha-ru.str >ha-ru.cat
         mkdir /usr/local/lib/http-analyze/msgcat
         cp ha-en.cat ha-de.cat ha-ru.cat /usr/local/lib/http-analyze/msgcat
	#

	Con il MNLS built-in (o "nativo") i cataloghi dei messaggi
	sono installati nella directory HA_LIBDIR/msgcat, assicuratevi di
	specificare il valore corretto della macro per HA_LIBDIR anche qui
	se questo fosse stato cambiato durante la compilazione di http-analyze 
	allo step 2.  

HA_LIBDIR e` di default `/usr/local/lib/http-analyze' e puo` essere cambiato 
durante run-time con la variabile d`ambiente HA_LIBDIR. Il formato usato per il 
catalogo dei messaggi nativo e` lo stesso di quello in SVR4 MNLS. E` possibile 
usare la  variabile d`ambiente HA_LANG oppure l`opzione `-L lang' per ottenere 
la lingua desiderata quando si lancia http-analyze.
	

-------------------------------------------------------------------------------
STEP 6: CREARE UN FILE DI CONFIGURAZIONE DELL`ANALIZZATORE PER IL VOSTRO SERVER
-------------------------------------------------------------------------------

Dopo aver installato l`analizzatore e` possibile creare un file di 
configurazione per il vostro web server.  http-analyze 2.4 dispone di alcune 
nuove opzioni per creare un file di configurazione in modo da inizializzare la 
directory di output. Nelle versioni precedenti cio` era possibile con l`uso 
dello script `ha-setup' diventato ora obsoleto.

La descrizione che segue spiega come usare queste nuove opzioni:
 
  CREARE UN NUOVO FILE DI CONFIGURAZIONE
  --------------------------------------
  Per creare un nuovo file di configurazione per un server virtuale o per un 
server fisico, usare le opzioni `-i newcfg', dove newcfg e` il nome del file 
config (normalmente `analyze.conf', ma e` possibile scegliere un qualsiasi 
nome):

    $ http-analyze -i analyze.conf

  Questo crea il file `analyze.conf', che contiene i setting di default
  di tutte le direttive, ad eccezione di ServerName (nome del server), che
  deve essere digitato manualmente usando un normale editor di testo ASCII.


  AGGIORNARE UN VECCHIO FILE DI CONFIGURAZIONE
  --------------------------------------------
  Se si dispone gia` di un file di configurazione e lo si vuole convertire nel 
  nuovo formato, aggiungete al comando semplicemente il nome del vecchio file 
  config.
  Da notare che benche` il nome del nuovo file config puo` essere lo stesso del 
  vecchio file,  si raccomanda di usare un diverso nome in modo a poter 
  velocemente localizzare le nuove direttive di configurazione confrontando
  entrambi i files. Allo scopo si puo, usare `diff(1)', oppure un`altre simile 
  utility.
  Il comando per aggiornare un vecchio file config e`:

    $ http-analyze -c analyze.conf -i analyze.conf.N

  Quindi, rivedete i setting di config in `analyze.conf.N', opzionalmente 
  aggiungete altre vostre nuove direttive ed attivate il nuovo file salvandolo 
  con il nome del vecchio file config dopo aver rinominato quest`ultimo:

    $ mv analyze.conf analyze.conf.O
    $ mv analyze.conf.N analyze.conf


  INSTALLARE I B0TTONI SENZA LANCIARE IL PROGRAMMA
  ------------------------------------------------
  Per utilizzare il software non e` piu` necessario installare i files grafici
  ed i bottoni di supporto come nella precedente versione. Se installato
  correttamente, http-analyze creeera` questi files automaticamente al momento
  in cui viene lanciato per la prima volta. Comunque, se per qualche ragione si
  voglio installare questi files senza creare la directory di output della
  statistica, e` possibile farlo digitando:

    $ mkdir testd
    $ http-analyze -vB -o testd
    http-analyze 2.4 (IP22; IRIX 6.2; XPG4 MNLS)
    Copyright 1999 by RENT-A-GURU(TM)
    All buttons and files have been installed
    $

  La directory di output deve gia` esistere


  PREPARATE UN REPORT RELATIVO AD UN BUCO - FILING A BUGREPORT
  ------------------------------------------------------------
  Per inviare un report relativo ad un buco del programma, usate l`opzione
  `-X', che  fa creare ad http-analyze una URL che punta su un nostro modello 
  realizzato appositamente  per questo scopo. Il vantaggio di questo sistema e` 
  che troverete tutte le informazioni relative ai vostri dati (ID, cliente,
  nome e altro) gia` pronte nel modello. Con il browser richiamate quindi
  questa URL (command substitution), nei sistemi Unix:

    $ netscape `http-analyze -X`

  Questo passera` la URL al Netscape Communicator. Nel caso di altri sistemi
  senza command substitution, usare taglia & incolla per passare la URL creata
  da `http-analyze -X' sul 'location' del vostro browser.


--------------------------------------------------------------------------
STEP 7: REGISTRATE LA VOSTRA COPIA DI HTTP-ANALYZE ED ATTIVATE IL SOFTWARE
--------------------------------------------------------------------------

http-analyze e` disponibile per uso personale gratuito (free) e per uso
commerciale. Solamente gli utenti di della versione commerciale riceveranno 
supporto tecnico, assistenza e aggiornamenti del programma. Entrambi le licenze 
richiedono la registrazione.

Dopa la registrazione sia della Licenza Personale (free) o del Servizio
di Licenza Commerciale, riceverete, via email, un identificativo di 
registrazione (registration ID) e due immagini di registrazione. 
Prendete le immagini dalla vostra email. I nomi dei due files sono
`free-netstore_sb.gif' e `free-netstore_sw.gif' per la  Licenza Personale
e `comm-netstore_sb.gif' e `comm-netstore_sw.gif' per il Servizio di 
Licenza Commerciale.

L`identificativo di registrazione (registration ID) deve essere salvato in 
un file da nominare `REGID' sotto HA_LIBDIR e i bottoni devono essere inseriti
nella sub-directory `HA_LIBDIR/btn'. Tutto questo puo` essere fatto 
automaticamente da http-analyze, semplicemente digitate:

    $ http-analyze -r "Customer's Name" RegID

dove `Customers Name' (Nome del Cliente) rappresenta il vostro nome cosi` come
specificato nel modello di registrazione oppure un`abbreviazione del nome
della vostra compagnia, e `RegID' (identificativo di registrazione) il numero
di registrazione.

Per fare in modo che http-analyze installi anche le immagini di registrazione, 
specificate la parola `free' per la  Licenza Personale oppure `comm' per il 
Servizio di Licenza Commerciale, questo come terzo parametro:

    $ http-analyze -r CustomerName RegID free

http-analyze evidenziera` un messaggio di errore se le  immagini di 
registrazione non vengono trovate nella corrente directory. Se questo e` il 
caso, controllate che la loro posizione sul server sia corretta e che le
abbiate rinominate correttamente..

Buon divertimento!