User Guide: DSim Cloud CLI initialize command

Synopsis

mdc init[ialize] [options]

In the v2.0 release of DSim Cloud, the initialize command will no longer start a remote workspace and will only create the local workspace for use with all DSim Cloud tools. Prepare for the new behaviour by using mdc init --local-only, then start an interactive workspace using mdc start.

The initialize command will initialize the current working directory as the local workspace for a DSim Cloud Interactive workspace. A folder .mdc will be created within the specified working directory (default: current working directory) which will contain metadata, identifying this directory as the local workspace root directory. When using the --local-only option the command would exit after completing this step.

When the --local-only option is not specified the initialize command will also start a remote workspace in the cloud. The configuration of the remote workspace (memory, CPUs) is fixed and details can be found in DSim Cloud CLI remote cloud compute configuration. The process of starting a remote workspace can take up to 4 minutes. During the process you will see informative messages printed to the local terminal indicating the steps being undertaken during remote workspace startup.

Attempting to initialize in a directory without write permission will fail with an error printed to the screen.

When intializing a new remote workspace, all files within the local workspace directory (other than those specified in the sync_ignore file) will be automatically synchronized to the remote workspace. For more information on the file synchronization process see the DSim Cloud File Synchronization article.

For more information on workspaces, see the Understanding Workspaces article.

Options

--size s4 | -s s4 Initialize an s4 remote cloud compute with 4GB RAM. This option is ignored when used with --local-only. Will be deprecated in v2.0 by the same option in mdc start.

--size s8 | -s s8 Initialize an s8 remote cloud compute with 8GB RAM. This option is ignored when used with --local-only. Will be deprecated in v2.0 by the same option in mdc start.

If no options are given, initialize an s4 remote cloud compute.

Your cost varies depending on the remote cloud compute machine chosen. See DSim Cloud Pricing for current pricing. All prices and dollar values are in USD.

--timeout | -t <timeout> Initialize with a remote timeout different than the default 20 minutes. This option is ignored when used with --local-only. Will be deprecated in v2.0 by the same option in mdc start.

The value of timeout is in minutes and must be a positive integer between 1 and 120.

--local-only | -L Initialize a local workspace for use with all DSim Cloud Tools

Example(s)

mdc initialize

mdc init -s s8

mdc initialize --timeout 65

mdc init -s s4 -t 30