DCE and DFS for Linux Installation and Configuration Guide

Cell Administrator's Principal Name	The principal name for the DCE cell administrator. This is the same default principal name used in DCE installation and Configuration, cell_admin.
Password	The password for cell_admin. This is the same password that is specified in the DCE cell configuration.

5.3.2 Information for FLDB Server Configuration

Each DCE cell using DFS requires at least one Fileset Location Database (FLDB) Server. This machine is also usually the System Control Machine. Figure 5-2 shows the server section of the DFS Configuration Worksheet. Table 5-2 explains how to use this form when configuring FLDB Servers.

If the FLDB Server is also going to be a DFS Client or a DFS Server, see Section 5.3.4, Information for DFS Client Configuration and Section 5.3.3, Information for DFS File Server Configuration, respectively, after filling out this part of the worksheet.

Figure 5-2: Server Section of the DFS Configuration Worksheet

Table 5-2: DFS Configuration Worksheet for FLDB Servers

Cell Administrator's Principal Name

The principal name for the DCE cell administrator. This is the same default principal name used in DCE installation and configuration, cell_admin.

Password

The password for cell_admin. This is the same password that is specified in the DCE cell configuration.

System Control Machine Name

The name of the machine that distributes common configuration files to other server machines in the cell or administrative domain. The default is the name of the FLDB Server or another machine, depending on how you chose to set up your DFS environment.

Device Name

The block device name of the DFS root fileset. For example, /dev/hdb1.

Fileset Mount Point

The local mount point for the DFS root fileset. Enter 1 to 31 alphanumeric characters. For example, /dfs.root.
Caution: Do not specify the local system root directory (/\) as the mount point for the DFS root fileset. If you do, serious data corruption might occur.

Aggregate ID

A positive integer to identify the root aggregate. This ID is unique for each DFS server and cannot be used by any other entries in the dfstab file.

Cell Administrator's Principal Name	The principal name for the DCE cell administrator. This is the same default principal name used in DCE installation and configuration, cell_admin.
Password	The password for cell_admin. This is the same password that is specified in the DCE cell configuration.
System Control Machine Name	The name of the machine that distributes common configuration files to other server machines in the cell or administrative domain. The default is the name of the FLDB Server or another machine, depending on how you chose to set up your DFS environment.
Device Name	The block device name of the DFS root fileset. For example, /dev/hdb1.
Fileset Mount Point	The local mount point for the DFS root fileset. Enter 1 to 31 alphanumeric characters. For example, /dfs.root. Caution: Do not specify the local system root directory (/\) as the mount point for the DFS root fileset. If you do, serious data corruption might occur.
Aggregate ID	A positive integer to identify the root aggregate. This ID is unique for each DFS server and cannot be used by any other entries in the dfstab file.

5.3.3 Information for DFS File Server Configuration

A DFS File Server receives requests from DFS clients and serves the requested DFS filesets to them. Figure 5-2 shows the File Server part of the DFS Configuration Worksheet. Table 5-3 explains how to use this form when configuring File Servers.

Table 5-3: DFS Configuration Worksheet for File Servers

Cell Administrator's Principal Name

The principal name for the DCE cell administrator. This is the same default principal name used in DCE installation and configuration, cell_admin.

Password

The password for cell_admin. This is the same password that is specified in the DCE cell configuration.

System Control Machine Name

The name of the machine that distributes common configuration files to other server machines in the cell or administrative domain. The default is the name of the FLDB Server or another machine, depending on how you chose to set up your DFS environment.

File System Type

The file system type for the exported DFS fileset. This is the Episode (LFS) file system

Device Name

The block device name of the exported DFS fileset. For example, /dev/hdb1.

Fileset Mount Point

The local mount point for the exported DFS fileset.

Aggregate ID

A positive integer to identify the exported aggregate. This ID is unique and cannot be used by any other entries in the dfstab file.

