blob: b343665f4234f777a759bfca03e6ac97081e963e [file] [log] [blame]
// Licensed to the Apache Software Foundation (ASF) under one or more
// contributor license agreements. See the NOTICE file distributed with
// this work for additional information regarding copyright ownership.
// The ASF licenses this file to You under the Apache License, Version 2.0
// (the "License"); you may not use this file except in compliance with
// the License. You may obtain a copy of the License at
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// See the License for the specific language governing permissions and
// limitations under the License.
= Cross-Platform Support
== Overview
Starting with version 2.4, Ignite.NET supports .NET Core. It is possible to run .NET nodes and develop Ignite.NET
applications for Linux and macOS, as well as Windows.
== .NET Core
*[.NET Core SDK 2.0+, window=_blank]
*[Java 8+, window=_blank] (macOS requires JDK, otherwise JRE works)
*Running Examples*[Binary distribution, window=_blank] includes .NET Core examples:
* Download[binary distribution, window=_blank] from the Ignite website and extract into any directory.
* `cd platforms/dotnet/examples/dotnetcore`
* `dotnet run`
== Java Detection
Ignite.NET looks for a Java installation directory in the following places:
* `HKLM\Software\JavaSoft\Java Runtime Environment` (Windows)
* `/usr/bin/java` (Linux)
* `/Library/Java/JavaVirtualMachines` (macOS)
If you changed the default location of Java, then specify the actual path using one of the methods below:
* Set the `IgniteConfiguration.JvmDllPath` property
* or set the `JAVA_HOME` environment variable
== Known Issues
*No Java runtime present, requesting install*
Java `8u151` has a known bug on macOS:[JDK-7131356, window=_blank]. Make sure to install `8u152` or later.
*Serializing delegates is not supported on this platform*
.NET Core does not support delegate serialization, `System.MulticastDelegate.GetObjectData`
just[throws an exception, window=_blank],
so Ignite.NET can not serialize delegates or objects containing them.
*Could not load file or assembly 'System.Configuration.ConfigurationManager'*
Known[.NET issue (506), window=_blank], in some cases additional package reference is required:
* `dotnet add package System.Configuration.ConfigurationManager`