Library Version 12.1.3.0

Chapter 3. Plans
Prev |  | Next

## Chapter 3. Plans

This chapter describes `plans`, which are useful to perform the configuration of your store. If you are installing a store for the first time, you can skip ahead to the next chapter Configuring the KVStore.

You configure Oracle NoSQL Database with administrative commands called plans. A plan is made up of multiple operations. Plans may modify state managed by the Admin service, and may issue requests to kvstore components such as Storage Nodes and Replication Nodes. Some plans are simple state-changing operations, while others may be long-running operations that affect every node in the store over time.

For example, you use a plan to create a Zone or a Storage Node or to reconfigure the parameters on a Replication Node.

## Using Plans

You create and execute plans using the `plan` command in the administrative command line interface. By default, the command line prompt will return immediately, and the plan will execute asynchronously, in the background. You can check the progress of the plan using the show plan id command.

If you use the optional `-wait` flag for the plan command, the plan will run synchronously, and the command line prompt will only return when the plan has completed. The `plan wait` command can be used for the same purpose, and also lets you specify a time period. The -wait flag and the plan wait command are particularly useful when issuing plans from scripts, because scripts often expect that each command is finished before the next one is issued.

You can also create, but defer execution of the plan by using the optional `-noexecute` flag. If -noexecute is specified, the plan can be run later using the `plan execute -id <id>` command.

### Feedback While a Plan is Running

There are several ways to track the progress of a plan.

- The `show plan -id` command provides information about the progress of a running plan. Note that the `-verbose` optional plan flag can be used to get more detail.

- The Admin Console's Topology tab refreshes as Oracle NoSQL Database services are created and brought online.

- You can issue the `verify` command using the Topology tab or the CLI as plans are executing. The `verify` plan provides service status information as services come up.

  ### Note

  The Topology tab and verify command are really only of interest for topology-related plans. For example, if the user is modifying parameters, the changes may not be visible via the topology tab or verify command.

- You can follow the store-wide log using the Admin Console's Logs tab, or by using the CLI's `logtail` command.

Prev |  | Next
Installation Configuration | Home | Plan States