Uploading Custom Classes

To store and query custom objects, those objects' classes must be on the classpath of your cluster members. In Hazelcast Cloud, you can upload custom classes by dragging and dropping files in the UI.

You may need to upload custom Java classes in the following situations:

  1. You have objects that run on the cluster via clients such as Runnable, Callable and entry processors.

  2. You have new or amended user domain objects

  3. You have your own MapLoader or MapStore implementations.

Before you Begin

You need a cluster that has at least two members (nodes).

Custom classes are uploaded onto clusters by using rolling restart, which relies on shutting down each member one at a time. As a result, your cluster may lose all its data if it consists of a single member.

Your files must be in either zip or jar format and the maximum file size is 500 MB.

Uploaded classes are restricted by a limited set of JSP permissions. If you need your uploaded code to be granted any additional permissions, create a support ticket for it.

To upload custom classes onto a team’s cluster, you must have either an admin or developer role. See Managing Teams and Users.

Uploading Files

To upload JAR files with custom classes, click Upload Custom Classes.

Upload custom classes to an existing cluster

Once you click on it, the following dialog appears where you can drag your file to or select it using the browse link:

Drag and drop custom classes

Once the upload is successfully finished and the progress indicator disappeared, the custom classes are deployed and ready to use:

Successful upload of custom classes

Removing Files

To remove custom classes from the cluster, click Upload Custom Classes, find your class in the list and click on the delete icon next to it.

Remove a custom class from a cluster

Downloading Files

All filenames are downloadable links. You can download your uploaded class files by clicking on their names in the modal window.