DFS Configuration Guide v4.2

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

2.1 Getting Started

This chapter explains how to configure the Gradient DFS for Tru64 UNIX software. Make sure you complete the DFS Configuration Worksheet (see Chapter 1) before you begin.

After you install the DCE DFS software on the system, rebuild the kernel, and reboot the system, configure the software by invoking the /usr/sbin/dfssetup script. Alternatively, you can choose option 9 from the DCE Configuration Choice Menu to the display the DFS Setup Main Menu.

You need superuser privileges in order to configure DCE DFS on the system.

# /usr/sbin/dfssetup

***  DFS Setup Main Menu  ***

     Gradient DFS Version V4.1 for Tru64 5.1 (rev 1391)

Version x.x (rev xxx)

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)  Restart     Terminate and restart all DFS daemons

6)  Clobber     Terminate all active DFS daemons and remove

                all permanent local DFS databases

7)  Version     Show DCE DFS Version number

X)  Exit

Please enter your selection: 1 <Return>

Choose option 1, "Configure DFS services on this system," to view the DFS Configuration Choice Menu. All DFS configuration options appear on this menu. Choose the options that apply to your system.

***  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

5) Configure DFS in TruCluster/Sierra Cluster

R) Return to previous menu

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

Use the information in Table 2-1 with menu options 1 through 4.

Table 2-1: Configuring DFS

Enter R to display the DFS Setup Main Menu.

Figure 2-1 shows how to use the information in each section of this chapter.

Figure 2-1: Using Chapter 2

Throughout each section, default answers appear in brackets in the examples. Press <Return> to accept the default or supply the requested information.

2.2 Configuring the DFS Primary FLDB Server

See the facing page for instructions corresponding to the bold numbers on the right, below:

     Configuring DFS Fileset Location Database Server...

Cell Administrator's principal name [cell_admin]: <Return> 1
Password: <Return> 2
Removing temporary local DFS databases and configuration files
Shutting down DFS services
DFS services stopped
Removing permanent local DFS databases and configuration files

     Removing DFS Services database...

     Removing files in /opt/dcelocal/var/dfs/adm...

     Removing files in /opt/dcelocal/var/dfs/backup...

     Removing files in /opt/dcelocal/var/dfs/aggrs...

     Removing files in /opt/dcelocal/var/dfs...

     Removing startup/shutdown files...

     Removing cache files in /opt/dcelocal/var/adm/dfs...

     Modifying the registry database for DFS server operation...

     Starting bosserver...

>>> group member added

Current site is: registry server at /.../tub_cell/subsys/dce/sec/master

Domain changed to: group

Checking for a Ubik sync site in  hosts/tub

Host /.:/hosts/tub is now the sync site

     Enter the name of the system control machine [tub]: <Return> 3

          		1) Unix File System (UFS)

          2) POLYCENTER Advanced File System (AdvFS)

     Enter the filesystem type for root.dfs: <Return> 4

     Enter the device name for the DFS root aggregate

     for example, /dev/rz3h) : 5

          Ensure this is a valid, mounted filesystem partition.

The host name for this script is tub.

1. If DCE is configured, the current cell administrator's principal name is displayed as the default. Press <Return> to accept the default.

2. Enter the cell administrator's password. This is identical to the password entered during DCE configuration.

3. Enter the name of the system control machine.

   If a System Control Machine (SCM) has already been configured, the current SCM is the default. If no SCM is configured, the current system name is the default. Press <Return> to accept the default.

4. Enter the file system type for the DFS root fileset (root.dfs). Enter 1 for the Unix File System (UFS) or 2 for the POLYCENTER Advanced File System (AdvFS) and press <Return>.