Cell Administrator's Principal Name	The principal name for the DCE cell administrator. This is the same default principal name used in DCE installation and configuration, cell_admin.
Password	The password for cell_admin. This is the same password that is specified in the DCE cell configuration.
System Control Machine Name	The name of the machine that distributes common configuration files to other server machines in the cell or administrative domain. The default is the name of the FLDB Server or another machine, depending on how you chose to set up your DFS environment.
File System Type	The file system type for the exported DFS fileset. This is the Episode (LFS) file system
Device Name	The block device name of the exported DFS fileset. For example, /dev/hdb1.
Fileset Mount Point	The local mount point for the exported DFS fileset.
Aggregate ID	A positive integer to identify the exported aggregate. This ID is unique and cannot be used by any other entries in the dfstab file.

5.3.4 Information for DFS Client Configuration

DFS client machines are those machines that request DFS filesets from DFS File Servers, import the filesets, and keep track of operations on those filesets. Figure 5-3 shows the DFS Client part of the DFS Configuration Worksheet. Table 5-4 describes what you need to know before you configure a DFS client.

Figure 5-3: Client Section of the DFS Configuration Worksheet

Table 5-4: DFS Configuration Information for Client.

Cache Type

The type of cache your system will use for DFS caching. The choices are disk or memory. If you choose a memory cache, the system will not perform disk caching even if there is disk space available. In addition, a memory cache is permanently allocated from system memory and is typically smaller than a disk cache.

Cache Size

The size of the DFS cache in kilobytes. For disk caching, the default is 10,000 kilobytes (10 MB). For memory caching, the default is 1000 kilobytes (1 MB).

Cache Directory

The name of the caching directory. The default is /opt/dcelocal/var/adm/dfs/cache. Entegrity recommends that you dedicate a disk partition for DFS caching and use that directory name as the cache directory (for disk caching only).

Cache Type	The type of cache your system will use for DFS caching. The choices are disk or memory. If you choose a memory cache, the system will not perform disk caching even if there is disk space available. In addition, a memory cache is permanently allocated from system memory and is typically smaller than a disk cache.
Cache Size	The size of the DFS cache in kilobytes. For disk caching, the default is 10,000 kilobytes (10 MB). For memory caching, the default is 1000 kilobytes (1 MB).
Cache Directory	The name of the caching directory. The default is /opt/dcelocal/var/adm/dfs/cache. Entegrity recommends that you dedicate a disk partition for DFS caching and use that directory name as the cache directory (for disk caching only).

5.4 Configuring Servers and Clients

Use the steps in this section to configure your machine depending on its role: System Control, FLDB Server, DFS File Server, or DFS Client.

You need superuser privileges to configure DFS on the system. You should have already configured into a DCE cell that has a DFS server and installed the DFS software on your machine.

Answer the prompts based on the DFS Configuration Worksheet.

5.4.1 Configuring the System Control Machine

If System Control is part of the FLDB Server, follow the directions in the next section.

If System Control is on a different machine than the FLDB server, configure the software, as follows:

At the command line, enter /opt/dcelocal/bin/dfssetup. The DFS Setup Main Menu is displayed as follows:

 *** DFS Setup Main Menu *** 
          DCE/DFS for Linux 2.3

1)  Configure   Configure DFS services on this system
2)  Show        Show DFS configuration and active daemons
3)  Stop        Terminate all active DFS daemons
4)  Start       Start all DFS daemons
5)  Clobber     Terminate all active DFS daemons 
                  and remove all permanent local DFS databases
6)  Version     Show DFS Version number
X)  Exit

Please enter your selection: 1 <Return>

Choose option 1, Configure. The screen displays the DFS Configuration Choice Menu as follows:

     ***  DFS Configuration Choice Menu  ***

1)  Configure this system as a DFS Client
2)  Configure a new cell: DFS Primary FLDB Server
3)  Configure this system as a DFS File Server
4)  Configure this system as a DFS System Control Machine
R)  Return to previous menu

    Please enter your selection (or '?' for help):

