@liyuj
2017-02-10T15:00:33.000000Z
字数 8971
阅读 3523
Apache-Ignite-1.8.0-中文开发手册
Ignite有一个独特的功能,叫做Ignite文件系统(IGFS),就是一个分布式的内存文件系统,IGFS提供了和Hadoop HDFS类似的功能,但是只在内存中。事实上,除了他自己的API,IGFS还实现了Hadoop的文件系统API,可以透明地加入Hadoop或者Spark的运行环境。
IGFS将每个文件的数据拆分成独立的数据块然后将他们保存进一个分布式内存缓存中。然而,与Hadoop HDFS不同,IGFS不需要一个name节点,它通过一个哈希函数自动确定文件数据的位置。
IGFS可以独立部署,也可以部署在HDFS之上,这时他成为了一个存储于HDFS中的文件的透明缓存层。
Ignite文件系统(IGFS)是一个内存级的文件系统,他可以在现有的缓存基础设施基础上对文件以及文件夹进行操作。
IGFS既可以作为一个纯粹的内存文件系统,也可以委托给其他的文件系统(比如各种Hadoop文件系统实现)作为一个缓存层。
另外,IGFS提供了在文件系统数据上执行MapReduce任务的API。
IgniteFileSystem
接口是一个进入Ignite文件系统实现的入口,他提供了正常的文件系统操作的方法,比如create
,delete
,mkdirs
等等,以及执行MapReduce任务的方法。
Ignite ignite = Ignition.ignite();
// Obtain instance of IGFS named "myFileSystem".
IgniteFileSystem fs = ignite.fileSystem("myFileSystem");
IGFS可以通过Spring XML文件或者编程的方式进行配置。
XML:
<bean class="org.apache.ignite.configuration.IgniteConfiguration">
...
<property name="fileSystemConfiguration">
<list>
<bean class="org.apache.ignite.configuration.FileSystemConfiguration">
<!-- Distinguished file system name. -->
<property name="name" value="myFileSystem" />
<!-- Name of the cache where file system structure will be stored. Should be configured separately. -->
<property name="metaCacheName" value="myMetaCache" />
<!-- Name of the cache where file data will be stored. Should be configured separately. -->
<property name="dataCacheName" value="myDataCache" />
</bean>
</list>
</property>
</bean>
Java:
IgniteConfiguration cfg = new IgniteConfiguration();
...
FileSystemConfiguration fileSystemCfg = new FileSystemConfiguration();
fileSystemCfg.setName("myFileSystem");
fileSystemCfg.setMetaCacheName("myMetaCache");
fileSystemCfg.setDataCacheName("myDataCache");
...
cfg.setFileSystemConfiguration(fileSystemCfg);
IgniteFileSystem fs = ignite.fileSystem("myFileSystem");
// Create directory.
IgfsPath dir = new IgfsPath("/myDir");
fs.mkdirs(dir);
// Create file and write some data to it.
IgfsPath file = new IgfsPath(dir, "myFile");
try (OutputStream out = fs.create(file, true)) {
out.write(...);
}
// Read from file.
try (InputStream in = fs.open(file)) {
in.read(...);
}
// Delete directory.
fs.delete(dir, true);
Ignite Hadoop加速器提供了一个叫做IgniteHadoopFileSystem
的Hadoop兼容IGFS实现,Hadoop可以以即插即用的形式运行在这个文件系统上,然后显著地减少了I/O和改善了延迟和吞吐量。
Ignite Hadoop加速器在Ignite集群内部执行文件系统操作,必须满足几个前置条件:
1)IGNITE_HOME
环境变量必须设置以及指向Ignite的安装根目录。
2)每个节点都必须在类路径上包含Hadoop的jar文件。可以参照各个Hadoop发行版的Ignite安装向导来了解详细信息。
3)IGFS
必须在集群节点上进行了配置。可以参照13.2.IGFS原生Ignite API
章节来了解如何进行配置。
4)要让IGFS
接收来自Hadoop的请求,需要配置一个端点(默认的配置文件是${IGNITE_HOME}/config/default-config.xml
)。Ignite提供两种类型的端点:
shmem
:工作于共享内存(Windows不可用)tcp
:工作于标准Socket API如果与Ignite节点是在同一台机器上执行文件系统操作那么共享内存端点是推荐的做法。注意如果在共享内存通信模式下port
参数也可以用于执行客户端-服务端握手的初始化。
XML:
<bean class="org.apache.ignite.configuration.FileSystemConfiguration">
...
<property name="ipcEndpointConfiguration">
<bean class="org.apache.ignite.igfs.IgfsIpcEndpointConfiguration">
<property name="type" value="SHMEM"/>
<property name="port" value="12345"/>
</bean>
</property>
....
</bean>
Java:
FileSystemConfiguration fileSystemCfg = new FileSystemConfiguration();
...
IgfsIpcEndpointConfiguration endpointCfg = new IgfsIpcEndpointConfiguration();
endpointCfg.setType(IgfsEndpointType.SHMEM);
...
fileSystemCfg.setIpcEndpointConfiguration(endpointCfg);
TCP端点可以用于或者Ignite节点位于其他机器或者共享内存不可用的场合。
XML:
<bean class="org.apache.ignite.configuration.FileSystemConfiguration">
...
<property name="ipcEndpointConfiguration">
<bean class="org.apache.ignite.igfs.IgfsIpcEndpointConfiguration">
<property name="type" value="TCP"/>
<property name="host" value="myHost"/>
<property name="port" value="12345"/>
</bean>
</property>
....
</bean>
Java:
FileSystemConfiguration fileSystemCfg = new FileSystemConfiguration();
...
IgfsIpcEndpointConfiguration endpointCfg = new IgfsIpcEndpointConfiguration();
endpointCfg.setType(IgfsEndpointType.TCP);
endpointCfg.setHost("myHost");
...
fileSystemCfg.setIpcEndpointConfiguration(endpointCfg);
如果host参数未设置,默认值是127.0.0.1
。
如果port参数未设置,默认值是10500
。
如果ipcEndpointConfiguration未设置,那么对于Linux系统共享内存端点会使用默认的端口,对于WindowsTCP端口会使用默认的端口。
配置Ignite节点后,通过如下方式可以启动:
$ bin/ignite.sh
要使用Ignite作业跟踪器运行Hadoop作业,需要满足如下的前提条件:
1)IGNITE_HOME
环境变量必须设置以及指向Ignite的安装根目录。
2)Hadoop必须在类路径上包含Ignite jar文件:${IGNITE_HOME}\libs\ignite-core-[version].jar
和${IGNITE_HOME}\libs\hadoop\ignite-hadoop-[version].jar
。
这个可以通过若干种方式实现:
HADOOP_CLASSPATH
环境变量;3)对于将要执行的活动必须配置Ignite的Hadoop加速器文件系统,至少要提供文件系统类的全限定名;
XML:
<configuration>
...
<property>
<name>fs.igfs.impl</name>
<value>org.apache.ignite.hadoop.fs.v1.IgniteHadoopFileSystem</value>
</property>
...
</configuration>
如果要将Ignite文件系统设置为默认的文件系统,可以增加如下的属性:
XML:
<configuration>
...
<property>
<name>fs.default.name</name>
<value>igfs:///</value>
</property>
...
</configuration>
这里的value是一个配有IGFS的Ignite节点的端点URL,本章节的末尾会提供这个URL的规则。
如何将配置传递给Hadoop作业有若干种方式:
第一,可以创建独立的带有这些配置属性的core-site.xml
然后用于作业的运行;
第二,可以通过编程的方式为特定的作业设置这些属性。
Java:
Configuration conf = new Configuration();
...
conf.set("fs.igfs.impl", "org.apache.ignite.hadoop.fs.v1.IgniteHadoopFileSystem");
conf.set("fs.default.name", "igfs:///");
...
Job job = new Job(conf, "word count");
第三,在Hadoop环境中可以修改默认的core-site.xml
中的fs.igfs.impl
属性。
警告
在默认的core-site.xml
文件中不要修改fs.default.name
属性,因为HDFS无法启动。可以使用全限定路径访问IGFS,比如这样,igfs:///path/to/file
,而不是/path/to/file
。
如何运行一个作业取决于对Hadoop如何进行配置。
如果创建了独立的core-site.xml
:
hadoop --config [path_to_config] [arguments]
注意使用定制的Hadoop启动器脚本可以轻易的引用一个单独的Hadoop配置目录和Ignite库,比如hadoop-ignited
:
export IGNITE_HOME=[path_to_ignite]
# Add necessary Ignite libraries to the Hadoop client classpath:
VERSION=[ignite_version_identifier]
export HADOOP_CLASSPATH=${IGNITE_HOME}/libs/ignite-core-${VERSION}.jar:${IGNITE_HOME}/libs/ignite-hadoop/ignite-hadoop-${VERSION}.jar:${IGNITE_HOME}/libs/ignite-shmem-1.0.0.jar
hadoop --config [path_to_config_directory] "${@}"
使用IGFS通过这种方式运行一个Hadoop作业,需要运行命令hadoop-ignited ...
,如果要在默认的Hadoop上运行同样的作业,只需要使用同样的参数运行hadoop ...
。
如果通过编程方式启动一个作业,那么提交它:
Java:
...
Job job = new Job(conf, "word count");
...
job.submit();
访问IGFS
的URI具有如下的结构:igfs://[igfs_name@][host]:[port]/
,这里:
igfs_name
:可选的要连接的IGFS的名字(通过FileSystemConfiguration.setName(...))指定的),必须以@
结尾,如果忽略默认为空;host
:可选的Ignite主机端点(IgfsIpcEndpointConfiguration.host
),默认为127.0.0.1
;port
:可选的Ignite端口端点 (IgfsIpcEndpointConfiguration.port
),默认为10500
;URI示例:
igfs://myIgfs@myHost:12345/
:连接到运行在指定主机和端口上的名为myIgfs
的IGFS;igfs://myIgfs@myHost/
:连接到运行在指定主机和默认端口上的名为myIgfs
的IGFS;igfs://myIgfs@/
:连接到运行在localhost和默认端口上的名为myIgfs
的IGFS;igfs://myIgfs@:12345/
:连接到运行在localhost和指定端口上的名为myIgfs
的IGFS;igfs://myHost:12345/
:连接到运行在指定主机和端口上的名字为`null
的IGFS;igfs://myHost/
:连接到运行在指定主机和默认端口上的名字为null
的IGFS;igfs://:12345/
:连接到运行在localhost和指定端口上的名字为null
的IGFS;igfs:///
:连接到运行在localhost和默认端口上的名字为null
的IGFS。Ignite Hadoop加速器包含了一个IGFS
二级文件系统实现IgniteHadoopIgfsSecondaryFileSystem
,它可以对任何Hadoop文件系统
实现进行通读和通写。
要使用二级文件系统,可以在IGFS
配置中指定或者通过编程的方式实现。
XML:
<bean class="org.apache.ignite.configuration.FileSystemConfiguration">
...
<property name="secondaryFileSystem">
<bean class="org.apache.ignite.hadoop.fs.IgniteHadoopIgfsSecondaryFileSystem">
<constructor-arg value="hdfs://myHdfs:9000"/>
</bean>
</property>
</bean>
Java:
ileSystemConfiguration fileSystemCfg = new FileSystemConfiguration();
...
IgniteHadoopIgfsSecondaryFileSystem hadoopFileSystem = new IgniteHadoopIgfsSecondaryFileSystem("hdfs://myHdfs:9000");
...
fileSystemCfg.setSecondarFileSystem(hadoopFileSystem);
在Ignite节点启动过程中,Ignite默认不会在类路径中包含Hadoop的库文件,如果决定使用HDFS
作为一个二级文件系统,那么需要提前按照如下步骤进行操作:
Apache Ignite Hadoop Accelerator
版本(如果自行构建发行版可以使用-Dignite.edition=hadoop);/etc/default/hadoop
文件存在并且有适当的内容。作为一个选择,可以在Ignite节点类路径中手工添加必要的Hadoop依赖,这些依赖的groupId是org.apache.hadoop
,他们已经在modules/hadoop/pom.xml
文件中列出,当前,他们是:
IGFS可以工作于四种操作模式:PRIMARY
,PROXY
,DUAL_SYNC
和DUAL_ASYNC
。这些模式既可以配置整个文件系统,也可以配置特定的路径。他们是在IgfsMode
枚举中定义的,默认文件系统操作于DUAL_ASYNC
模式。
如果未配置二级文件系统,配置成DUAL_SYNC
或者DUAL_ASYNC
模式的所有路径都会回退到PRIMARY
模式。
XML:
<bean class="org.apache.ignite.configuration.FileSystemConfiguration">
...
<!-- Set default mode. -->
<property name="defaultMode" value="DUAL_SYNC" />
<!-- Configure '/tmp' and all child paths to work in PRIMARY mode. -->
<property name="pathModes">
<map>
<entry key="/tmp/.*" value="PRIMARY"/>
</map>
</property>
</bean>
Java:
FileSystemConfiguration fileSystemCfg = new FileSystemConfiguration();
...
fileSystemCfg.setDefaultMode(IgfsMode.DUAL_SYNC);
...
Map<String, IgfsMode> pathModes = new HashMap<>();
pathModes.put("/tmp/.*", IgfsMode.PRIMARY);
fileSystemCfg.setPathModes(pathModes);
该模式中,IGFS作为基本的独立分布式内存文件系统,不会使用二级文件系统。
IGFS对于工作于PROXY模式的路径的操作是受限的,在这些路径上的任何操作都会抛出异常。
该模式中,当数据被请求并且还没有缓存在内存中时,IGFS会在二级文件系统中进行同步地通读,当数据在IGFS中被更新/创建时对其进行同步地通写。实际上,该模式下IGFS是在二级文件系统之上作为一个智能缓存层的。
与DUAL_SYNC
相同,但是对于二级文件系统的读写是异步方式执行的。
在IGFS更新和二级文件系统更新之间存在一个滞后,但是这个模式下更新的性能显著好于DUAL_SYNC
模式。