5. This prompt is displayed if you select the UFS File System. Enter the device name for the DFS root fileset and press <Return>. There is no default.

        Enter the AdvFS fileset to be used for the DFS root
   

        (form: domain_name#fileset_name) : <Return> 6
   

        Ensure this is a valid, mounted AdvFS fileset.
   

        (use the '-t advfs' switch on the mount command)
   

        Press <RETURN> to continue, CTRL-C to exit: 
   

        Fileset is mounted at [/export]: <Return> 7
   

        Enter numerical aggregate ID [1]: <Return> 8
   

             readWrite   ID 0,,1  valid
   

             readOnly    ID 0,,2  invalid
   

             backup      ID 0,,3  invalid
   

   number of sites: 1
   

      server           flags     aggr   siteAge principal      owner           
   

   tub.zk3.dec.com     RW       1       0:00:00 hosts/tub      <nil>
   

   FLDB entry created for fileset root.dfs (0,,1) on aggregate 1 of tub
   

   Aggregate Id 1 is not exported from the server
   

             Starting dfsbind daemon (dfsbind)...
   

             Starting fxd...
   

   fx: FX server starts listening...
   

        Modifying DFS system startup procedure...
   

   DFS Client has not yet been configured.  Configure now? [y]: <Return> 9
   

             1) Memory
   

             2) Local Disk
   

        Enter cache type: <Return> 10
   

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

        Enter disk cache directory [/opt/dcelocal/var/adm/dfs/cache]: 
   

   <Return> 12
   

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

   Starting dfsd...
   

   dfs: TKN server starts listening...
   

   dfsd: start sweeping disk cache files .... 
   

   dfsd: All DFS daemons started.
   

        Modifying DFS system startup procedure...  14
   

6. This prompt is displayed if you select the AdvFS file system. Enter the AdvFS fileset name for the DFS root fileset and press <Return>. There is no default.

7. Enter the mount point for the DFS root fileset.

   The default is the mount point for the device name (UFS) or AdvFS fileset. Press <Return> to accept the default. To change the default aggregate name, enter a new name.

8. Enter the aggregate ID associated with the DFS root fileset.

   The default root aggregate ID is 1. Press <Return> to accept the default. To change the default root aggregate ID, enter a new ID.

9. If you answer y, the system prompts you for DFS client configuration information.

   If you do not want to configure this system as a DFS client, enter n and press <Return>; the configuration is completed and the DFS Setup Main Menu is displayed.

   The default answer is y.

10. Enter the type of cache your system will use for DFS caching: 1 for memory caching or 2 for local disk caching. Press <Return>.

11. This prompt is displayed if you select local disk caching. Enter the disk cache size.

    The default is 10000 kilobytes (10MB). Press <Return> to accept the default. To change the default value, enter a new value.

12. This prompt is displayed if you select local disk caching. 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. Entegrity recommends that you dedicate a disk partition for DFS caching and use that directory name as the cache directory (for disk caching only).

13. This prompt is displayed if you select RAM caching. Enter the RAM cache size.

    The default is 1000 kilobytes (1MB). Press <Return> to accept the default. To change the default value, enter a new value.

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

14. DFS FLDB server configuration is complete. The DFS Setup Main Menu is then displayed.

See the facing page for instructions corresponding to the bold numbers on the right, below:

    Configuring DFS File Server...

Cell Administrator's principal name [cell_admin]: <Return> 1

Password: <Return> 2

     Modifying the registry database for DFS server operation...

     Starting bosserver...

     Starting ftserver...

Enter the name of the system control machine:  splash  <Return> 3

     Starting upclient...

     1) Unix File System (UFS)

     2) POLYCENTER Advanced File System (AdvFS)

Enter the filesystem type for the aggregate to be exported: 1 <Return> 4

Enter the device name for the aggregate to be exported

(for example, /dev/rz3h) : <Return> 5

     Ensure this is a valid, mounted UFS filesystem partition.

Enter the AdvFS fileset to be exported.

(form: domain_name#fileset_name) : <Return> 6

Ensure this is a valid, mounted AdvFS fileset.

(use the '-t advfs' switch on the mount command)

Press <RETURN> to continue, CTRL-C to exit: <Return> 7

The host name for this script is tub.

1. If DCE is configured, the current cell administrator's principal name is displayed as the default. Press <Return> to accept the default.

2. Enter the cell administrator's password. This is identical to the password entered during DCE configuration.

3. Enter the name of the system control machine and press <Return>. There is no default.

4. Enter the file system type for the exported DFS aggregate. Enter 1 for the Unix file system (UFS) or 2 for the POLYCENTER Advanced File System (AdvFS). Press <Return>.

5. This prompt is displayed if you select the Unix file system. Enter the device name for the exported DFS aggregate and press <Return>. There is no default.

6. This prompt is displayed if you select the AdvFS file system. Enter the AdvFS fileset name to be exported and press <Return>. There is no default.

7. Press <Return> to continue with the configuration. Press <Ctrl-C> to exit the configuration.

NOTE: In order to make the newly exported fileset accessible to DFS clients, a mount point has to be created at some point in the DFS tree. The command to do so (using the fileset name in the example above) is: fts crmount -fileset tub.rz3h -directory /:/some/path There should not exist any entity by the name you choose for the mount point (/:/some/path in the example) and you should have DCE credentials as somebody who has w permission to the parent directory of the mount point (/ :/some in the example).

Fileset is mounted at [/user/users]:  <Return> 8

Enter a unique fileset name (for example, host.rz3h): tub.rz3h <Return> 9

Enter a unique numerical aggregate ID:  700 <Return> 10

     Exporting /dev/rz3h through DFS...

     If you wish to export additional aggregates, do so after 
     completing this script by using the appropriate DFS 
     administration commands described in the DFS Admin Guide.

Press <RETURN> to continue:   <Return> 11

    Starting dfsbind daemon (dfsbind)...

    Starting fxd...

fx: FX server starts listening...

Modifying DFS system startup procedure...

DFS Client has not yet been configured.  Configure now? [y]:  <Return> 12

     1) Memory

     2) Local Disk

