> # Server SIP: Configurazione: AppRouter

> Opzioni di configurazione

> Utilizzare questa pagina per configurare le funzioni di Application Router (AR) per il contenitore servlet SIP.

> Per soddisfare una richiesta iniziale, il contenitore servlet SIP richiama prima l'Application Router (AR), che fornisce la logica utilizzata per selezionare un'applicazione servlet SIP appropriata. Perché un contenitore funzioni è necessario un Application Router, ma l'AR è un'entità logica separata dal contenitore. L'AR è responsabile solo per la selezione delle applicazioni e non deve implementare la logica delle applicazioni. Ad esempio, l'AR non può modificare una richiesta o inviare una risposta. Per ulteriori informazioni, vedere "Composizione delle applicazioni SIP" nella Guida alla programmazione.

> #### Opzioni di configurazione

> Nome | Descrizione
> --- | ---
> Dati di configurazione AR | Proprietà da passare all'AR predefinito o personalizzato nel metodo init. Tutte le proprietà di configurazione devono essere conformi al formato delle proprietà Java. Se si immettono proprietà per il DAR, le proprietà devono essere conformi anche al formato di proprietà dettagliato descritto nell'Appendice C di SIP Servlet Specification v1.1. Le implementazioni personalizzate di AR possono utilizzare un formato di proprietà dettagliato diverso da quello descritto nell'Appendice C. Un AR personalizzato è inoltre responsabile della convalida dei dati di configurazione. Se lo si desidera è possibile specificare le proprietà di inizializzazione dell'AR all'avvio dell'istanza di WebLogic Communications Server includendo l'opzione Java -Djavax.servlet.sip.ar.dar.configuration. Per specificare un file delle proprietà, includere il prefisso file:/// invece che un URI. Se si specifica l'opzione di avvio Java, il contenitore ignora eventuali proprietà di configurazione definite nei dati di configurazione dell'AR. È possibile modificare le proprietà nei dati di configurazione dell'AR in qualsiasi momento, ma le proprietà non vengono passate all'AR fino a quando il server non viene riavviato con l'opzione -Djavax.servlet.sip.ar.dar.configuration omessa. Attributo MBean: `AppRouterBean.AppRouterConfigData` Le modifiche diventano effettive dopo la ridistribuzione del modulo o il riavvio del server.
> Utilizza AR personalizzato | Consente di utilizzare un Application Router personalizzato invece dell'AR predefinito. Attributo MBean: `AppRouterBean.UseCustomAppRouter` Le modifiche diventano effettive dopo la ridistribuzione del modulo o il riavvio del server.
> Nome file AR personalizzato | Il nome file JAR dell'AR personalizzato (deve essere memorizzato nella directory $DOMAIN_HOME/approuter). Attributo MBean: `AppRouterBean.CustomAppRouterJarFileName` Le modifiche diventano effettive dopo la ridistribuzione del modulo o il riavvio del server.
> Nome predefinito dell'applicazione | Il nome di un'applicazione predefinita che il contenitore deve richiamare quando l'AR personalizzato non riesce a individuare un'applicazione per l'elaborazione della richiesta iniziale. Se non viene specificata un'applicazione predefinita, se l'AR non riesce a selezionare un'applicazione il contenitore restituisce un errore 500. Nota: prima di specificare il nome di un'applicazione come valore in Nome predefinito dell'applicazione è necessario distribuirla. Attributo MBean: `AppRouterBean.DefaultApplicationName`