Github user DaveBirdsall commented on a diff in the pull request:
https://github.com/apache/incubator-trafodion/pull/326#discussion_r53224682
--- Diff: docs/provisioning_guide/src/asciidoc/_chapters/prepare.adoc ---
@@ -0,0 +1,379 @@
+////
+/**
+* @@@ START COPYRIGHT @@@
+*
+* Licensed to the Apache Software Foundation (ASF) under one
+* or more contributor license agreements. See the NOTICE file
+* distributed with this work for additional information
+* regarding copyright ownership. The ASF licenses this file
+* to you under the Apache License, Version 2.0 (the
+* "License"); you may not use this file except in compliance
+* with the License. You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing,
+* software distributed under the License is distributed on an
+* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+* KIND, either express or implied. See the License for the
+* specific language governing permissions and limitations
+* under the License.
+*
+* @@@ END COPYRIGHT @@@
+ */
+////
+
+[[prepare]]
+= Prepare
+You need to prepare your Hadoop environment before installing Trafodion.
+
+1. <<prepare-install-optional-workstation-software,Install Optional
Workstation Software>>
+2. <<configure-installation-user-id,Configure Installation User ID>>
+3. <<prepare-disable-requiretty,Disable requiretty>>
+4. <<prepare-verify-os-requirements-and-recommendations,Verify OS
Requirements and Recommendations>>
+5. <<prepare-configure-ldap-identity-store,Configure LDAP Identity Store>>
+6. <<prepare-gather-configuration-information,Gather Configuration
Information>>
+7. <<prepare-install-required-software-packages,Install Required Software
Packages>>
+8. <<prepare-perform-recipe-based-provisioning-tasks,Perform Recipe-Based
Provisioning Tasks>>
+
+[[prepare-install-optional-workstation-software]]
+== Install Optional Workstation Software
+
+If you are using a Windows workstation, then the following optional
software helps installation process.
+We recommended that you pre-install the software before continuing with
the Trafodion installation:
+
+* putty and puttygen (download from
http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html[PuTTY web site])
+* VNC client (download from http://www.realvnc.com[RealVNC web site])
+* Firefox or Chrome browser
+* SFTP client to transfer files from your workstation to the Linux server:
WinSCP or FileZilla
+
+[[configure-installation-user-id]]
+== Configure Installation User ID
+
+Trafodion installation requires a user ID with these attributes:
+
+* `sudo` access per the requirements documented in
<<requirements-linux-installation-user,Linux Installation User>>.
+* passwordless ssh to all nodes on the cluster where Trafodion will be
installed.
+
+NOTE: You may need to request permission from your cluster-management team
to obtain this type of access.
+
+The following example shows how to set up your user ID to have
"passwordless ssh" abilities.
+
+Do the following on the Provision Master Node:
+
+```
+echo -e 'y\n' | ssh-keygen -t rsa -N "" -f $HOME/.ssh/id_rsa
+cat $HOME/.ssh/id_rsa.pub >> $HOME/.ssh/authorized_keys
+echo localhost $(cat /etc/ssh/ssh_host_rsa_key.pub) >>
$HOME/.ssh/known_hosts
+echo "NoHostAuthenticationForLocalhost=yes" >> $HOME/.ssh/config
+chmod 600 $HOME/.ssh/config
+```
+
+After running these commands, do the following:
+
+* Copy the content of the `$HOME/.ssh/id_rsa.pub` file (public key) and
append it to the
+`$HOME/.ssh/authorized_keys` file on the other nodes in your cluster.
+* Copy the `$HOME/.ssh/id_rsa` file (private key) from the current node to
the `$HOME/.ssh` directory on the other nodes in the cluster.
+* Secure `$HOME/.ssh/id_rsa` on all nodes as private to yourself (`chmod
700`).
+* `ssh` to the other nodes in the cluster. Answer `y` to the prompt asking
you whether to continue the connection.
+This adds the node to the `$HOME/.ssh/known_hosts` file completing the
passwordless ssh setup.
+
+
+[[prepare-disable-requiretty]]
+== Disable requiretty
+You need to disable `requiretty` in `/etc/sudoers` on all nodes in the
cluster
+to ensure that `sudo` commands can be run from inside the installation
scripts.
+
+Comment out the `Defaults requiretty` setting in the `/etc/sudoers` file to
+ensure that the `requiretty` option is NOT being used.
+
+[[prepare-verify-os-requirements-and-recommendations]]
+== Verify OS Requirements and Recommendations
+
+Please ensure that the
<<requirements-os-requirements-and-recommendations,OS Requirements and
Recommendations>>
+are met for each node in the cluster where you intend to install Trafodion.
+
+<<<
+[[prepare-configure-ldap-identity-store]]
+== Configure LDAP Identity Store
+
+If you plan to enable security in Trafodion, then you need to have an LDAP
identity store available to perform authentication.
+The Trafodion Installer prompts you to set up an authentication
configuration file that points to an LDAP server (or servers),
+which enables security (that is, authentication and authorization) in the
Trafodion database.
+
+If you wish to manually set up the authentication configuration file and
enable security, then refer to the section on
+<<enable-security,Enable Security>>.
+
+[[prepare-gather-configuration-information]]
+== Gather Configuration Information
+
+You need to gather/decide information about your environment to aid
installation Trafodion, both for the Trafodion Installer
+and for recipe-based provisioning. (In alphabetical order to make it
easier to find information later on in the provisioning process.)
--- End diff --
Grammar. The parenthetical remark is not a complete sentence. Possible
wordsmith: "Do so in alphabetical order..."
---
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at [email protected] or file a JIRA ticket
with INFRA.
---
