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. The 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: November 27th, 2018

  • For a period of 365 days after the End of Marketing Date, through November 27th, 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 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 for the Gremlin equivalent modelling
    • /schema (indexing) and /index: See for 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.

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

Add Comment
No Comments

Leave a Reply

Your email address will not be published.Required fields are marked *

More Products Stories

The Power of Profiling: How automated classification aids data governance

Intelligent, flexible classification capabilities within IBM Watson Data Platform help users govern, prepare, integrate and analyze data quickly

Continue reading

You’ve built your data catalog – now what?

How an integrated data science platform can transform your ability to make productive use of big data Leverage an integrated data and analytics toolset that makes data science smooth and seamless Unlock self-service big data analytics for users of all skill levels – from data scientists to citizen analysts Get a new end-to-end data science workflow up and running within a day

Continue reading

IBM Data Catalog Now Generally Available

We hope you have been having a great experience discovering, cataloguing and governing data with IBM Data Catalog as part of IBM Watson Data Platform. We’d like to inform you that the Data Catalog service is now generally available (GA), and all Beta plan instances will be retired on January 31, 2018.

Continue reading