User Files | HP UX Encrypted Volume and Filesystem (EVFS) specification

User Files

EVFS uses the following directories and files for configuration and other runtime data:

•/etc/evfs/emd: Default directory for storing backup EMD data.

•/etc/evfs/evfs.conf: Configuration file for global EVFS parameters, such as the recovery user name, encryption algorithm for volume data encryption, and directories for the user key database.

•/etc/evfs/evfs_cryptx.conf: Configuration file for encryption libraries. Do not modify this file.

•/etc/evfs/evfstab: File containing information about EVFS volumes. The evfsadm utility adds and deletes entries for EVFS volumes in this file. Administrators need to modify this file only when configuring the autostart feature.

•/etc/evfs/pkey: Default parent directory for the user key database.

•/etc/evfs/pkey/evfs: Default parent directory for recovery user public keys.

•/etc/rc.config.d/evfs: Global EVFS configuration file read at system startup.

142 Product Specifications

Image 142

HP UX Encrypted Volume and Filesystem (EVFS) manual User Files

Contents

Encrypted Volume and File System v1.1 Administrators Guide Trademark Notice Table of Contents Preparing Evfs for Configuration Upgrading from Evfs v1.0 to Evfs Administering Evfs 101 129 145 141153 169 171Page List of Figures Software TypesPage List of Tables Page Document Organization About This DocumentIntended Audience Typographic Conventions HP Encourages Your Comments Related InformationUser input Evfs provides the following features Features and BenefitsEvfs Introduction LVM DLO Support Evfs Architecture Encryption Metadata EMD Evfs Data FlowEvfs Encryption Keys Using HP-UX Trusted Computing Services with Evfs Volume Encryption KeysUser Keys 3illustrates how Evfs uses keys to enable an Evfs volume How Evfs Uses Keys File Names Key Names and Key IDsUser Key and Passphrase Storage Alternate Storage Databases and Distributed Key Storage User Key Privileges Summary of Key Type and Privileged User Capabilities Evfsadm Evfs CommandsEvfsvol utility configures and manages the Evfs volumes Evfspkey Supported Software Software Types Product Limitations and Precautions Evfs Introduction Possible Device File Collision Known ProblemsSymptoms Workaround Feedback and Enhancement Requests Installation Hardware Requirements System RebootPrerequisites Operating System Requirements Swinstall utility will install the Evfs components Installing EvfsUse the following procedure to install Evfs Log on to the target system as the root user Upgrading from Evfs v1.0 to Evfs Preparing Evfs for Configuration Verifying for Preconfiguration Preparation Overview Start the Evfs subsystem. See Starting the Evfs Subsystem Creating the User Group Configuring an Alternate Evfs Pseudo-UserSetting the evfsuser Attribute Creating the Evfs Pseudo-User Account Preparing Evfs for Configuration Private keys Optional Configuring Alternate Key Database DirectoriesKeys Passphrases that secure user private keys Default pubkey, privkey and passkey Attribute Statements Key Storage Directory Requirements Example NFS Directory for Public and Private Keys Example Alternate Directory for Public KeysExample Fallback Directory for Nonprivileged Users Datacipher EmdbackupOptional Modifying Evfs Global Parameters Pbe Example Starting the Evfs SubsystemEvfsadm start -n numberthreads Guidelines for Creating User Keys Creating Keys for Evfs Volume OwnersCreating User Key Pairs Evfspkey keygen -p-s -c cipher -u user -k keyname Examples Creating Recovery KeysStoring the recovery users Private Key Evfspkey keygen -c rsa-2048 -r -k keyname Rsa-2048 RSA 2048-bit keys Creating Keys for authorized usersEncrypted file User name as the key name # evfsadm start ExamplesUser Session # evfspkey keygen -u root -k rootkey1Page Configuring an Evfs Volume Configuration Overview Option 1 Creating a New Evfs Volume Before using this procedure, you must complete the tasks Creating an LVM or VxVM Volume for Evfs Configuring an Evfs VolumeCreating Evfs Volume Device Files Evfsadm map volumepath Creating the EMD Optional Adding Recovery Keys and authorized user Keys Evfsvol add -u user -k keyname evfsvolumepath where Enabling the Evfs VolumeSpecifies that the key pair is a recovery key pair Evfsvol enable -p-k keyname evfsvolumepath Option, you must add a key ID to the entry Etc/evfs/evfstab file for this volume and have a storedSpecifies non-interactive mode. Evfs uses the key ID from Evfsvol prompts you for the passphrase for the private key Creating a New File System with newfs Creating and Mounting a File System on an Evfs VolumeOptional Using fsck to Check the File Volume # newfs -F vxfs /dev/evfs/vg01/rlvol5 Creating the Mount Point Mount the File System on the Evfs VolumeOptional Adding an Entry to /etc/fstab Dev/evfs/vg01/lvol5 /opt/encrypteddata vxfs defaults 0 Evfsadm stat -a Evfsvol display evfsvolumepath Verifying the ConfigurationEvfsvol display evfsvolumepath Evfsadm stat -a Remount the file system using the mount command Optional Migrating Existing Data to an Evfs Volume Optional Configuring the Autostart Feature Dev/vg01/lvol5 /dev/evfs/vg01/lvol5 init.initkey bootlocal See evfstab4 for more information Backing Up Your Configuration Page Map the regular volume to an Evfs volume Preparing the File System and Data Iencrypt Inline Encryption Mount the file system to the Evfs volumePerforming Inline Encryption Start inline encryption Configuring an Evfs Volume Verifying the Configuration Remount the file system using the mount command # strings /dev/vg01/lvol5 grep TOP Secret Optional Configuring the Autostart Feature Example Backing Up Your Configuration Option Existing size is 96 MB we now extend it by 4 MB, to 100 MB Existing size is 96 MB we now extend it by 4 MB, to 100 MB Page Administering Evfs Starting and Stopping Evfs Enabling Encryption and Decryption Access to Evfs VolumesStarting the Evfs Subsystem Causes Evfs to use a stored passphrase to enable encryption Disabling Encryption/Decryption Access to Evfs VolumesUses the user name as the key name Enter the following evfsadm stop command evfsadm stop Evfsvol disable -p evfsvolumepathEvfsvol disable -a Stopping the Evfs Subsystem Opening Raw Access to Evfs Volumes Closing Raw Access to Evfs Volumes Managing Evfs Keys and Users Displaying Key IDs for an Evfs VolumeInformation for the volume Restoring User Keys User To execute this command evfsvol prompts you for Changing Owner Keys for an Evfs VolumeCorresponds to a recovery users key in the EMD. If you do Specifies the name of the file containing private key that Changing the Passphrase for a Key Recovering from Problems with Owner KeysRemoving Keys from an Evfs Volume Evfspkey delete -u username-r -p -k keyname Evfspkey passgen -r recovkeyfile where Evfspkey passgen -u username -k keynameEvfspkey passgen -f-p-s -u username -k keyname where Recovering from EMD Corruption EMD Backup Directory Removing a Volume from the Evfs Subsystem # evfsvol destroy /dev/evfs/vg01/lvol5 Exporting and Importing Evfs Volumes Exporting an Evfs Volume Use the following evfspkey keygen command syntax Evfspkey keygen -c cipher -u user -k keyname Key owners name and keyname is the key name Importing an Evfs VolumeIs the key owners name and keyname is the key name Administering Evfs Managing Data on Evfs Volumes Creating a New Evfs Volume Overwrites Existing Data Vxresize -F Might Cause Data Loss or Corruption LVM Example Increasing Volume and File System Sizes Resizing Evfs Volumes and File SystemsCorrect LVM Example Reducing Volume and File System Sizes Incorrect VxVM Example Increasing Volume and File System Sizes VxVM Example Reducing Volume and File System Sizes # fsadm -F vxfs -b 65536 /test5 Backing Up and Restoring Data on Evfs Volumes Backing Up Evfs Volumes Backup Types with LVM or VxVM Mirrored Volumes Backup Types with Nonmirrored Volumes Map the backup volume to EVFS. For example Backups Using LVM Mirrored VolumesThis creates the device files /dev/evfs/vg01/lvol5backup Evfsvol check -r evfsvolumepath Dev/vg01/lvol5backup Syntax is as follows # evfsvol display /dev/evfs/vg01/lvol6 Evfsvol check -r evfsvolumepath Disable the Evfs backup volume. For example Creating Cleartext Backup Media LVM Mirrored Volumes Example File Utility Backups Using VxVM Mirrored Volumes Map the backup VxVM volume to EVFS. For example # evfsvol raw /dev/evfs/vx/dsk/testdg/backupvol Backing Up and Restoring Data on Evfs Volumes # vxplex -g testdg -v vol05 dis vol05-02 # evfsvol enable -k mykey /dev/evfs/vx/dsk/testdg/backupvol Evfsvol check -r evfsvolumepath # fsck -F vxfs /dev/evfs/vx/rdsk/testdg/backupvol Backing Up Evfs Volumes Example Block Device Utility Creating Cleartext Backup Media VxVM Mirrored VolumesExample File Utility Backups Using Nonmirrored Volumes # evfsvol raw /dev/evfs/vg01/lvol5 Evfsadm stat -a Cp -r /opt/encrypteddata /opt/evfsbackup Restoring Backup Media Restoring Backup Data from an Evfs Volume to an Evfs Volume # cp -r /opt/backupevfs /opt/encrypteddata 128 Troubleshooting Evfs Troubleshooting Tools Overview Evfsadm stat -a-s-z Displaying Evfs Volume InformationDisplaying I/O and Encryption Statistics evfsadm stat Meaning of each field is as follows ADisplays the EMD information for all enabled Evfs volumes Number of data blocks encrypted Size of the encrypted metadata EMD area, in kilobytes Verifying the EMD evfsvol check Syntax Verifying User Keys evfspkey lookup # evfspkey lookup -u root -k rootkey1 Key ID root.rootkey1 Evfspkey Cannot Generate Key Pairs Problem ScenariosEvfspkey Cannot Store Keys Evfsvol create Fails, Valid EMD Already Exists Evfsvol Cannot Retrieve Private KeySee the evfstab4 man page for more information Evfsadm map command returns the following error Evfsvol disable Fails, Evfs Volume Is BusyEvfsvol disable command returns the following error Evfsadm map Fails, Invalid Device Resets the dirty bit for the specified volume Evfsvol check -r -aevfsvolumepathwhereEMD Is Dirty Reporting Problems Collecting Data 140 Product Specifications User Files Commands and Tools Evfs provides the following commands 144 Evfs Quick Reference This appendix contains reference information about Evfs Configuring Evfs Preparing Evfs Option 1 Creating New Evfs Volume # evfsadm map volumepath Perform inline encryption Start inline encryption Evfs Tasks and Commands Table B-1 Starting and Stopping Evfs Table B-3 Managing Evfs Keys and Users Table B-4 Troubleshooting Evfs 152 Evfs and Serviceguard Overview Using Evfs with ServiceguardRequirements Restrictions Evfs Attribute Definition File ADF Installing Evfs Creating a VxVM Serviceguard Storage Structure Creating the Serviceguard Storage InfrastructureCreating an LVM Serviceguard Storage Infrastructure Configuration Node Adoptive Nodes Adding the Cluster Keys to the EMD Configuring Evfs on the Configuration NodeCreating a Cluster Key Pair Modifying /etc/evfs/evfstab Entries # vgchange -a n /dev/vg02 Preparing Evfs Volumes for Adoptive Nodes# vxdg deport evfsdg Restoring the Cluster Key Pair Files Configuring Evfs Volumes on the Adoptive NodesCopying the Evfs Configuration Files and Keys Creating a Local Passphrase File Modifying the /etc/evfs/evfstab File Mapping the LVM or VxVM Volumes to EvfsDeactivating the Volumes Verifying Evfs Configuring the Autostart Feature Halting an Existing Package Configuring Serviceguard using Modular packagesInstalling the Evfs Attribute Definition File Copying the Evfs Control and Module Scripts Adding the Evfs package to the Configuration File Creating a Modular Package Configuration FileMigrating a Legacy Package Configuration File # cmmigratepkg -p pkgname -o outputfile.conf where Verifying the Script Adding the Evfs Volumes to the Package Configuration FileLVM and VxVM Modular package example Creating a Package Control Script Configuring Serviceguard using Legacy packagesCreating the Package Configuration File Converting a Package Control Script Modifying the Package Configuration File Adding the Evfs Volumes to the Package Control ScriptInstalling the Evfs Control Script LVM and VxVM Legacy package example Glossary AES Volume Index EMD Permissions, 85 /etc/rc.config.d/evfs, 62, 72 RSA Vxresize command Renaming