Updating install; Initial docs rearrangement

Creating specs directory; may be moved later
Adding fix for Issue docker#348
Adding in updates for networking
Updating with Dan's comments: removing old -beta
Updating networking after talking to Madhu
Updated install with HA as optional
Moved HA spec into specs
Did "customer-facing" HA page
Renamed server > controller in docs
Entering comments from reviewers

Signed-off-by: Mary Anthony <[email protected]>

Author: Mary Anthony

bootstrap/install.md

@@ -0,0 +1,56 @@
+# install Command
+
+USAGE:
+```
+   docker run --rm -it \
+        --name ucp \
+        -v /var/run/docker.sock:/var/run/docker.sock \
+        dockerorca/ucp \
+        install [OPTIONS]
+ ```
+DESCRIPTION:
+
+Install the UCP controller on a machine. You can only install on machines where
+Docker Engine is already installed. If you intend to install a multi-node
+cluster, you must open firewall ports between the engines for the following
+ports:
+
+* 443
+* 12376
+* 12379 through 12382
+* 2376 (system default '--swarm-port')
+
+You can optionally use an externally generated and signed certificate for the
+UCP controller by specifying '--external-ucp-ca'.  Create a storage volume named
+'ucp-server-certs' with ca.pem, cert.pem, and key.pem in the root directory
+before running the install.
+
+
+OPTIONS:
+`--debug`, `-D	`			      
+  Enable debug
+`--jsonlog`				        
+  Produce json formatted output for easier parsing
+`--interactive`, `-i`			   
+  Enable interactive mode. The system prompts you to enter all required information.
+`--fresh-install`			     
+   Destroy any existing state and start fresh
+`--san` A subject alternative sames (SAN) for certs.  You can specify multiple SAN's, for example, `--san foo1.bar.com --san foo2.bar.com`.
+`--host-address` 			
+  Specify the visible IP/hostname for this node. (override automatic detection) [$UCP_HOST_ADDRESS]
+`--old-kernel`				
+    Install on older kernels (some features may not be supported)
+`--image-version "latest"`		
+    Select a specific UCP version
+--swarm-port "2376"			
+  Select what port to run the local Swarm manager on
+--external-ucp-ca			
+  Set up UCP with an external CA.
+--preserve-certs			
+  Don't (re)generate certs on the host if existing ones are found
+--binpack				
+  Set Swarm scheduler to binpack mode (default spread)
+--random				
+  Set Swarm scheduler to random mode (default spread)
+--pull "missing"			
+  Specify image pull behavior ('always', when 'missing', or 'never')

bootstrap/join.md

@@ -0,0 +1 @@
+# join Command

bootstrap/upgrade.md

@@ -0,0 +1,27 @@
+# upgrade
+
+docker run --rm -it \
+      --name ucp \
+      -v /var/run/docker.sock:/var/run/docker.sock \
+      dockerorca/ucp \
+      upgrade [OPTIONS]
+
+DESCRIPTION:
+
+Upgrades UCP on a node. When upgrading UCP, you must run
+the 'upgrade' command against every server and node running Docker Engine in
+your cluster. You should upgrade your controller and replica nodes first,
+followed by your compute nodes.  
+
+Depending on the upgrade path for your version of UCP, you may also need to upgrade Docker Engine. You can also choose to upgrade Docker Engine simply because a new version is available.  Always upgrade a nodes Docker Engine installation before upgrading its UCP installation.
+
+After upgrading each node, confirm the node is present in the UCP console
+before proceeding to the next node.
+
+OPTIONS:
+ --debug, -D			enable debug
+ --jsonlog			Produce json formatted output for easier parsing
+ --interactive, -i		Enable interactive mode.  You will be prompted to enter all required information.
+ --image-version "latest"	Select a specific UCP version
+ --id 			The ID of the UCP instance to upgrade
+ --pull "always"		Specify image pull behavior ('always', when 'missing', or 'never')

certs.md

@@ -1,9 +1,10 @@
 # Manually setting up a CA
 
-A few features of Orca require an external CA (cfssl or equivalent) to sign certs.
-By default in developer mode, these services aren't created (maybe we'll set them up
-someday, but there's some bootstrapping challenges...)  The following instructions
-explain how to set this up manually so you can do developer mode with CA support.
+A few features of UCP require an external CA (cfssl or equivalent) to sign
+certs. By default in developer mode, these services aren't created (maybe we'll
+set them up someday, but there's some bootstrapping challenges...)  The
+following instructions explain how to set this up manually so you can do
+developer mode with CA support.
 
 
 ```bash
@@ -152,7 +153,7 @@ sudo mv /etc/docker/ssl/orca/orca_server-key.pem /etc/docker/ssl/orca/orca_serve
 ```
 
 
-**Now you can run Orca**
+**Now you can run UCP**
 
 
 (proxy)