OrangeFS Config File

The OrangeFS installation directory on the Build system will need an OrangeFS configuration file. You will enter basic information for this file in a program called pvfs2-genconfig. Once the configuration file has been created, you might need to make additional modifications (regarding security, for example) for the initial deployment.

Note After standard installation, consult the Administration Guide for details on the options and values available for fine tuning the configuration file.

To create the OrangeFS configuration file, follow these steps:
1. Using pvfs2-genconfig, the configuration file will be automatically

generated as follows:
/opt/orangefs/bin/pvfs2-genconfig /opt/orangefs/etc/orangefs-server.conf.

The program presents a series of prompts to enter the required settings for your OrangeFS configuration file.

2. Answer all the prompts to generate the configuration file in the etc

directory. Following is a list of possible entries for these prompts:

Option/Setting
Default/Example Value
Description
Protocol
tcp

Protocol choices are tcp, gm, mx, ib and portals. Default is tcp. For multi-homed configurations, separate multiple protocols with commas, for example ib, tcp

Data Directory
/opt/orangefs/storage/data
Full path + directory name where each OrangeFS server will store its data.  

Metadata Directory
/opt/orangefs/storage/meta. Full path + directory name where each OrangeFS server will store its metadata.

Log Directory.
/var/log/orangefs-server.log. Full path + file name where each server will write its log messages.

Server Host Names
Default: localhost
Example: ofs{1-4}
Hostname of each OrangeFS data server (server on which data directory is located). This should be the value returned by the hostname command. Syntax is node1, node2, … or node{#-#,#,#}.

Data/Metadata Allowed
Default: yes
Enter yes to keep metadata directory on same server as data directory.
If you enter no, you are prompted to enter additional hostnames.

Security Options  
Options that display for security are based on the security mode you chose when you built OrangeFS. The three security modes are default, key-based or certificate-based.  

Note Standard installation, as configured above, places file system storage directories inside the OrangeFS installation directory under opt for portability. These directories can be located elsewhere for system optimization and larger space allocations. For detailed information on all options in the OrangeFS configuration file, see the Administration Guide.

When you are finished running pvfs2-genconfig, the OrangeFS configuration file is added to /opt/orangefs/etc.

The configuration file is a simple text file that can be opened and modified manually. While pvfs2-genconfig will query you about the most important options, default values are assigned to many additional options. You can consider changes for most of these defaults later after installation, when you can reference the Administration Guide for performance-tuning and optimization.