Merge pull request #156 from markcocker/master

Update install instructions to build from source

Author: cxharris

docs/_data/sidebars/cdp_commads_sidebar.yml

@@ -66,7 +66,7 @@ entries:
     - title: generate bundle
       external_url: https://github.com/IBM/zowe-cli-cics-deploy-plugin/blob/master/docs-internal/CLIReadme.md#module-generate
       output: web
-    - title: update push bundle
+    - title: push bundle
       external_url: https://github.com/IBM/zowe-cli-cics-deploy-plugin/blob/master/docs-internal/CLIReadme.md#module-push
       output: web
     - title: deploy bundle

docs/_data/sidebars/cdp_sidebar.yml

@@ -79,7 +79,7 @@ entries:
     - title: generate bundle
       external_url: https://github.com/IBM/zowe-cli-cics-deploy-plugin/blob/master/docs-internal/CLIReadme.md#module-generate
       output: web
-    - title: update push bundle
+    - title: push bundle
       external_url: https://github.com/IBM/zowe-cli-cics-deploy-plugin/blob/master/docs-internal/CLIReadme.md#module-push
       output: web
     - title: deploy bundle

docs/pages/cdp/cdp-Create-Zowe-CLI-profiles.md

@@ -19,7 +19,7 @@ This profile defines the parameters needed to connect to the z/OSMF server on z/
 | user | User ID to identify yourself to the z/OSMF server. |
 | password | Password to identify yourself to the z/OSMF server. |
 
