Cómo compartir y anular la compartición de sistemas de archivos ZFS

En esta versión de Solaris, puede crear un recurso compartido del sistema de archivos ZFS y publicarlo como se indica a continuación:

• Cree el recurso compartido del sistema de archivos y defina las propiedades de recurso compartido NFS o SMB mediante el comando zfs share.

Utilizar un comando independiente para crear un recurso compartido proporciona las siguientes funciones:

• Define las opciones que se utilizan para compartir una ruta determinada en un sistema de archivos.

• Se pueden definir varios recursos compartidos por sistema de archivos, pero se utiliza un nombre para identificar de forma única cada recurso.

• Un recurso compartido puede definir opciones para el uso compartido de NFS y SMB.

• Se pueden definir varias rutas de SMB para una ruta única de acceso del directorio.

• El recurso compartido se almacena en un archivo en el directorio .zfs/share con el nombre del recurso.

La interacción entre los recursos compartidos definidos y las propiedades sharenfs y sharesmb es la siguiente:

• La propiedad sharenfs existente controla si el sistema de archivos está publicado a través de NFS. El valor es On u Off. Esta propiedad puede ser heredada por los sistemas de archivos descendientes.

• La propiedad sharesmb existente controla si el sistema de archivos está publicado a través de SMB. El valor es On u Off. Esta propiedad puede ser heredada por los sistemas de archivos descendientes.

• Cuando la propiedad sharenfs o sharesmb se establece en on, todos los recursos compartidos definidos para el sistema de archivos (y todos los sistemas de archivos descendientes que heredan la propiedad) se publican para el protocolo correspondiente. Todos los recursos compartidos definidos también se publican cuando se emite el comando zfs share.

  1. Si no se define ningún recurso compartido, el sistema de archivos no se comparte.

  2. Si se definen recursos compartidos para el sistema de archivos, solamente se publican esos recursos. El punto de montaje del sistema de archivos solamente se comparte si existe un recurso compartido que lo comparte de manera explícita.

• Cuando la propiedad sharenfs o sharesmb se establece en off, se anula la publicación de todos los recursos compartidos publicados para el sistema de archivos (y todos los sistemas de archivos descendientes que heredan la propiedad) para el protocolo correspondiente. Estos recursos permanecen sin ser compartidos hasta que la propiedad sharenfs o sharesmb se establece en on.

  Ninguno de los recursos compartidos definidos se elimina cuando la propiedad se establece en off, ni se vuelve a compartir la próxima vez que la propiedad sharenfs o sharesmb se establece en on.

• Cuando se emite el comando zfs unshare, se anula la publicación de todos los recursos compartidos publicados para el sistema de archivos. Estos recursos permanecen sin ser compartidos hasta que se emite el comando zfs share para el sistema de archivos.

  Ninguno de los recursos compartidos definidos se elimina cuando se emite el comando zfs unshare, ni se vuelve a compartir la próxima vez que se emite el comando zfs share.

En esta sección, se detallan algunas de las diferencias entre la sintaxis de uso compartido nuevo y la sintaxis de uso compartido heredado.

Las principales diferencias de uso compartido de la nueva versión son las siguientes:

• El comando zfs set share sustituye la interfaz sharemgr para compartir sistemas de archivos ZFS.

• La interfaz sharemgr ya no está disponible. El comando heredado share y la propiedad sharenfs todavía están disponibles. Consulte los ejemplos que se proporcionan a continuación.

• El archivo /etc/dfs/dfstab todavía existe, pero las modificaciones se ignoran. SMF gestiona información de recursos compartidos ZFS o UFS para que los sistemas de archivos se compartan automáticamente cuando se reinicia el sistema, de manera similar a como se gestiona el montaje ZFS y la información de los recursos compartidos.

• El comando share -a es similar al comando share -ap para que el recurso compartido del sistema de archivos sea persistente.

