Configuración predeterminada de archivos de registro FTP <logFile>
Información general
El elemento <logFile> se usa para configurar las opciones de registro de actividad predeterminadas para un servidor FTP.
Por ejemplo, puede habilitar o deshabilitar el registro, especificar las categorías de información que se almacenarán en el archivo de registro y cambiar el directorio donde se almacena el archivo de registro. También puede usar el elemento <logFile> para controlar la frecuencia con la que IIS crea un nuevo archivo de registro basado en el tamaño del archivo de registro o el intervalo de tiempo y el tamaño máximo (en bytes) que puede convertirse un archivo de registro.
Nota:
A diferencia de los sitios web que pueden usar el formato IIS, NCSA o W3C para los archivos de registro, el servicio FTP 7 solo almacena los archivos de registro en formato W3C.
Puede definir las categorías de información que registra IIS editando el atributo logExtFileFlags. Los valores predeterminados son Date, Time, ClientIP, UserName, ServerIP, Method, UriStem, FtpStatus, Win32Status, FtpSubStatus, ServerPort, Session y FullPath.
Compatibilidad
| Versión | Notas |
|---|---|
| IIS 10.0 | El elemento <logFile> no se modificó en IIS 10.0. |
| IIS 8.5 | El elemento <logFile> no se modificó en IIS 8.5. |
| IIS 8.0 | El elemento <logFile> no se modificó en IIS 8.0. |
| IIS 7.5 | El elemento <logFile> del elemento <ftpServer> se incluye como una característica de IIS 7.5. |
| IIS 7.0 | El elemento <logFile> del elemento <ftpServer> se introdujo en FTP 7.0, que era una descarga independiente para IIS 7.0. |
| IIS 6,0 | N/D |
Nota:
Los servicios FTP 7.0 y FTP 7.5 se enviaron fuera de banda para IIS 7.0, lo que requería descargar e instalar el servicio desde la siguiente dirección URL:
Con Windows 7 y Windows Server 2008 R2, el servicio FTP 7.5 se incluye como característica para IIS 7.5, por lo que la descarga del servicio FTP ya no es necesaria.
Configuración
Para admitir la publicación de FTP para el servidor web, debe instalar el servicio FTP. Para ello, siga estos pasos.
Windows Server 2012 o Windows Server 2012 R2
En la barra de tareas, haga clic en Administrador del servidor.
En Administrador del servidor, haga clic en el menú Administrar y, después, haga clic en Agregar roles y características.
En el asistente para Agregar roles y características, haga clic en Siguiente. Seleccione el tipo de instalación y haga clic en Siguiente. Seleccione el servidor de destino y haga clic en Siguiente.
En la página Roles de servidor, expanda Servidor web (IIS) y, después, seleccione Servidor FTP.
Nota:
Para admitir la autenticación ASP.Membership o la autenticación del Administrador de IIS para el servicio FTP, también deberá seleccionar Extensibilidad de FTP, además de Servicio FTP.
.Haga clic en Siguiente y, después, en la página Seleccionar características, vuelva a hacer clic en Siguiente.
En la página Confirmar selecciones de instalación, haga clic en Instalar.
En la página Resultados , haga clic en Cerrar.
Windows 8 o Windows 8.1
En la pantalla Inicio, mueva el puntero hasta la esquina inferior izquierda, haga clic con el botón derecho en el botón Inicio y, a continuación, haga clic en Panel de control.
En Panel de control, haga clic en Programas y características y después en Activar o desactivar las características de Windows.
Expanda Internet Information Services y, después, seleccione Servidor FTP.
Nota:
Para admitir la autenticación ASP.Membership o la autenticación del Administrador de IIS para el servicio FTP, también deberá seleccionar Extensibilidad de FTP.
Haga clic en OK.
Haga clic en Cerrar.
Windows Server 2008 R2
En la barra de tareas, haga clic en Inicio, seleccione Herramientas administrativas y, luego, haga clic en Administrador del servidor.
En el panel de jerarquía del Administrador del servidor, expanda Roles y, luego, haga clic en Servidor web (IIS).
En el panel Servidor web (IIS), desplácese hasta la sección Servicios de rol y, luego, haga clic en Agregar servicios de rol.
En la página Seleccionar servicios de rol del Asistente para agregar servicios de rol, expanda Servidor FTP.
Seleccione Servicio FTP.
Nota:
Para admitir la autenticación ASP.Membership o la autenticación del Administrador de IIS para el servicio FTP, también deberá seleccionar Extensibilidad de FTP.
Haga clic en Next.
En la página Confirmar selecciones de instalación, haz clic en Instalar.
En la página Resultados , haga clic en Cerrar.
Windows 7
En la barra de tareas, haga clic en Inicio y, luego, haga clic en Panel de control.
En Panel de control, haga clic en Programas y características y después en Activar o desactivar las características de Windows.
Expanda Internet Information Services y, luego, Servidor FTP.
Seleccione Servicio FTP.
Nota:
Para admitir la autenticación ASP.Membership o la autenticación del Administrador de IIS para el servicio FTP, también deberá seleccionar Extensibilidad de FTP.
Haga clic en OK.
Windows Server 2008 o Windows Vista
Descargue el paquete de instalación desde la siguiente dirección URL:
Siga las instrucciones del siguiente tutorial para instalar el servicio FTP:
Procedimientos
Configuración de las opciones de registro predeterminadas para un servidor FTP
Abra el Administrador de Internet Information Services (IIS):
Si usa Windows Server 2012 o Windows Server 2012 R2:
- En la barra de tareas, haga clic en Administrador del servidor, en Herramientas y, a continuación, en Administrador de Internet Information Services (IIS).
Si usa Windows 8 o Windows 8.1:
- Mantenga presionada la tecla Windows, presione la letra X y haga clic en Panel de control.
- En Panel de control, haga clic en Herramientas administrativas y, a continuación, haga doble clic en Administrador de Internet Information Services (IIS).
Si usa Windows Server 2008 o Windows Server 2008 R2:
- En la barra de tareas, haga clic en Inicio, seleccione Herramientas administrativas y, a continuación, haga clic en Administrador de Internet Information Services (IIS).
Si usa Windows Vista o Windows 7:
- En la barra de tareas, haga clic en Inicio y, luego, haga clic en Panel de control.
- Haga doble clic en Herramientas administrativas y, a continuación, haga doble clic en Administrador de Internet Information Services (IIS).
En el panel Conexiones, haga clic en el nombre del servidor donde desea configurar el registro.
En el panel Inicio, haga doble clic en Registro FTP.
: en la sección Sustitución de archivos de registro, haga clic en Seleccionar campos W3C...Seleccione los campos de los archivos de registro y haga clic en Aceptar.
En Directorio, especifique la ruta de acceso en la que debe almacenarse el archivo de registro. El valor predeterminado es %SystemDrive%\inetpub\logs\LogFiles.
En la sección Sustitución de archivos de registro, especifique las siguientes opciones:
Programación: para crear un nuevo archivo de registro basado en uno de los siguientes valores:
- Cada hora: se crea un nuevo archivo de registro cada hora.
- Diariamente: se crea un nuevo archivo de registro cada día.
- Semanalmente: se crea un nuevo archivo de registro cada semana.
- Mensualmente: se crea un nuevo archivo de registro cada mes.
Tamaño máximo de archivo (en bytes): para crear un nuevo archivo de registro cuando el archivo alcance un tamaño determinado (en bytes). El tamaño mínimo de archivo es 1048576 bytes. Si este atributo se establece en un valor inferior a 1048576 bytes, se supone de forma implícita que el valor predeterminado es 1048576 bytes.
No crear un nuevo archivo de registro: hay un único archivo de registro que seguirá creciendo a medida que se registra la información.
Seleccione Usar la hora local para nomenclatura y conversión de archivos para especificar que en los nombres y la fecha de los archivos de registro se use la hora del servidor local durante la conversión de archivos de registro. Cuando esta opción no está seleccionada, se usa la hora universal coordinada (UTC).
Haga clic en Aplicar en el panel Acciones.
Configuración
Atributos
| Atributo | Descripción | ||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
directory |
Atributo de cadena opcional. Especifica el directorio de registro, donde se almacenan los archivos de soporte técnico relacionados con el registro y el archivo de registro. El valor predeterminado es %SystemDrive%\inetpub\logs\LogFiles. |
||||||||||||||||||||||||||||||||||||||||||||
enabled |
Atributo Boolean opcional. true si el registro está habilitado; de lo contrario, false. El valor predeterminado es true. |
||||||||||||||||||||||||||||||||||||||||||||
localTimeRollover |
Atributo Boolean opcional. true si se crea un nuevo archivo de registro en función de la hora local; de lo contrario, false para la hora universal coordinada (UTC), que anteriormente se llamaba Hora media de Greenwich (GMT). Nota: Independientemente de la configuración, la marca de tiempo de cada registro de registro extendido de W3C se basa en UTC. El valor predeterminado es false. |
||||||||||||||||||||||||||||||||||||||||||||
logExtFileFlags |
Atributo flags opcional. Especifica las categorías de información escritas en el archivo de registro (cuando se usa el formato de archivo de registro extendido W3C) o en el origen de datos ODBC durante los eventos de registro de un sitio. El atributo logExtFileFlags puede ser uno o varios de los valores siguientes. Si especifica más de un valor, sepárelos con una coma (,). Los valores predeterminados son Date, Time, ClientIP, UserName, ServerIP, Method, UriStem, FtpStatus, Win32Status, FtpSubStatus, ServerPort, Session y FullPath.
|
||||||||||||||||||||||||||||||||||||||||||||
period |
Atributo enum opcional. Especifica la frecuencia con la que el servicio FTP crea un nuevo archivo de registro. El atributo period puede ser uno de los siguientes valores posibles.El valor predeterminado es Daily.
|
||||||||||||||||||||||||||||||||||||||||||||
selectiveLogging |
Atributo flags opcional. Especifica el nivel de detalle del registro FTP. El valor predeterminado es LogSuccessful,LogError,LogInfrastructure.
|
||||||||||||||||||||||||||||||||||||||||||||
truncateSize |
Atributo int64 opcional. Especifica el tamaño máximo del archivo de registro (en bytes) después del cual se va a crear un nuevo archivo de registro. Este valor solo es aplicable cuando MaxSize se elige para el atributo period. El tamaño mínimo de archivo es 1048576 bytes. Si este atributo se establece en un valor inferior a 1048576 bytes, se supone de forma implícita que el valor predeterminado es 1048576 bytes.El valor predeterminado es 20971520. |
Elementos secundarios
Ninguno.
Ejemplo de configuración
En el ejemplo de configuración siguiente se muestra un elemento de ejemplo <logFile> para un servidor que habilita el registro de forma predeterminada con sustitución diarias de archivos de registro.
<siteDefaults>
<ftpServer serverAutoStart="true">
<logFile period="Daily" enabled="true" />
</ftpServer>
</siteDefaults>
Código de ejemplo
Los ejemplos de código siguientes muestran cómo habilitar el registro de forma predeterminada con las reversiones diarias de archivos de registro.
AppCmd.exe
REM Enable logging by default with daily log file rollover.
appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.ftpServer.logFile.period:"Daily" /siteDefaults.ftpServer.logFile.enabled:"True" /commit:apphost
Nota:
Debe asegurarse de establecer el parámetro de confirmación en apphost cuando use AppCmd.exe para configurar estas opciones. Esto confirma los valores de configuración en la sección de ubicación adecuada del archivo ApplicationHost.config.
C#
using System;
using System.Text;
using Microsoft.Web.Administration;
internal static class Sample
{
private static void Main()
{
using (ServerManager serverManager = new ServerManager())
{
Configuration config = serverManager.GetApplicationHostConfiguration();
ConfigurationSection sitesSection = config.GetSection("system.applicationHost/sites");
ConfigurationElement siteDefaultsElement = sitesSection.GetChildElement("siteDefaults");
ConfigurationElement ftpServerElement = siteDefaultsElement.GetChildElement("ftpServer");
ConfigurationElement logFileElement = ftpServerElement.GetChildElement("logFile");
logFileElement["period"] = @"Daily";
logFileElement["enabled"] = true;
serverManager.CommitChanges();
}
}
}
VB.NET
Imports System
Imports System.Text
Imports Microsoft.Web.Administration
Module Sample
Sub Main()
Dim serverManager As ServerManager = New ServerManager
Dim config As Configuration = serverManager.GetApplicationHostConfiguration
Dim sitesSection As ConfigurationSection = config.GetSection("system.applicationHost/sites")
Dim siteDefaultsElement As ConfigurationElement = sitesSection.GetChildElement("siteDefaults")
Dim ftpServerElement As ConfigurationElement = siteDefaultsElement.GetChildElement("ftpServer")
Dim logFileElement As ConfigurationElement = ftpServerElement.GetChildElement("logFile")
logFileElement("period") = "Daily"
logFileElement("enabled") = True
serverManager.CommitChanges()
End Sub
End Module
JavaScript
var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST");
var siteDefaultsElement = sitesSection.ChildElements.Item("siteDefaults");
var ftpServerElement = siteDefaultsElement.ChildElements.Item("ftpServer");
var logFileElement = ftpServerElement.ChildElements.Item("logFile");
logFileElement.Properties.Item("period").Value = "Daily";
logFileElement.Properties.Item("enabled").Value = true;
adminManager.CommitChanges();
VBScript
Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST")
Set siteDefaultsElement = sitesSection.ChildElements.Item("siteDefaults")
Set ftpServerElement = siteDefaultsElement.ChildElements.Item("ftpServer")
Set logFileElement = ftpServerElement.ChildElements.Item("logFile")
logFileElement.Properties.Item("period").Value = "Daily"
logFileElement.Properties.Item("enabled").Value = True
adminManager.CommitChanges()