Choose option 4, Configure this system as a DFS System Control Machine.

The installation script displays a message indicating that it is configuring.
When the installation script prompts you, enter the Cell Administrator's principal name and password.

The installation script displays the following initialization messages:

initializing Episode: syscall return value = 0 Modifying the registry database for DFS server operation... Starting bosserver... Waiting for bosserver to sync up... Creating BOS admin lists... Starting upserver...

The installation script redisplays the main menu.

1)  Configure   Configure DFS services on this system
2)  Show        Show DFS configuration and active daemons
3)  Stop        Terminate all active DFS daemons
4)  Start       Start all DFS daemons
5)  Clobber     Terminate all active DFS daemons and remove all permanent			 	
                local DFS databases
6)  Version     Show DCE DFS Version number
X)  Exit

Please enter your selection: 1 <Return>

Choose option 1, Configure.

The Configuration Choice Menu is displayed as follows:

1) Configure this system as a DFS Client
2) Configure a new cell: DFS Primary FLDB Server
3) Configure this system as a DFS File Server
4) Configure this system as a DFS System Control Machine
R) Return to previous menu

Please enter your selection (or ? for help): 1 <Return>

From the Configuration menu, choose option 1, Configure this system as a DFS Client.

After starting to configure, the following choices are displayed:
```
1) Memory
```
```
2) Local Disk
```
```
Enter cache type: <Return>
```
Enter the type of cache your system will use for DFS caching:1 for memory caching or 2 for local disk caching. Press Return.

NOTE: The memory value you use for the DFS cache is not available to your operating system and applications.

If you chose Memory, 1:

At the prompt:

Enter RAM cache size (KB) [1000]: <Return>

Press Return to accept the default, or enter a new value and press Return.

Configuration begins.

If you chose Local Disk, 2:

After the prompts:

Enter disk cache size (KB) [10000]: <Return>

Enter disk cache directory

[/opt/dcelocal/var/adm/dfs/cache]: <Return>

A. Enter the cache size.

The default is [10000] kilobytes (10MB). Press Return to accept the default, or enter a new value and press Return.

B. Enter the name of the cache directory. The default is /opt/dcelocal/ var/adm/dfs/cache. Press Return to accept the default. To change the default value, enter a new value and press Return. Entegrity recommends that you dedicate a disk partition for DFS caching and use that directory name as the cache directory (for disk caching only).

When the DFS client configuration is complete, the DFS Setup Main Menu is displayed.

5.4.5 Removing DFS

From the DFS Setup Main Menu, use option 5, Clobber, and then reboot.

5.5 Modifying the Configuration for Startup

Most DFS configurations use default settings when starting DFS processes on various machines. Thus, most users can skip the information in this section and proceed to the configuration instructions

DFS for Linux provides a configuration file called opt/dcelocal/etc/setup_state. This file lets advanced users specify non-default options for commands (dfsd, dfsbind, and fxd) that dfssetup executes to start DFS processes on the local server or client machine.

The rpm process that installs the DCE software packages checks whether the setup_state file is present, and installs it if it is not present. The unmodified setup_state file includes the following default settings:

DFSD_OPTS=""
DFSBIND_OPTS=""
DFSFXD_OPTS="-mainprocs 7"

Use any ASCII editor to modify the file. The following example shows a modified setup_state file.

DFSD_OPTS="-mainprocs 2 -tokenprocs 2 -files 300"

DFSBIND_OPTS="-expressprocs 1 -regularprocs 1 -junctionlife 86400 
-prefixlife 86400 -notfoundlife 3600"

[Previous] [Next] [Contents] [Index]

To make comments or ask for help, contact support@entegrity.com.

DCE and DFS for Linux Installation and Configuration Guide

5.4.3 Configuring a DFS File Server

5.4.4 Configuring a DFS Client

Copyright © 2001-2004 Entegrity Solutions Corporation & its subsidiaries