• Los sistemas de archivos descendentes no heredan las propiedades de los recursos compartidos. Si se crea un sistema de archivos descendente con la propiedad heredada sharenfs activada, se crea un recurso compartido para el nuevo sistema de archivos descendente.

Sintaxis del uso compartido de ZFS heredados

La sintaxis de uso compartido heredado todavía se admite.

1. Utilice el comando share para compartir un sistema de archivos.

   Por ejemplo, para compartir un sistema de archivos ZFS:

   # share -F nfs /tank/zfsfs
   # cat /etc/dfs/sharetab
   /tank/zfsfs        -       nfs     rw

   La sintaxis anterior es idéntica a la que se usa para compartir un sistema de archivos UFS:

   # share -F nfs /ufsfs
   # cat /etc/dfs/sharetab
   /ufsfs  -       nfs     rw      
   /tank/zfsfs     -       nfs     rw      

2. El comando share no se puede usar para compartir de manera inicial un sistema de archivos hasta que se defina la propiedad sharenfs.

   # zfs share rpool/data
   cannot share 'rpool/data': legacy share
   use share(1M) to share this filesystem, or
   set the 'share' property and set [sharenfs|sharesmb] property on
   # zfs set sharenfs=on rpool/data
   # cat /etc/dfs/sharetab
   /rpool/data     -       nfs     rw     

Todos los métodos publican los recursos compartidos del sistema de archivos de forma inmediata.

Sintaxis de uso compartido de ZFS nuevo

El nuevo comando zfs set share se utiliza para compartir un sistema de archivos ZFS a través de protocolos NFS o SMB. El recurso compartido no se publica hasta que la propiedad sharenfs establecida también se establezca en el sistema de archivos.

Utilice el comando zfs set share para crear un recurso compartido NFS o SMB del sistema de archivos ZFS y también establezca la propiedad sharenfs.

# zfs create rpool/fs1
# zfs set share=name=fs1,path=/rpool/fs1,prot=nfs rpool/fs1
name=fs1,path=/rpool/fs1,prot=nfs

El recurso compartido no se publica hasta que la propiedad sharenfs o sharesmb se establece en on. Por ejemplo:

# zfs set sharenfs=on rpool/fs1
# cat /etc/dfs/sharetab
/rpool/fs1      fs1     nfs     sec=sys,rw

Un recurso compartido NFS público se puede crear como se indica a continuación:

# zfs set share=name=pp,path=/pub,prot=nfs,sec=sys,rw=*,public rpool/public
name=pp,path=/pub,prot=nfs,public=true,sec=sys,rw=*
# zfs set sharenfs=on rpool/public
# cat /etc/dfs/sharetab
/pub    pp      nfs     public,sec=sys,rw 

También puede crear un recurso compartido de un sistema de archivos ZFS recién creado utilizando una sintaxis similar a la siguiente:

# zfs create -o mountpoint=/ds -o sharenfs=on rpool/ds

Al crear un recurso compartido NFS de un sistema de archivos ZFS, debe proporcionar los siguientes componentes de recursos compartidos:

share=name

Identifica un nombre para el recurso compartido. La longitud máxima para nombre del recurso compartido es de 80 caracteres.

path=nombre_ruta

Identifica una ruta de acceso para el recurso compartido NFS que debe existir en el sistema de archivos o en el directorio para compartir.

prot=nfs o smb

Identifica el protocolo como NFS o SMB.

agrupación/sistema de archivos

Identifica el sistema de archivos ZFS para compartir.

Las opciones de uso compartido adicionales son las siguientes:

description=cadena

Proporciona texto que puede ayudar a identificar el recurso compartido. Los espacios o las comas en la descripción deben incluirse entre comillas (" ").

rw= o ro=

Identifica si el recurso compartido está disponible como de lectura/escritura o de sólo lectura para todos los clientes. También puede especificar una lista separada por dos puntos que incluya los nombres de host, las direcciones IP o un grupo de red.

