X-Git-Url: https://git.arvados.org/arvados.git/blobdiff_plain/08d0b1ab43499b7f13462d5e3555d239b4634d22..94081a34c4972cd65a20cbeb4d1837149f057378:/doc/install/arvbox.html.textile.liquid
diff --git a/doc/install/arvbox.html.textile.liquid b/doc/install/arvbox.html.textile.liquid
index 2d94d32ac5..a8235ee70e 100644
--- a/doc/install/arvbox.html.textile.liquid
+++ b/doc/install/arvbox.html.textile.liquid
@@ -14,11 +14,14 @@ Arvbox is a Docker-based self-contained development, demonstration and testing e
h2. Quick start
-$ git clone https://github.com/curoverse/arvados.git
-$ cd arvados/tools/arvbox/bin
-$ ./arvbox start localdemo
+$ curl -O https://git.arvados.org/arvados.git/blob_plain/refs/heads/main:/tools/arvbox/bin/arvbox
+$ chmod +x arvbox
+$ ./arvbox start localdemo latest
+$ ./arvbox adduser demouser demo@example.com
+You can now log in as @demouser@ using the password you selected.
+
h2. Requirements
* Linux 3.x+ and Docker 1.9+
@@ -29,29 +32,40 @@ h2. Usage
$ arvbox
-Arvados-in-a-box http://arvados.org
-
-start|run [tag] start arvbox container
-stop stop arvbox container
-restart stop, then run again
-status print some information about current arvbox
-ip print arvbox docker container ip address
-host print arvbox published host
-shell enter arvbox shell
-open open arvbox workbench in a web browser
-root-cert get copy of root certificate
-update stop, pull latest image, run
-build build arvbox Docker image
-reboot stop, build arvbox Docker image, run
-rebuild build arvbox Docker image, no layer cache
-reset delete arvbox arvados data (be careful!)
-destroy delete all arvbox code and data (be careful!)
-log tail log of specified service
-ls list directories inside arvbox
-cat get contents of files inside arvbox
-pipe run a bash script piped in from stdin
-sv change state of service inside arvbox
-clone clone an arvbox
+Arvados-in-a-box https://doc.arvados.org/install/arvbox.html
+
+start|run [tag] start arvbox container
+stop stop arvbox container
+restart stop, then run again
+status print some information about current arvbox
+ip print arvbox docker container ip address
+host print arvbox published host
+shell enter shell as root
+ashell enter shell as 'arvbox'
+psql enter postgres console
+open open arvbox workbench in a web browser
+root-cert get copy of root certificate
+update stop, pull latest image, run
+build build arvbox Docker image
+reboot stop, build arvbox Docker image, run
+rebuild build arvbox Docker image, no layer cache
+checkpoint create database backup
+restore restore checkpoint
+hotreset reset database and restart API without restarting container
+reset delete arvbox arvados data (be careful!)
+destroy delete all arvbox code and data (be careful!)
+log tail log of specified service
+ls list directories inside arvbox
+cat get contents of files inside arvbox
+pipe run a bash script piped in from stdin
+sv
+ change state of service inside arvbox
+clone clone dev arvbox
+adduser
+ add a user login
+removeuser
+ remove user login
+listusers list user logins
h2. Install root certificate
@@ -66,18 +80,31 @@ Arvbox creates root certificate to authorize Arvbox services. Installing the ro
The certificate will be added under the "Arvados testing" organization as "arvbox testing root CA".
-To access your Arvbox instance using command line clients (such as arv-get and arv-put) without security errors, install the certificate into the OS certificate storage (instructions for Debian/Ubuntu):
+To access your Arvbox instance using command line clients (such as arv-get and arv-put) without security errors, install the certificate into the OS certificate storage.
+
+h3. On Debian/Ubuntu:
+
+
+cp arvbox-root-cert.pem /usr/local/share/ca-certificates/
+/usr/sbin/update-ca-certificates
+
+
+
+h3. On CentOS:
-# copy @arvbox-root-cert.pem@ to @/usr/local/share/ca-certificates/@
-# run @/usr/sbin/update-ca-certificates@
+
+cp arvbox-root-cert.pem /etc/pki/ca-trust/source/anchors/
+/usr/bin/update-ca-trust
+
+
h2. Configs
h3. dev
-Development configuration. Boots a complete Arvados environment inside the container. The "arvados", "arvado-dev" and "sso-devise-omniauth-provider" code directories along data directories "postgres", "var", "passenger" and "gems" are bind mounted from the host file system for easy access and persistence across container rebuilds. Services are bound to the Docker container's network IP address and can only be accessed on the local host.
+Development configuration. Boots a complete Arvados environment inside the container. The "arvados" and "arvados-dev" code directories along data directories "postgres", "var", "passenger" and "gems" are bind mounted from the host file system for easy access and persistence across container rebuilds. Services are bound to the Docker container's network IP address and can only be accessed on the local host.
-In "dev" mode, you can override the default autogenerated settings of Rails projects by adding "application.yml.override" to any Rails project (sso, api, workbench). This can be used to test out API server settings or point Workbench at an alternate API server.
+In "dev" mode, you can override the default autogenerated settings of Rails projects by adding "application.yml.override" to any Rails project (api, workbench). This can be used to test out API server settings or point Workbench at an alternate API server.
h3. localdemo
@@ -85,7 +112,11 @@ Demo configuration. Boots a complete Arvados environment inside the container.
h3. test
-Run the test suite.
+Starts postgres and initializes the API server, then runs the Arvados test suite. Will pass command line arguments to test runner. Supports test runner interactive mode.
+
+h3. devenv
+
+Starts a minimal container with no services and the host's $HOME bind mounted inside the container, then enters an interactive login shell. Intended to make it convenient to use tools installed in arvbox that don't require services.
h3. publicdev
@@ -127,11 +158,6 @@ h3. ARVADOS_DEV_ROOT
The root directory of the Arvados-dev source tree
default: $ARVBOX_DATA/arvados-dev
-h3. SSO_ROOT
-
-The root directory of the SSO source tree
-default: $ARVBOX_DATA/sso-devise-omniauth-provider
-
h3. ARVBOX_PUBLISH_IP
The IP address on which to publish services when running in public configuration. Overrides default detection of the host's IP address.