ChorusOS 5.0 System Administrator's Guide

Adding Support for File Systems and Related Hardware to your System Image

Adding Support Using the Graphical User Interface Tool Ews

To configure your system image with support for file systems and related hardware through the Ews graphical user interface, follow this procedure:

  1. Open your system image configuration in ews:


    host% cd build_dir
    host% ews conf/ChorusOS.xml &
    
  2. Use the hints in the following tables to set features and tunables for the file system support needed.

    The following table lists the feature and tunable settings required for your ChorusOS system to support the media on which you use file systems.

    Table 4-2 Media Support

    To include support for... 

    Set... 

    Comments 

    Flash memory 

    FLASH=true 

    Flash memory supports only FAT (MS-DOS) file systems.

    IDE hard disk drives

    DEV_DISK=true 

    Enables support for hard disk drives connected to compatible IDE, ST506 and ESDI controllers.

    RAM disk memory

    RAM_DISK=true 

    iom.ramdiskX.size=size_in_hex

    iom.ramdisk.sizeMax= max_RAM_disk_size

    iom.ramdiskX.size, where X is a hexadecimal digit 0, 1, 2, ..., d, e, f, takes a size in the same hexadecimal format as the value for iom.ramdisk.sizeMax. For example, if you want to have one 4MB RAM disk use iom.ramdisk0.size= 0x40000.

    SCSI hard disk drives

    SCSI_DISK=true 

    Enables support for SCSI-PCI I/O processors of the NCR53C8xx family.

    SCSI CD-ROM disk drives

    DEV_CDROM=true 

    Enables support for SCSI CDROM drives.

    The following table summarizes the feature and tunable settings required for your ChorusOS system to support specific file systems.

    Table 4-3 File System Support

    To include support for... 

    Set... 

    Comments 

    FAT (MS-DOS) file systems

    MSDOSFS=true 

    iom.nbuf=8 (at least) 

     

    NFS client capability (for mounting NFS file systems)

    NFS_CLIENT=true 

    iom.nbuf=8 (at least) 

     

    NFS server capability (for exporting file systems)

    NFS_CLIENT=true 

    NFS_SERVER=true 

    iom.nbuf=8 (at least) 

    The ChorusOS system can export only local UFS file systems through NFS.

    MS-DOS file systems cannot be exported through NFS.

    Swap file system 

    FS_MAPPER=true 

    ON_DEMAND_PAGING= true (except for PowerPC target family architectures) 

    Swap may only be used on local media. 

    Only one swap device may be used. 

    Swap is only available in the VM memory model, where VIRTUAL_ADDRESS_SPACE =true.

    UNIX (UFS) file systems

    UFS=true 

    iom.nbuf=8 (at least) 

    UFS file systems cannot be used on flash media.

    ISO 9660 

    ISOFS=true 

    iom.nbuf=8 (at least) 

    File System used on CD-ROM media 

    The iom.nbuf tunable sets the number of buffer cache entries. These are the standard buffered entries used for input and output. The larger the value, the larger the cache available. The iom.nbuf tunable, and other tunables, influence the amount of RAM used by the system.

    The iom.kmemsize tunable sets the amount of memory available to the microkernel through kmemalloc.

    The iom.clusterssize and iom.nmbufs set the number of clusters and mbufs used for networking. The larger the value, the larger the number of network requests that can successfully be satisfied.

  3. Save your changes to the system image configuration.

  4. Build the system image.

Adding Support Using Configurator on the Command-Line

To configure your system image with support for file systems and related hardware through the configurator(1CC) command-line interface, follow this procedure:

  1. Change to the directory where you build system images:


    host% cd build_dir
    
  2. Use the hints in the tables provided (see Step 2) to set features and tunables for the file system support needed.

    configurator(1CC) commands to set features and tunables take the form:


    host% configurator -c conf/ChorusOS.xml -set feature | tunable=value
    
  3. Build the system image to include the modifications you have made:


    host% make system_image_name