root=

Identifica un usuario root de un host o una lista de hosts especificados que tienen acceso root. De manera predeterminada, no hay ningún host que tenga acceso root.

sec=

Identifica un modo de seguridad del servidor NFS, como sys, dh, krb5, etc. Para obtener información sobre el modo de seguridad admitido, consulte nfssec(5).

Las siguientes propiedades de NFS se deben especificar después de prot=nfs, pero antes de cualquier propiedad sec=.

• anon=nombre de usuario|uid

• nosub=true|false

• nosuid=true|false

• aclok=true|false

• public=true|false

• index=nombre_archivo

• log=TYPE_LOGTAG

• cksum=TYPE_STRINGSET

Las siguientes propiedades opcionales de SMB se deben especificar después de la propiedad prot=smb:

• ad-container=cadena

• abe=[true|false]

• csc=[disabled|manual|auto|vdo]

• catia=[true|false]

• guestok=[true|false]

• ro=lista-acceso

• rw=lista-acceso

• none=lista-acceso

Consulte share_nfs(1M) and share_smb(1M) para obtener una descripción detallada de las propiedades de recursos compartidos NFS y SMB.

Visualización de información de recurso compartido ZFS

Como en las versiones anteriores, se puede mostrar el valor de la propiedad sharenfs utilizando la propiedad zfs get sharenfs o utilizando la sintaxis de comandos zfs get all.

# zfs get sharenfs rpool/fs1
NAME       PROPERTY  VALUE     SOURCE
rpool/fs1  sharenfs  on        local

La información de recurso compartido nuevo está disponible mediante el uso del comando zfs get share.

# zfs get share rpool/fs1
NAME       PROPERTY  VALUE  SOURCE
rpool/fs1  share     name=rpool_fs1,path=/rpool/fs1,prot=nfs  local

La información de recurso compartido nuevo no está disponible en la sintaxis de comandos zfs get all.

Si crea un recurso compartido de un sistema de archivos ZFS recién creado, utilice el comando zfs get share para identificar el nombre de nombre-recurso o el nombre de ruta-recurso. Por ejemplo:

# zfs create -o mountpoint=/data -o sharenfs=on rpool/data
# zfs get share rpool/data
NAME                                     PROPERTY  VALUE  SOURCE
rpool/data                               share     name=data,path=/data,prot=nfs  local

Herencia de uso compartido de ZFS

La herencia de las propiedades zfs share y sharenfs o sharesmb funciona de la siguiente manera:

• La propiedad zfs share no se hereda de un sistema de archivos principal a un sistema de archivos descendiente. Además, el comando zfs set share no admite la opción -r para establecer una propiedad ZFS en sistemas de archivos descendientes.

• Si la propiedad sharenfs o sharesmb se establece en un sistema de archivos principal, la propiedad sharenfs o sharesmb también se establece en los sistemas de archivos descendientes. Por ejemplo:

  # zfs create -o mountpoint=/ds rpool/ds
  # zfs set share=name=ds,path=/ds,prot=nfs rpool/ds
  name=ds,path=/ds,prot=nfs
  # zfs set sharenfs=on rpool/ds
  # cat /etc/dfs/sharetab
  /ds  rpool_ds   nfs     sec=sys,rw      
  # zfs create rpool/ds/ds1
  # zfs get sharenfs rpool/ds/ds1
  NAME          PROPERTY  VALUE     SOURCE
  rpool/ds/ds1  sharenfs  on        inherited from rpool/ds

  Cualquier sistema de archivos secundario existente también hereda el valor de la propiedad sharenfs o sharesmb del elemento principal.

  Si la propiedad sharenfs o sharesmb se establece en off en el sistema de archivos principal, la propiedad sharenfs o sharesmb se establece en Off en los sistemas de archivos descendientes. Por ejemplo:

  # zfs set sharenfs=off rpool/ds
  $ zfs get -r sharenfs rpool/ds
  NAME           PROPERTY  VALUE    SOURCE
  rpool/ds       sharenfs  off       local
  rpool/ds/ds1   sharenfs  off       inherited from rpool/ds
  rpool/ds/ds2   sharenfs  off       inherited from rpool/ds
  rpool/ds/ds3   sharenfs  off       inherited from rpool/ds

