---

Per installare ShopSite sul proprio server UNIX, basta disporre di un Web browser e dell'accesso ftp o telnet al server.

Sommario

I. Prima dell'installazione

II. Pianificazione delle directory ShopSite

III. Esecuzione del programma di installazione

IV. Installazione su un server virtuale

V. Configurazione del Web server

VI. Aggiornamento

VII. Risoluzione di problemi

VIII. Costruzione del negozio virtuale

---

Prima dell'installazione

• Prima di installare ShopSite, verificare che il proprio sistema disponga dei requisiti minimi hardware e software.

• Verificare che il software del proprio Web server e l'autenticazione degli utenti funzionino correttamente. Se il Web server non funziona, non Š possibile installare ShopSite. Se non si dispone di un Web server, si consiglia di usare Apache. Tale Web server Š gratuito. ShopSite funziona con tutti i Web server NCSA compatibili, ad esempio Netscape e Microsoft IIS.

• Se si installa ShopSite Manager o Pro, Š necessario disporre di Perl versione 5.003 o successiva. La versione pi- recente pu• essere scaricata dal sito Web Perl. Per compilare Perl per il proprio server, Š sufficiente premere il tasto "Invio" per accettare tutte le configurazioni di default. Il software Perl Š gratuito.

Pianificazione delle directory ShopSite

Il programma di installazione di ShopSite SC richiede la posizione di cinque directory.

• I file eseguibili sono situati in due directory separate, la "directory ShopSite" e la "directory del carrello della spesa". Entrambe le directory devono disporre di un alias sul server e devono essere accessibili tramite URL.
  ® Si consiglia di posizionare tali directory nella directory cgi-bin del server. Per maggiore sicurezza, configurare il server in modo che dalle directory cgi-bin vengano serviti solo i programmi CGI e non i file di testo o HTML.
• Le immagini utilizzate da tutti i negozi ShopSite vengono archiviate in una directory separata che deve essere accessibile dal Web server. Si consiglia di utilizzare una directory chiamata shopsite-images all'interno della directory principale del Web server.
• E necessario che il negozio virtuale disponga di una directory "dati" per memorizzare i database delle pagine e dei prodotti.
  ® Impostare le autorizzazioni relative alla directory "dati" in modo che sia accessibile dal Web server ma non da un browser. In altri termini, non posizionare la directory "dati" nella directory principale dei documenti del Web server.
• Inoltre, Š necessario che il negozio virtuale disponga di una directory di "output HTML" per memorizzare i file HTML, cioŠ le pagine generate per il negozio stesso. L'alias dell'URL della vetrina deve essere impostato sulla directory di output HTML del negozio virtuale.
  ® Posizionare la directory di output HTML dove sono memorizzati i file HTML esistenti.

  Tenere presente che, poich‚ le immagini di ogni negozio virtuale sono memorizzate nella sottodirectory media della directory di output HTML, pu• essere necessario configurare l'accesso FTP per la directory media.

Pianificare le posizioni delle directory prima di avviare l'installazione. Di seguito viene riportata una struttura delle directory di esempio.

 home

  httpd

      cgi-bin

       ss = directory ShopSite,

               con alias impostato sull'URL CGI di ShopSite, ad esempio

               http://www.xyz.com/cgi-bin/ss

       sc = directory del carrello della spesa,

                 con alias impostato sull'URL CGI del carrello della spesa, ad esempio

                 http://www.xyz.com/cgi-bin/sc

      html

       shopsite-images

       NomeNegozio = directory di output HTML, con alias impostato sull'URL 

                      della vetrina definito nel file store.auth

          Pagine del negozio virtuale

          media - pu• essere necessario l'accesso FTP

              Immagini del negozio virtuale

      dati

          NomeNegozio = directory dati

Esecuzione del programma di installazione

Dopo aver scaricato il programma di installazione compresso, per installare ShopSite Š sufficiente il proprio browser.

1. Se non Š ancora stato fatto, scaricare il file di installazione compresso e il proprio file store.auth nella directory dalla quale si desidera eseguire l'installazione. E necessario che i programmi CGI possano essere eseguiti e possano scrivere in tale directory. Se si utilizza il protocollo FTP per recuperare i file, verificare di usare la modalit... binaria di trasferimento.

2. Decomprimere il file di installazione.

3. Sul Web server, impostare le autorizzazioni relative ai file e alla directory in modo da poter eseguire i programmi wwwinstall.cgi e info.cgi dal Web browser.

4. Con il browser, individuare il file wwwinstall.cgi nella directory di installazione.

5. Nella prima videata, fare clic su Install a Store se questa Š la prima installazione di ShopSite sul server, oppure fare clic su Upgrade se sul sistema Š installata una versione precedente di ShopSite.

6. Nella videata successiva, inserire nei campi i valori richiesti e fare clic su OK. Perch‚ il programma di installazione funzioni, Š necessario compilare tutti i campi.

