Skip to content

openafsServer

services.openafsServer.advertisedAddresses

List of IP addresses this server is advertised under. See NetInfo(5) Type: list of string

Default

[ ]

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/network-filesystems/openafs/server.nix

services.openafsServer.cellName

Cell name, this server will serve. Type: string

Default

""

Example

"grand.central.org"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/network-filesystems/openafs/server.nix

services.openafsServer.cellServDB

Definition of all cell-local database server machines. Type: list of (submodule)

Default

[ ]

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/network-filesystems/openafs/server.nix

services.openafsServer.cellServDB.*.dnsname

DNS full-qualified domain name of a database server Type: string

Default

""

Example

"afs.example.org"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/network-filesystems/openafs/server.nix

services.openafsServer.cellServDB.*.ip

IP Address of a database server Type: string

Default

""

Example

"1.2.3.4"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/network-filesystems/openafs/server.nix

services.openafsServer.dottedPrincipals

If enabled, allow principal names containing (.) dots. Enabling this has security implications!

Type: boolean

Default

false

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/network-filesystems/openafs/server.nix

services.openafsServer.enable

Whether to enable the OpenAFS server. An OpenAFS server needs a complex setup. So, be aware that enabling this service and setting some options does not give you a turn-key-ready solution. You need at least a running Kerberos 5 setup, as OpenAFS relies on it for authentication. See the Guide "QuickStartUnix" coming with pkgs.openafs.doc for complete setup instructions.

Type: boolean

Default

false

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/network-filesystems/openafs/server.nix

services.openafsServer.package

The openafs package to use. Type: package

Default

pkgs.openafs

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/network-filesystems/openafs/server.nix

services.openafsServer.roles.backup.buserverArgs

Arguments to the buserver process. See its man page. Type: string

Default

""

Example

"-p 8"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/network-filesystems/openafs/server.nix

services.openafsServer.roles.backup.cellServDB

Definition of all cell-local backup database server machines. Use this when your cell uses less backup database servers than other database server machines.

Type: list of (submodule)

Default

[ ]

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/network-filesystems/openafs/server.nix

services.openafsServer.roles.backup.cellServDB.*.dnsname

DNS full-qualified domain name of a database server Type: string

Default

""

Example

"afs.example.org"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/network-filesystems/openafs/server.nix

services.openafsServer.roles.backup.cellServDB.*.ip

IP Address of a database server Type: string

Default

""

Example

"1.2.3.4"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/network-filesystems/openafs/server.nix

services.openafsServer.roles.backup.enable

Whether to enable the backup server role. When using OpenAFS built-in buserver, use in conjunction with the database role to maintain the Backup Database. Normally only used in conjunction with tape storage or IBM's Tivoli Storage Manager.

For a modern backup server, enable this role and seeenableFabs . Type: boolean

Default

false

Example

true

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/network-filesystems/openafs/server.nix

services.openafsServer.roles.backup.enableFabs

Whether to enable FABS, the flexible AFS backup system. It stores volumes as dump files, relying on other pre-existing backup solutions for handling them . Type: boolean

Default

false

Example

true

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/network-filesystems/openafs/server.nix

services.openafsServer.roles.backup.fabsArgs

Arguments to the fabsys process. See {manpage}fabsys_server(1) and {manpage}fabsys_config(1).

Type: string

Default

""

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/network-filesystems/openafs/server.nix

services.openafsServer.roles.backup.fabsExtraConfig

Additional configuration parameters for the FABS backup server.

Type: attribute set

Default

{ }

Example

{afs.localauth = true;afs.keytab = config.sops.secrets.fabsKeytab.path;}

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/network-filesystems/openafs/server.nix

services.openafsServer.roles.database.enable

Database server role, maintains the Volume Location Database, Protection Database (and Backup Database, see backup role). There can be multiple servers in the database role for replication, which then need reliable network connection to each other.

Servers in this role appear in AFSDB DNS records or the CellServDB.

Type: boolean

Default

true

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/network-filesystems/openafs/server.nix

services.openafsServer.roles.database.ptserverArgs

Arguments to the ptserver process. See its man page. Type: string

Default

""

Example

"-restricted -default_access S---- S-M---"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/network-filesystems/openafs/server.nix

services.openafsServer.roles.database.vlserverArgs

Arguments to the vlserver process. See its man page. Type: string

Default

""

Example

"-rxbind"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/network-filesystems/openafs/server.nix

services.openafsServer.roles.fileserver.enable

Fileserver role, serves files and volumes from its local storage. Type: boolean

Default

true

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/network-filesystems/openafs/server.nix

services.openafsServer.roles.fileserver.fileserverArgs

Arguments to the dafileserver process. See its man page. Type: string

Default

"-vattachpar 128 -vhashsize 11 -L -rxpck 400 -cb 1000000"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/network-filesystems/openafs/server.nix

services.openafsServer.roles.fileserver.salvagerArgs

Arguments to the dasalvager process. See its man page. Type: string

Default

""

Example

"-showlog -showmounts"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/network-filesystems/openafs/server.nix

services.openafsServer.roles.fileserver.salvageserverArgs

Arguments to the salvageserver process. See its man page. Type: string

Default

""

Example

"-showlog"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/network-filesystems/openafs/server.nix

services.openafsServer.roles.fileserver.volserverArgs

Arguments to the davolserver process. See its man page. Type: string

Default

""

Example

"-sync never"

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/network-filesystems/openafs/server.nix

services.openafsServer.udpPacketSize

UDP packet size to use in Bytes. Higher values can speed up communications. The default of 1 MB is a sufficient in most cases. Make sure to increase the kernel's UDP buffer size accordingly via net.core(w|r|opt)mem_max sysctl.

Type: signed integer

Default

1310720

Declared by: https://github.com/nixos/nixpkgs/blob/master/nixos/modules/services/network-filesystems/openafs/server.nix