-**Note**: The user ID needs to have sufficient permissions to remove and create directories and files in the directory specified by `--targetdir` in the cics-deploy profile. The user ID also needs permission to submit JCL and to run the DFHDPLOY utility as described in the **Security** heading in topic [Automate the deployment and undeployment of CICS bundles and applications with the DFHDPLOY utility](https://www.ibm.com/support/knowledgecenter/SSGMCP_5.5.0/applications/deploying/dfhdploy_overview.html).
+{% include note.html content="The user ID needs to have sufficient permissions to remove and create directories and files in the directory specified by `--targetdir` in the cics-deploy profile. The user ID also needs permission to submit JCL and to run the DFHDPLOY utility as described in the **Security** heading in topic [Automate the deployment and undeployment of CICS bundles and applications with the DFHDPLOY utility](https://www.ibm.com/support/knowledgecenter/SSGMCP_5.5.0/applications/deploying/dfhdploy_overview.html)." %}
 
 For example, to create a z/OSMF profile:
 
@@ -50,7 +50,7 @@ This profile defines the parameters needed to connect to the SSH server on z/OS.
 | user | User ID to identify yourself to the SSH server. |
 | password | Password to identify yourself to the SSH server. |
 
-**Note**: It is recommended that you use the same user ID and host name to connect with SSH as is used in the z/OSMF profile, failure to do so results in undefined behaviour. When an SSH connection is made, the user's remote [z/OS shell .profile](https://www.ibm.com/support/knowledgecenter/en/SSLTBW_2.3.0/com.ibm.zos.v2r3.bpxa400/cupro.htm) is used to set-up the shell environment and variables. This remote .profile should include any necessary environment variables and npm configuration required to run `npm install`. This is descibed in [Installing and configuring](https://www.ibm.com/support/knowledgecenter/SSTRRS_6.0.0/com.ibm.nodejs.zos.v6.doc/install.htm).
+{% include note.html content="It is recommended that you use the same user ID and host name to connect with SSH as is used in the z/OSMF profile, failure to do so results in undefined behaviour. When an SSH connection is made, the user's remote [z/OS shell .profile](https://www.ibm.com/support/knowledgecenter/en/SSLTBW_2.3.0/com.ibm.zos.v2r3.bpxa400/cupro.htm) is used to set-up the shell environment and variables. This remote .profile should include any necessary environment variables and npm configuration required to run `npm install`. This is descibed in [Installing and configuring](https://www.ibm.com/support/knowledgecenter/SSTRRS_6.0.0/com.ibm.nodejs.zos.v6.doc/install.htm)." %}
 
 For example, to create an SSH profile:
 
@@ -87,8 +87,7 @@ This profile identifies the CICS environment for deployment. You need to know th
 For example to create a cics-deploy profile:
 
 ```console
-zowe profiles create cics-deploy-profile example --cicsplex PLEX1 --cicshlq CICSTS55.CICS720 --cpsmhlq CICSTS55.CPSM550 --scope TESTGRP1 --csdgroup BUNDGRP1 --targetdir /var/cicsts/bundles
---overwrite
+zowe profiles create cics-deploy-profile example --cicsplex PLEX1 --cicshlq CICSTS55.CICS720 --cpsmhlq CICSTS55.CPSM550 --scope TESTGRP1 --csdgroup BUNDGRP1 --targetdir /var/cicsts/bundles --overwrite
 ```
 
 For help on using the options:

docs/pages/cdp/cdp-Installation.md

@@ -9,34 +9,36 @@ folder: cdp
 toc: false
 ---
 
-1. Install [Node.js V8.0](https://nodejs.org/en/download/) or later, and Node Package Manager (npm) V5.0 or later, that are required by Zowe CLI. To verify the versions installed:
+1. Install Node.js V8.0 or later, and Node Package Manager (npm) V5.0 or later, that are required by Zowe CLI. Installers are available from Node.js [Downloads](https://nodejs.org/en/download/).
 
-   ```console
-   node --version
-   npm --version
-   ```
+    To verify the versions installed:
 
-2. Install [Zowe CLI](https://zowe.github.io/docs-site/latest/user-guide/cli-installcli.html). For example to install using npm:
-
-   ```console
-   npm install -g zowe-cli
-   ```
+    ```console
+    node --version
+    npm --version
+    ```
 
-3. Install the cics-deploy plugin:
+2. Install [Zowe CLI](https://zowe.github.io/docs-site/latest/user-guide/cli-installcli.html). For example to install using npm:
 
-   ```console
-   zowe plugins install zowe-cli-cics-deploy-plugin
-   ```
+    ```console
+    sudo npm install -g @zowe/cli
+    ```
 
-4. Verify the version of the plugin that is installed:
+3. Build and install the cics-deploy plugin as described in [Setting up your development environment](https://github.com/IBM/zowe-cli-cics-deploy-plugin/blob/master/docs-internal/tutorials/Setup.md). For example:
 
-   ```console
-   zowe plugins list
-   ```
+    ```console
+    mkdir ~/cics-deploy
+    cd ~/cics-deploy
+    rm -Rf *
+    git clone https://github.com/IBM/zowe-cli-cics-deploy-plugin
+    cd zowe-cli-cics-deploy-plugin
+    npm install
+    npm run build
+    zowe plugins install .
+    ```
 
-### Update the cics-deploy plugin
+4. Verify the plugin is installed:
 
-To update to the latest version of the plugin:
-```console
-zowe plugins update zowe-cli-cics-deploy-plugin
-```
+    ```console
+    zowe plugins list
+    ```

docs/pages/cdp/cdp-Requirements.md

@@ -23,4 +23,4 @@ The [z/OS Secure SHell daemon (sshd)](https://www.ibm.com/support/knowledgecente
 
 The [DFHDPLOY](https://www.ibm.com/support/knowledgecenter/SSGMCP_5.5.0/applications/deploying/dfhdploy_overview.html) utility is provided with IBM CICS Transaction Server (CICS) and is required to run the [push bundle](Commands#command-push-bundle), [deploy bundle](Commands#command-deploy-bundle), and [undeploy bundle](Commands#command-undeploy-bundle) commands. These commands start DFHDPLOY with a script to perform deploy and undeploy operations. For example the deploy operation will define, install, then enable a CICS BUNDLE resource in a one or more CICS regions.
 
-The DFHDPLOY utility requires CICSPlex System Manager \(CPSM\) that is also provided with CICS to be configured, and for CPSM to be connected to the target CICS regions.
+CICSPlex System Manager \(CPSM\) is provided with CICS and is required to run the DFHDPLOY utility. CPSM should be connected to the CICS regions into which the CICS application is being installed.