Eseguire lo strumento di analisi pre-aggiornamento (Office SharePoint Server)

Contenuto dell'articolo:

  • Problemi segnalati dallo strumento di analisi pre-aggiornamento

  • Installare ed eseguire lo strumento di analisi pre-aggiornamento

Prima di eseguire un aggiornamento, è necessario utilizzare lo strumento di analisi pre-aggiornamento per analizzare i siti e quindi correggere gli eventuali errori rilevati. Se si aggiorna l'ambiente senza aver prima eseguito questo strumento, la Configurazione guidata Prodotti e tecnologie SharePoint verrà chiusa quando si tenta di eseguirla e verrà richiesto di eseguire lo strumento. È importante che l'amministratore del server esegua questo strumento prima dell'aggiornamento e risolva tutti i problemi possibili prima di pianificare l'aggiornamento.

Nota

Potrebbe essere necessario eseguire lo strumento di analisi pre-aggiornamento più volte. Se ad esempio si esegue lo strumento per valutare la server farm ma si effettua l'aggiornamento solo dopo alcune settimane, è necessario ripetere l'esecuzione appena prima dell'aggiornamento per analizzare gli eventuali nuovi siti e verificare che non siano insorti altri problemi nel frattempo. È inoltre necessario eseguire nuovamente lo strumento dopo aver risolto gli eventuali problemi risultanti dalla prima analisi. In caso contrario, quando si tenta di eseguire la Configurazione guidata Prodotti e tecnologie SharePoint, è possibile che venga visualizzato un messaggio di errore per segnalare che l'analisi preliminare non è stata eseguita.

Per ulteriori informazioni sui problemi o gli errori segnalati dallo strumento di analisi pre-aggiornamento, vedere i post di blog seguenti nel sito Web Microsoft: https://go.microsoft.com/fwlink/?linkid=106424&clcid=0x410 (informazioni in lingua inglese)

Problemi segnalati dallo strumento di analisi pre-aggiornamento