Enter cache type: <Return> 13

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

Enter disk cache directory (/opt/dcelocal/var/adm/dfs/cache): <Return> 15

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

     Starting dfsd...

dfs: TKN server starts listening...

dfsd: start sweeping disk cache files .... 

dfsd: All DFS daemons started.

Modifying DFS system startup procedure...   17

1. Enter the mount point for the exported file system. The default is the local mount point for the device name (UFS) or the local mount point for the AdvFS fileset. Press <Return> to accept the default. To specify a different mount point, enter a new mount point and press <Return>.

2. Enter the fileset name associated with the exported DFS fileset and press <Return>. There is no default.

3. Enter the aggregate ID associated with the exported DFS fileset and press <Return>. There is no default.

4. Press <Return> to continue with the configuration.

5. If you answer y, the system prompts you for DFS client configuration information.

   If you have already configured this system as a DFS client, enter n and press <Return>; the configuration is completed and the DFS Setup Main Menu is displayed.

   The default answer is y.

6. Enter the type of cache your system will use for DFS caching: 1 for memory caching or 2 for local disk caching. Press <Return>.

7. This prompt is displayed if you select local disk caching. Enter the cache size.

   The default is 10000 kilobytes (10MB). Press <Return> to accept the default. To change the default value, enter a new value.

8. This prompt is displayed if you select local disk caching. 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. Entegrity recommends that you dedicate a disk partition for DFS caching and use that directory name as the cache directory (for disk caching only).

9. This prompt is displayed if you select RAM caching. Enter the RAM cache size.

   The default is 1000 kilobytes (1MB). Press <Return> to accept the default. To change the default value, enter a new value.

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

10. DFS file server configuration is complete. The DFS Setup Main Menu is then displayed.

NOTE: Before configuring a DFS client on Sierra Cluster 2.0, be sure to refer to section 9.4 of the Compaq Alpha Server SCTM 2.0 Installation Guide. Follow that guide to make sure the local /tmp directory is available before you start configuration.

See the facing page for instructions corresponding to the bold numbers on the right, below:

          1) Memory

          2) Local Disk

     Enter cache type: <Return> 1

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

     Enter disk cache directory 

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

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

          Starting dfsd...

dfs: TKN server starts listening...

dfsd: start sweeping disk cache files .... 

dfsd: All DFS daemons started.

     Modifying DFS system startup procedure...  5

NOTE: Before configuring a DFS client on Sierra Cluster 2.0, be sure to refer to section 9.4 of the Compaq Alpha Server SCTM 2.0 Installation Guide. Follow that guide to make sure the local /tmp directory is available before you start configuration.

1. Enter the type of cache your system will use for DFS caching: 1 for memory caching or 2 for local disk caching. Press <Return>.

2. This prompt is displayed if you select local disk caching. Enter the cache size.

   The default is 10000 kilobytes (10MB). Press <Return> to accept the default. To change the default value, enter a new value.

3. This prompt is displayed if you select local disk caching. 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. Entegrity recommends that you dedicate a disk partition for DFS caching and use that directory name as the cache directory (for disk caching only).

4. This prompt is displayed if you select RAM caching. Enter the RAM cache size.

   The default is 1000 kilobytes (1MB). Press <Return> to accept the default. To change the default value, enter a new value.

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

1. DFS client configuration is complete. The DFS Setup Main Menu is then displayed.

See the facing page for instructions corresponding to the bold numbers on the right, below:

 Cell Administrator's principal name [cell_admin]:

<Return> 1

     Password: <Return> 2

          Modifying the registry database for DFS server operation...

          Starting bosserver...

          Creating BOS admin lists...

          Starting upserver...

     Modifying DFS system startup procedure... 

1. If DCE is configured, the current cell administrator's principal name is displayed as the default. Press <Return> to accept the default.

2. Enter the cell administrator's password. This is identical to the password entered during DCE cell configuration.

   DFS System Control Machine configuration is complete. The DFS Setup Main Menu is then displayed.

Navigate to the Cluster Configuration Choice Menu.

From the DFS Setup Main Menu, select option 1:

         Configure DFS services

From the DFS Configuration Choice Menu, select option 5

Configure DFS in TruCluster/Sierra Cluster

You'll obtain the Cluster Configuration Choice Menu: 

          ***  Cluster Configuration Choice Menu  ***

        1) Configure this member as a DFS Client

        2) Configure all cluster members as DFS clients

        R) Return to previous menu

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

        Configuring DFS Clients in cluster...

Select option 2.

Beginning of remote DFS client configuration

Complete the following prompts according to the steps on the facing page. Bold numbers on the right correspond to those steps.

Select the type of DFS cache desired

          1) Memory

          2) Local Disk

     Enter cache type: 2 <Return>                   	1

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

     Enter disk cache directory [/opt/dcelocal/var/adm/dfs/cache]: <Return> 3   

Do you wish to overwrite existing DFS configurations on ALL cluster members? 
(y/n) [y]:   <return>                                	4

Remote configuration requires that you be authenticated as a member

of the sec-admin group. Please supply the principal and password.

     Enter Principal Name: cell_admin  <return>       	5

     Password:   <return>        (NOTE: PASSWORD is not echoed) 

1. Enter the type of cache your system will use for DFS caching: 1 for memory caching or 2 for local disk caching. Press <Return>

   (Example chose 2, so displayed the prompt to enter cache size.)

2. Enter the cache size.

   The default is 10000 kilobytes (10MB). Press <Return> to accept the default. To change the default value, enter a new value.

3. This prompt is displayed if you select local disk caching. 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. Entegrity recommends that you dedicate a disk partition for DFS caching and use that directory name as the cache directory (for disk caching only). For cluster configurations, the cache directory must be member specific. The dfssetup script will make the cache directory member specific (CDSL) during cluster configuration.

4. Choose the default to overwrite the existing DFS configurations.

   NOTE: If you have esisting DFS configurations on some cluster members, and wish to preserve them, then answer "N". Otherwise all cluster members will be configured.

5. Enter the principal cell name and press <return>

   Enter your password and press <return>.

Configuration Options

DFS Client:                      YES

Cache type:                      Disk

Cache size:                      10000

Cache directory:                 /opt/dcelocal/var/adm/dfs/cache

Remote configuration overwrite:  YES

Cell admin account:              cell_admin

Cell admin password:             *****

Confirm the configuration choices (y/n) [y] :  <return>  	6

Configuring Cluster Member: clu1

clu1:               

clu1:               Remote configuring DFS client

clu1:               

clu1:       DFS Client:                      YES

clu1:       Cache type:                      Disk

clu1:       Cache size:                      10000

clu1:       Cache directory:                 /opt/dcelocal/var/adm/dfs/cache

clu1:       Remote configuration overwrite:  YES

clu1:       Cell admin account:              cell_admin

clu1:       Cell admin password:             *****

clu1:       

clu1:               Starting dfsbind daemon (dfsbind)...

clu1:               Starting dfsd...

clu1:       dfsd: start sweeping disk cache files .... 

clu1:       dfsd: All DFS daemons started.

clu1:               

clu1:               Modifying DFS system startup procedure...

clu1:               

clu1:               Remote DFS client configuration completed.

clu1:               

clu1:          

Press <RETURN> to continue:                            	7 

1. Confirm the configuration choices presented on the screen by pressing <return>. The screen then indicates steps until completion.

2. Press <return> to continue to other operations.

The following message appears on the output when DFS is configured on a TruCluster System. This is due to a limitation of the CFS file system and should be corrected in a future version of the TruCluster software. The message indicates that the DFS file cannot be mounted on the machine in the cluster and therefore DFS will not function. This message does not appear on Sierra Cluster 2.0 machines.

clu1:       dfsd: can't mount DFS on /... (code 0)

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

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

Copyright © 1997-2002 Entegrity Solutions Corporation & its subsidiaries