Cambio de un recurso compartido ZFS

Las propiedades de nombre y protocolo se deben especificar al cambiar los valores de propiedades de recursos compartidos.

Por ejemplo, cree un recurso compartido NFS como se indica a continuación:

# zfs create -o mountpoint=/ds -o sharenfs=on rpool/ds
# zfs set share=name=ds,path=/ds,prot=nfs rpool/ds
name=ds,path=/ds,prot=nfs

Luego, agregue el protocolo SMB:

# zfs set share=name=ds,prot=nfs,prot=smb rpool/ds
name=ds,path=/ds,prot=nfs,prot=smb

Elimine el protocolo SMB:

# zfs set -c share=name=ds,prot=smb rpool/ds
name=ds,path=/ds,prot=nfs

Eliminación de un recurso compartido ZFS

Puede eliminar un recurso compartido existente mediante el comando zfs set - c. Por ejemplo, identifique el nombre del recurso compartido.

# zfs get share
NAME         PROPERTY  VALUE  SOURCE
rpool/ds     share     name=ds,path=/ds,prot=nfs  local

Luego, elimine el recurso compartido mediante la identificación del nombre de nombre-recurso. Por ejemplo:

# zfs set -c share=name=ds rpool/ds
share 'ds' was removed.

Si se establece un recurso compartido mediante la creación de un recurso compartido predeterminado, cuando se crea el sistema de archivos, el recurso compartido se puede eliminar por el nombre de nombre-recurso o el nombre de ruta-recurso. Por ejemplo, a este recurso compartido se le asigna un nombre de nombre-recurso predeterminado, data, y un nombre de ruta-recurso predeterminado, /data.

# zfs create -o mountpoint=/data -o sharenfs=on rpool/data
# zfs get share rpool/data
NAME         PROPERTY  VALUE  SOURCE
rpool/data  share     name=data,path=/data,prot=nfs  local

Elimine el recurso compartido mediante la identificación del nombre de nombre-recurso. Por ejemplo:

# zfs set -c share=name=data rpool/data
share 'data' was removed.

Elimine el recurso compartido mediante la identificación del nombre de ruta-recurso. Por ejemplo:

# zfs set -c share=path=/data rpool/data
share 'data' was removed.

Uso compartido de archivos ZFS en una zona no global

En las versiones anteriores de Solaris, no se podían crear ni publicar recursos compartidos NFS o SMB en una zona no global de Oracle Solaris. En esta versión de Solaris, puede crear y publicar recursos compartidos NFS utilizando el comando zfs set share y el comando share antiguo con una zona no global.

• Si un sistema de archivos ZFS está montado y se encuentra disponible en una zona no global, dicho sistema puede ser compartido en esa zona.

• Un sistema de archivos se puede compartir en la zona global si no está montado en una zona no global o si no se comparte en una zona no global.

• Si la propiedad mountpoint de un sistema de archivos ZFS se establece en antigua, el sistema de archivos se puede compartir mediante el uso del comando share antiguo.

Por ejemplo, los sistemas de archivos /export/home/data y /export/home/data1 están disponibles en zfszone.

zfszone# share -F nfs /export/home/data
zfszone#  cat /etc/dfs/sharetab
/export/home/data     export_home_data      nfs     sec=sys,rw

zfszone# zfs set share=name=data1,path=/export/home/data1,prot=nfs 
tank/zones/export/home/data1
zfszone# zfs set sharenfs=on tank/zones/export/home/data1
zfszone# cat /etc/dfs/sharetab
/export/home/data1      data1   nfs     sec=sys,rw 

