Licenses & Nodes

From Obsidian Scheduler
Jump to navigationJump to search

Each running Obsidian scheduler process requires a valid license. Here are some quick facts:

  • When you download Obsidian, it automatically obtains a free license key, which gives you one free license for permanent use, and a second license valid for one year. This lets you run a cluster of two nodes for one year, and you can continue to use a single scheduler instance forever at no charge.
  • Running the admin web app without scheduler does not require a license when used in conjunction with licensed instances.
  • All standard licenses are floating, meaning they are not restricted to particular hardware and can be moved around as needed.
  • Running scheduler instances must have access to the Internet to lease and verify the license.
  • Every license key has one or more valid licenses associated with it.

License Verification

The default Obsidian license requires a a live Internet connection to validate clustered scheduler instances. If you are running a single instance, this check is bypassed.

Obsidian's license verification is built to handle sporadic outages to Internet connectivity. Customers using paid licenses can generally expect grace periods of over 48 hours during which Internet connectivity is not available. Obsidian will automatically attempt to re-validate your license key on a schedule based on configurable settings which control License Leasing

Obsidian also provides a license proxy should you wish to restrict Internet access to a single server. Obsidian instances can then be directed to the deployed license proxy.

Obsidian also supports hardware licenses. These are tied to deployment hardware and are not floating. Contact Carfey Software for further details.

As of Obsidian 2.1, Obsidian can also be run under a site license. When Obsidian is run under a site license, no Internet connectivity and verification is required and an unlimited number of nodes are permitted within the licensed organization. Contact Carfey Software for further details.


Nodes are individual instances of Obsidian scheduler. Nodes can be running standalone, within the admin web app or embedded in an existing JVM application. Nodes typically are deployed one per host, but Obsidian supports multiple nodes per host. Each running host uses the hostname to designate the node running each scheduled instance of a job. Subsequent instances on the same host will suffix an ordinal to the end of the hostname. Optionally, you can specify a configuration property (see Advanced Configuration) or provide a System property (see Getting Started) choosing the host designator you wish to use.

No extra work, special configuration or administration is required to add nodes. Simply setup the environment, ensure a node license is available and start it up. The same holds true for shutting down.

Nodes can be gracefully brought down out of the pool, allowing them to complete any in-process work while no longer claiming and proccessing any subsequently scheduled work. Graceful shutdown in the web embedded scheduler, either in the web admin app or your own web app, requires using the container's shutdown. Starting and stopping a standalone version of the scheduler uses a listener port to support graceful shutdown. See the Getting Started guide for details.

License Leasing

When an Obsidian instance is validated, a license is locked to the leasing node. Other nodes or instances will not be able to use this license until the lease expires. After the lease time elapses (configured in scheduler settings screen, or in the key proxy properties file), it is available for other nodes. In the meantime, if the instance goes down and you attempt to start a node in another location, the license will not be available for lease. If you restart the node in the same location, it will reacquire the same license.

You can customize the leasing settings in the scheduler settings screen under the License category. Key settings include clientKeyRefreshMinutes and clientKeyLeaseLengthMultiple, which are documented on that page. Changing these settings allows you to find the right balance between tolerance for Internet outages, and the ability to deploy a used Obsidian license to a new installation which having to wait for locked licenses to expire.

Your License Key

You can find your license key in Scheduler Settings as shown below.

Obsidian will automatically acquire your free single node license and a second trial clustering node license which is valid for a year. If you are converting your trial backup node license to a paid license or are purchasing additional nodes, you can obtain your license key from the location show below.

ClientKey 4.0.png