7. L'installazione di ShopSite ha inizio; vengono visualizzati i risultati dell'installazione. Se necessario, Š possibile correggere i campi desiderati e fare nuovamente clic su OK.

Installazione su un server virtuale

In quasi tutti i server virtuali, i percorsi delle directory visualizzati durante una sessione telnet non sono uguali a quelli visualizzati con un Web browser. Tenere presente questa caratteristica quando si specificano i percorsi usati dal programma di installazione basato sul browser.

• Controllare che nella directory virtuale principale esista una directory tmp, per evitare errori durante l'uso del programma tar.
• Verificare che il Web server disponga dell'accesso all'eseguibile tar.

Problemi di installazione con Iserver (Verio)

• Il Web server non dispone dell'accesso all'eseguibile tar. Copiare il programma tar da /bin/tar a usr/bin/tar, nella propria directory home. Ad esempio:

        cp /bin/tar ~/usr/bin/tar
        chmod ug=rx ~/usr/bin/tar
      

• Al momento di pubblicare il presente file, la versione perl di default su Iserver Š 4.0. Procurarsi la versione 5.004 (o successiva) e copiarla nella directory accessibile al Web server (~/usr/bin/perl5 o simile). Ricordarsi di rendere il file eseguibile ('x'). Ad esempio:

        cp /usr/local/bin/perl5.004 ~/usr/bin/perl5
      

Configurazione del Web server

Configurare il Web server in modo che riconosca le nuove directory.

• Impostare un alias per l'URL ShopSite in modo che indichi la directory ShopSite.
• Impostare un alias per l'URL del carrello della spesa in modo che indichi la directory del carrello della spesa.

Aggiornamento da una versione precedente

L'aggiornamento basato sul browser Š simile all'installazione, ma Š molto pi- semplice. Il processo comincia come l'installazione.

1. Scaricare via FTP la versione pi- recente di ShopSite per il proprio sistema operativo nella directory CGI (o in una directory in cui Š possibile eseguire programmi CGI) e decomprimere i file. Se non si dispone di accesso telnet, decomprimere i file sul proprio PC e trasmetterli separatamente via FTP.

2. Con il browser, passare a http://proprioURL/propriaDirectoryCGI/wwwinstall.cgi.

3. Nella prima videata, fare clic sul pulsante Upgrade. Il programma di installazione determina automaticamente i percorsi relativi alle directory CGI ShopSite e del carrello della spesa esistenti.

4. Se non sono state apportate modifiche inconsuete alla configurazione del server, non Š necessario cambiare nulla: Š sufficiente fare clic su OK per aggiornare il proprio negozio virtuale.

Oltre all'aggiornamento CGI, il programma di installazione esegue anche l'aggiornamento dei database del negozio virtuale. Se i programmi CGI sono condivisi da pi- negozi, vengono aggiornati i database di ciascun negozio e viene creato un resoconto dei risultati. Se sono presenti molti negozi, Š probabile che il processo di aggiornamento richieda qualche tempo.

Risoluzione di problemi

Se l'installazione non viene eseguita, prestare attenzione ai messaggi di errore ricevuti, poich‚ potrebbero indicare la soluzione. In alternativa, controllare quanto segue:

• Impostazione delle autorizzazioni per i file relative a tutte le directory specificate. L'impostazione non corretta delle autorizzazioni per i file e delle propriet... Š il problema di installazione pi- comune incontrato dagli utenti. E necessario che il conto utente UNIX usato per eseguire le CGI disponga dei diritti di scrittura relativi a tali directory CGI.

• Configurazione del Web server

• {0>Did you enter the same store ID and URL that you told the salesperson when the store.auth file was originally created?<}98{>L'URL e l'ID negozio devono essere quelli comunicati al rivenditore presso cui Š stato generato il filestore.auth. Se si desidera usarne altri, Š necessario un nuovo file store.auth.

• Il file store.auth deve essere situato nella stessa directory del programma di installazione. In tal caso, nella directory dati del proprio negozio virtuale dovrebbe essere stato creato un nuovo file denominato idnegozioutente.auth.

Se non si riesce a risolvere il problema, Š possibile consultare il knowledgebase di assistenza tecnica per controllare se altri utenti hanno incontrato lo stesso problema e se Š stata trovata o suggerita una soluzione.

Costruzione del negozio virtuale

Dopo aver installato il software, Š possibile costruire il proprio negozio virtuale. Con il browser, individuare il file start.cgi nella directory di installazione CGI. Dopo aver inserito nome utente e password, viene visualizzata la prima pagina della procedura guidata di configurazione del negozio virtuale, utile nel processo di creazione di un negozio.

Fare clic sul pulsante "?", nell'angolo superiore destro di ciascuna videata, per ricevere informazioni su tale videata o per accedere al sistema della Guida e al knowledgebase di ShopSite.