Resumen de comando de uso compartido antiguo y uso compartido de ZFS nuevo

En esta tabla se describen la sintaxis de uso compartido del sistema de archivos ZFS nuevo y la sintaxis de uso compartido antiguo.

Tabla 6-5 Resumen de comando de uso compartido antiguo y uso compartido de ZFS

# zfs set sharenfs=on tank/fs1

# zfs set sharesmb=on tank/fs2

# zfs set sharenfs=off tank/fs1

# zfs set sharenfs=off tank/fs1

# zfs set sharesmb=off tank/fs2

# zfs set sharesmb=off tank/fs2

# zfs set sharenfs=nosuid tank/fs1

# zfs set share=name=fs1,prot=nfs,
nosuid rpool/fs1
name=fs1,path=/rpool/fs1,prot=nfs,
nosuid=true

# zfs set sharenfs=on tank/fs1

# zfs set sharenfs=on tank/fs1

# zfs set sharesmb=on tank/fs2

# sharemgr create -P smb fssmb
# sharemgr add-share -r fs-smb -s /tank/fs2 fssmb

# zfs set sharesmb=on tank/fs2

Resolución de problemas de recurso compartido ZFS

• No puede compartir un sistema de archivos principal si ya se comparte un subdirectorio o un sistema de archivos descendiente.

  # share -F nfs /rpool/fs2/dir1
  # share -F nfs /rpool/fs2/dir2
  # share -F nfs /rpool/fs2
  share: NFS: descendant of path is shared: /rpool/fs2/dir1 in rpool_fs2_dir2

• No se admite el cambio de nombre de un recurso compartido que se crea con el comando zfs set share.

• Puede crear un recurso compartido de sistema de archivos con los protocolos NFS y SMB mediante el comando zfs set share. Por ejemplo:

  # zfs set share=name=ds,path=/ds,prot=nfs,prot=smb rpool/ds
  name=ds,path=/ds,prot=nfs,prot=smb

  Si desea crear un recurso compartido de sistema de archivos con los protocolos NFS y SMB utilizando el comando share antiguo, debe especificar el comando dos veces. Por ejemplo:

  # share -F nfs /rpool/ds
  # share -F smb /rpool/ds
  # zfs get share rpool/df
  name=rpool_ds,path=/rpool/ds,prot=nfs,prot=smb

• Una ruta o una descripción de recurso compartido que incluye una coma (,) se debe incluir entre comillas dobles.

Migración del uso compartido de ZFS y problemas de transición

Identifique los problemas de transición en esta sección.

• Actualización del sistema: si vuelve a iniciar un entorno de inicio anterior, los recursos compartidos ZFS serán incorrectos debido a que se han realizado cambios en las propiedades de esta versión. Los recursos compartidos que no son de ZFS no se ven afectados. Si tiene previsto volver a iniciar un entorno de inicio anterior, primero debe guardar una copia de la configuración del recurso compartido existente anterior a la operación pkg update a fin de poder restaurar la configuración del recurso compartido en los sistemas de archivos ZFS.

  • En los entornos de inicio más viejos, utilice el comando sharemgr show -vp para obtener una lista de todas las acciones y su configuración.

  • Utilice el comando zfs get sharenfs sistema_archivos y el comando zfs sharesmb sistema_archivos para obtener los valores de las propiedades del uso compartido.

  • Si utiliza un entorno de inicio más viejo, restablezca la configuración original de las propiedades sharenfs y sharesmb.

• Comportamiento de anulación de compartición antigua: mediante el uso del comando unshare -a o del comando unshareall, se anula la publicación de un recurso compartido, pero no se actualiza el repositorio de recursos compartidos SMF. Si intenta volver a compartir el recurso existente, se comprueba si hay conflictos en el depósito de recursos compartidos y se muestra un error.