Data Analytics

Announcing retirement of IBM Graph, availability of Compose for JanusGraph

Share this post:

Compose for JanusGraph graph database

We are announcing the retirement of the IBM Graph service on November 27th, 2017. This service is being replaced by Compose for JanusGraph, see below for detailed steps on how to migrate to our new service. The graph database technology at the core of IBM Graph, Titan, has evolved to JanusGraph, which is governed by the Linux Foundation. We are excited to bring this technology, as a production-ready, managed service, to the IBM Cloud.


Here’s what you need to know:

End of Marketing Date: November 27th, 2017

As of November 27th, 2017, new IBM Graph instances cannot be provisioned. However, existing instances will continue to be supported.

End of Support Date: April 24th, 2018

  • For a period of 148 days after the End of Marketing Date throughApril 24th, 2018, all existing instances will continue to be available on the Services dashboard in the Bluemix console. All existing instances will also continue to be supported by IBM Graph
  • Any instance still provisioned as of the End of Support Date will be deleted. Please extract data that is still desired as soon as possible
  • Please remember to delete your IBM Graph service instances before the End of Support Date.

Migration: All IBM Graph users can transition to Compose for JanusGraph available in the IBM Bluemix catalog

Any program that makes calls to IBM Graph must adopt the following changes:

  1. The JanusGraph service uses a different endpoint than the IBM Graph service. Users will need to update the service endpoint they’re sending requests to, including the authentication.
  2. The JanusGraph service no longer provides the following endpoints: /schema, /gremlin, /bulkload, /graphs, /index, /vertices, or /edges.
    If you’re using any of these commands, you must change them to send the corresponding gremlin for completing these actions.

    • /schema (modelling): See the Gremlin equivalent modelling
    • /schema (indexing) and /index: See the Gremlin equivelent indexing
    • /graphs: Graphs are managed in an internal graph which should only be queried. Writing values to this graph will impact the availability of your graphs.
      • list all graphs: janusConfigurationGraph.traversal().V().values(“graph.graphname”);
      • truncate a graph: def graph =; graph.close(); JanusGraphCleanup.clear(graph); (where graph_name is the name of your graph).
    • /gremlin, /vertices, or /edges: Send gremlin commands as shown in this documentation
    • /bulkload: Not currently supported – Users can send gremlin queries for adding the data into JanusGraph using the addVertex() and addEdge() gremlin tasks for each element that needs to be added.
  3. The JanusGraph service no longer provides a graph-specific URL for sending gremlin queries (e.g, https://service_endpoint/service_instance_id/graph_name/gremlin). Users must update their gremlin queries to explicitly open the graph using“graph_name”) and send their gremlin query to the JanusGraph base URI.  Reference:
  4. The JanusGraph service does not currently support mixed indices.  You will need to convert them into composite or vertex centric indexes.  This would be a change to your indexes and schema when you initialize your graph:

For users who have their complete data set locally and tools to upload that data set:

  1. Adapt your tool as described in the previous section.
  2. Stand up a new instance of Compose JanusGraph and run your tool to import the data.
  • You may need to vertically and horizontally scale your JanusGraph Engines temporarily to import your data.  This is currently not available in the Service Management Console.  Contact Bluemix Support to perform this action.
  • You may need to vertically scale your JanusGraph Storage (backend nodes) for optimal performance.  You may do this on service management console by selecting “Scale Resources”.


If you don’t have complete copy of your dataset locally, please submit ticket with Bluemix support to get a copy of your data.


*This version represents a revised timeline of the IBM Graph Deprecation. 

As always, we’re here to help! Reach out to us in the support forums or on Twitter.



Offering Manager // IBM Cloud

More Data Analytics stories
September 3, 2018

IBM Cloud Foundry Enterprise Environment (Beta)

We're excited to release our Beta version of the IBM Cloud Foundry Enterprise Environment. This offering allows users to create and manage isolated Cloud Foundry environments for hosting applications exclusively for their organizations.

Continue reading

August 27, 2018

Announcing VMware vCloud Availability for vCloud Director – Limited Availability

IBM Cloud is excited to announce the limited availability of VMware vCloud Availability for vCloud Director, a disaster recovery solution based on a consumption model that reduces costs significantly and allows you to utilize familiar VMware tooling.

Continue reading

July 16, 2018

Welcome to the New and Improved IBM Cloud Catalog

We are excited to announce that the IBM Cloud Catalog has recently undergone a bit of a makeover. With simplified categories, featured services, and an improved UX design, users can discover IBM Cloud offerings without the need to understand IBM-specific terminology or branding.

Continue reading