mongoctl - GitLite

KO | EN

gitlite — search

#javascript #react #llm #golang #go #rust #linux #docker #java #windows #cli #kubernetes #security #pytorch

mongoctl

(★ 178)

Manage MongoDB servers and replica sets using JSON configurations!

File Explorer

Download Latest Version (.zip)

- mongoctl
- command-reference.md
- configuring-mongoctl.md
- connecting.md
- installing-pip.md
- managing-clusters.md
- managing-installations.md
- managing-servers.md
- quick-start.md
- - __init__.py
  - command_utils.py
- - __init__.py
  - base.py
  - cluster.py
  - mongod.py
  - mongos.py
  - replicaset_cluster.py
  - server.py
  - sharded_cluster.py
- - __init__.py
  - clusters.config
  - mongoctl.config
  - servers.config
- - __init__.py
  - auth_replicaset_test.py
  - basic_test.py
  - cmdline_servers_test.py
  - install_test.py
  - master_slave_test.py
  - misc_test.py
  - multi_mongodb_versions_test.py
  - replicaset_test.py
  - sharded_test.py
  - ssl_replicaset_test.py
  - test_base.py
  - test_suite.py
  - version_functions_test.py
- __init__.py
- binary_repo.py
- config.py
- errors.py
- mongo_uri_tools.py
- mongo_utils.py
- mongoctl.py
- mongoctl_command_config.py
- mongoctl_globals.py
- mongoctl_logging.py
- mongoctl_signal.py
- mongodb_version.py
- processes.py
- prompt.py
- repository.py
- users.py
- utils.py
- version.py
.gitignore
LICENSE.txt
MANIFEST.in
mongo_latest_stable_version.txt
README.md
setup.py

# Installation Guide

1. Get the code

git clone https://github.com/mongolab/mongoctl

Downloads the entire project code from GitHub to your computer.

cd mongoctl

Moves into the project folder you just downloaded.

2. Python

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Python 3 On Windows, be sure to check 'Add Python to PATH' during installation.

% pip install mongoctl

Installs the Python libraries listed in requirements.txt (or similar).

% pip install --upgrade mongoctl

Installs the Python libraries listed in requirements.txt (or similar).

% pip uninstall mongoctl

Type this command into your terminal and run it.

% python -m mongoctl.tests.test_suite

Runs the Python script (or module).

✅ If it runs without errors and prints output in the terminal, it worked.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Overview
--------

`mongoctl` is a lightweight command line utility that simplifies the
installation of MongoDB and management of MongoDB servers and replica set
clusters. It is particularly useful if you maintain many MongoDB environments
with lots of configurations to manage.

The core philosophy behind `mongoctl` is that all server and cluster
configuration be defined declaratively as data, rather than procedurally as
code or scripts. So, instead of typing shell commands with lots of options that
you can never remember, or writing a bunch of shell scripts hard-coded with
hosts, port numbers, and file-system paths, you simply define the universe of
servers and clusters with JSON objects and pass them to `mongoctl` commands.
Server and cluster definitions can reside in flat-files, behind a web-server
(like Github for instance), or in a MongoDB database.

#### Usage

```
Usage: mongoctl [<options>] <command> [<command-args>]

A utility that simplifies the management of MongoDB servers and replica set clusters.

Options:
  -h, --help            show this help message and exit
  -v, --verbose         make mongoctl more verbose
  -n, --noninteractive  bypass prompting for user interaction
  --yes                 auto yes to all yes/no prompts
  --no                  auto no to all yes/no prompts
  --config-root CONFIGROOT
                        path to mongoctl config root; defaults to ~/.mongoctl

Commands:
  Admin Commands:
    install-mongodb           - install MongoDB
    uninstall-mongodb         - uninstall MongoDB
    list-versions             - list all available MongoDB installations on this machine

Client Commands:
    connect                   - open a mongo shell connection to a server
    dump                      - export MongoDB data to BSON files (using mongodump)
    restore                   - restore MongoDB (using mongorestore)

Server Commands:
    start                     - start a server
    stop                      - stop a server
    restart                   - restart a server
    status                    - retrieve status of server
    list-servers              - show list of configured servers
    show-server               - show server's configuration
    tail-log                  - tails a server's log file
    resync-secondary          - Resyncs a secondary member

Cluster Commands:
    configure-cluster         - initiate or reconfigure a cluster
    list-clusters             - show list of configured clusters
    show-cluster              - show cluster's configuration

Miscellaneous:
    print-uri                 - prints connection URI for a server or cluster

See 'mongoctl <command> --help' for more help on a specific command.
```

Installation
------------------------------

#### Requirements

* Linux or MacOSX (`mongoctl` does not currently support Windows) 
* Python 2.6 or 2.7 (3.x not yet supported)
* pip >= 1.0.2 ([instructions on installing pip](docs/installing-pip.md))
* If planning to build MongoDB from source, i.e. with `mongoctl install-mongodb
  --build-from-source`: the `scons` tool (typically available in your package
  manager, such as `apt`, `yum/dnf` or `brew`.)

#### Supported MongoDB versions

`mongoctl` supports MongoDB versions >= 1.8.

#### Installing mongoctl

`mongoctl` is registered in the [Python package
index](https://pypi.python.org/pypi/mongoctl) (PyPI).

Note: you may need to prefix these commands with ``sudo`` if you're using a
system-level Python install (i.e. if running ``pip`` by itself results in
permissions errors.) For example, ``sudo pip install mongoctl`` will install
``mongoctl`` to your system Python.

To install:

```
% pip install mongoctl
```

To update:

```
% pip install --upgrade mongoctl
```

To uninstall:

```
% pip uninstall mongoctl
```

#### Running mongoctl's test suite

To run mongoctl's test suite, execute the following command:

```
% python -m mongoctl.tests.test_suite
```

Note: executing the test suite will download and install a temporary copy of
MongoDB (cached in a subfolder of `mongoctl/tests`) for use while testing.

Documentation
----------

* [Quick-start guide](docs/quick-start.md)
* [Configuring mongoctl](docs/configuring-mongoctl.md)
* [Managing MongoDB installations](docs/managing-installations.md)
* [Managing servers](docs/managing-servers.md)
* [Managing clusters](docs/managing-clusters.md)
* [Connecting to servers with the mongo shell](docs/connecting.md)
* [Command reference](docs/command-reference.md)