Per ogni sito di SharePoint viene segnalata l'esistenza degli oggetti seguenti:

  • Modelli di sito personalizzati   È necessario sapere quali modelli di sito sono stati personalizzati per un particolare sito in modo da poter verificare le personalizzazioni nuovamente dopo l'aggiornamento.

  • Oggetti orfani   Gli elementi di elenco, gli elenchi, i documenti, i siti Web e le raccolte siti possono essere oggetti orfani, ovvero non associati a un sito particolare. Non potendo essere utilizzati nella versione precedente, gli oggetti orfani non funzionano dopo l'aggiornamento. Se si esegue un aggiornamento sul posto, gli elementi orfani saranno ancora presenti ma non funzioneranno. Se si esegue un aggiornamento graduale, gli elementi orfani non verranno copiati nel nuovo sito. È consigliabile ripulire gli oggetti orfani prima di eseguire l'aggiornamento.

    Suggerimento

    I membri del gruppo Administrators nei server Web front-end possono recuperare elementi orfani prima dell'aggiornamento eseguendo la procedura descritta nell'articolo della Knowledge Base 918744 Descrizione di una nuova operazione eseguibile da riga di comando per la riparazione di database del contenuto in Windows SharePoint Services (https://go.microsoft.com/fwlink/?linkid=69958&clcid=0x410).

  • Web part personalizzate   Prima di eseguire l'aggiornamento, segnalare l'esistenza di web part personalizzate all'amministratore o allo sviluppatore del sito appropriato, in modo che quest'ultimo abbia tempo sufficiente per analizzare i problemi.

    Nota

    Dopo l'aggiornamento potrebbe essere necessario rigenerare e ridistribuire web part personalizzate con gravi problemi di offuscamento.

  • Siti che sono basati su lingue o utilizzano controlli non installati   Se nel database è presente un sito Web basato su modelli specifici per lingua non attualmente installati nei server Web front-end oppure un sito Web che utilizza controlli, ad esempio Microsoft Office Web Components, non attualmente installati nei server Web front-end, installare i modelli specifici per lingua o i controlli mancanti prima dell'aggiornamento.

Utilizzare le informazioni raccolte dallo strumento di analisi pre-aggiornamento per stabilire quanto segue:

  • Se eseguire un aggiornamento sul posto o graduale.

    In Determinare il metodo di aggiornamento (Office SharePoint Server) sono disponibili informazioni che consentono di scegliere il tipo di aggiornamento da eseguire. Ai fini di questa decisione è importante tenere in considerazione il report generato dallo strumento di analisi pre-aggiornamento. In genere, quando si riscontrano problemi rilevanti, è consigliabile utilizzare un aggiornamento graduale anziché sul posto in modo da poterli risolvere.

  • Se aggiornare alcune o tutte le raccolte siti che contengono siti personalizzati.

  • I siti per cui è necessario riapplicare o rieseguire le personalizzazioni dopo l'aggiornamento, per i quali la fase di revisione potrebbe richiedere più tempo.

    Importante

    Quando si esegue lo strumento di analisi pre-aggiornamento, vengono aggiornati i metadati in tutti gli elenchi e le raccolte presenti nei siti. Ciò significa che gli elenchi e le raccolte presenti nell'ambiente risulteranno aggiornati dopo l'esecuzione dello strumento di analisi pre-aggiornamento. Le date dei singoli elementi di elenco e documenti non vengono modificate da questo processo.

Installare ed eseguire lo strumento di analisi pre-aggiornamento

  1. Scaricare e installare lo strumento di analisi pre-aggiornamento dall'Area download Microsoft (informazioni in lingua inglese) (https://go.microsoft.com/fwlink/?linkid=92383&clcid=0x410) (informazioni in lingua inglese) .

    Nota

    Per eseguire questo strumento è necessario essere membri del gruppo Administrators nel computer locale.

  2. Sulla riga di comando passare alla cartella che contiene i due file e quindi eseguire il comando seguente per analizzare tutti i server nella server farm:

    prescan.exe /c preupgradescanconfig.xml /all
    

    È possibile utilizzare lo strumento di analisi pre-aggiornamento per analizzare tutti i siti Web dell'ambiente utilizzando il parametro /all oppure un URL specifico utilizzando il parametro /v URL. Se non si specifica un parametro relativo all'ambito, verranno analizzati tutti i siti Web.

    Nota

    I modelli utilizzati da SharePoint Portal Server 2003 possono essere erroneamente identificati come modelli personalizzati durante l'analisi di pre-aggiornamento, a meno che non si utilizzi il file preupgradescanconfig.xml durante tale analisi. Questo file contiene logica aggiuntiva che consente di identificare i modelli di sito portale come modelli standard utilizzati da SharePoint Portal Server 2003 anziché come modelli personalizzati basati su Windows SharePoint Services 2.0.

    Se si è già installata la nuova versione ma non si è ancora eseguita la Configurazione guidata Prodotti e tecnologie SharePoint, è possibile eseguire lo strumento di analisi pre-aggiornamento dalla cartella seguente: %PROGRAMFILES% \File comuni\Microsoft Shared\web server extensions\12\BIN.

    L'esecuzione dell'analisi può richiedere da alcuni minuti a qualche ora in base alla quantità di contenuto presente nell'ambiente.

  3. Al termine dell'analisi, viene visualizzato un report di riepilogo nella finestra della riga di comando.

Se si sono verificati errori o sono stati rilevati problemi di aggiornamento per i siti, è possibile esaminare il report completo per vedere i dettagli. Il report è denominato PreupgradeReport_IDunivoco_Log.txt, dove IDunivoco è una stringa contenente un numero, e si trova nella directory temp nel computer dell'utente che ha eseguito lo strumento, ad esempio %SYSTEMDRIVE%:\Documents and Settings\Utente1\Local Settings\Temp. In questa stessa directory è inoltre presente un file prescan.log che indica l'ora in cui è stato eseguito lo strumento di analisi pre-aggiornamento.

Dopo aver eseguito lo strumento di analisi pre-aggiornamento, è possibile esaminare i report per individuare e risolvere i problemi. A tale scopo, cercare la parola "error" nel report. È inoltre possibile condividere i risultati del test di analisi pre-aggiornamento pertinenti con altri membri del team di aggiornamento. Prima di pianificare l'aggiornamento, è ad esempio possibile segnalare problemi quali modelli di sito personalizzati o web part personalizzate al proprietario, al designer Web o allo sviluppatore del sito appropriato in modo che quest'ultimo abbia tempo sufficiente per analizzarli ed eseguire alcuni interventi preliminari. Un progettista o uno sviluppatore può ad esempio ritenere opportuno rigenerare una web part con gravi problemi di offuscamento prima dell'aggiornamento. I proprietari dei siti possono quindi verificare tutte le personalizzazioni applicate, inclusi i modelli di sito e le modifiche apportate ai file ASPX (Active Server Pages Extension) principali, e individuare eventuali potenziali problemi.

Scaricare il manuale

Questo argomento è incluso nel manuale seguente, che può essere scaricato per una lettura e una stampa più agevoli:

Per un elenco completo dei manuali disponibili che è possibile scaricare per Office SharePoint Server 2007, vedere Downloadable content for Office SharePoint Server 2007 (informazioni in lingua inglese).