openstack/openstack-manuals
Code Issues Proposed changes

Remove sudo usage from config reference

Browse Source 
Remove sudo usage and adjust prompts as needed.

Change-Id: Ia1df06230203f7c8393b7f369c3dc396d8143799
This commit is contained in:
Andreas Jaeger 2014-03-10 20:12:45 +01:00
parent 86e8364342
commit 4418c9962a
5 changed files with 23 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
doc/config-reference/block-storage/drivers/emc-volume-driver.xml
View File

@ -101,7 +101,7 @@
<itemizedlist>
<listitem>
<para>On Ubuntu:</para>
<screen><prompt>$</prompt> <userinput>sudo apt-get install python-pywbem</userinput></screen>
<screen><prompt>#</prompt> <userinput>apt-get install python-pywbem</userinput></screen>
</listitem>
<listitem>
<para>On openSUSE:</para>
@ -151,14 +151,14 @@
<step><para>On the compute node <literal>1.1.1.1</literal>, do
the following (assume <literal>10.10.61.35</literal>
is the iscsi target):</para>
<screen><prompt>$</prompt> <userinput>sudo /etc/init.d/open-iscsi start</userinput>
<prompt>$</prompt> <userinput>sudo iscsiadm -m discovery -t st -p 10.10.61.35</userinput>
<prompt>$</prompt> <userinput>cd /etc/iscsi</userinput>
<prompt>$</prompt> <userinput>sudo more initiatorname.iscsi</userinput>
<prompt>$</prompt> <userinput>iscsiadm -m node</userinput></screen></step>
<screen><prompt>#</prompt> <userinput>/etc/init.d/open-iscsi start</userinput>
<prompt>#</prompt> <userinput>iscsiadm -m discovery -t st -p 10.10.61.35</userinput>
<prompt>#</prompt> <userinput>cd /etc/iscsi</userinput>
<prompt>#</prompt> <userinput>more initiatorname.iscsi</userinput>
<prompt>#</prompt> <userinput>iscsiadm -m node</userinput></screen></step>
<step><para>Log in to VNX from the compute node using the target
corresponding to the SPA port:</para>
<screen><prompt>$</prompt> <userinput>sudo iscsiadm -m node -T iqn.1992-04.com.emc:cx.apm01234567890.a0 -p 10.10.61.35 -l</userinput></screen>
<screen><prompt>#</prompt> <userinput>iscsiadm -m node -T iqn.1992-04.com.emc:cx.apm01234567890.a0 -p 10.10.61.35 -l</userinput></screen>
<para>Where
<literal>iqn.1992-04.com.emc:cx.apm01234567890.a0</literal>
is the initiator name of the compute node. Login to
@ -174,11 +174,11 @@
Now host <literal>1.1.1.1</literal> also appears under
Hosts-&gt;Host List.</para></step>
<step><para>Log out of VNX on the compute node:</para>
<screen><prompt>$</prompt> <userinput>sudo iscsiadm -m node -u</userinput></screen></step>
<screen><prompt>#</prompt> <userinput>iscsiadm -m node -u</userinput></screen></step>
<step>
<para>Log in to VNX from the compute node using the target
corresponding to the SPB port:</para>
<screen><prompt>$</prompt> <userinput>sudo iscsiadm -m node -T iqn.1992-04.com.emc:cx.apm01234567890.b8 -p 10.10.10.11 -l</userinput></screen>
<screen><prompt>#</prompt> <userinput>iscsiadm -m node -T iqn.1992-04.com.emc:cx.apm01234567890.b8 -p 10.10.10.11 -l</userinput></screen>
</step>
<step> <para>In Unisphere register the initiator with the SPB
port.</para></step>

8
doc/config-reference/compute/section_compute-configure-ipv6.xml
View File

@ -22,12 +22,12 @@
<literal>nova-*</literal> service must have <literal>python-netaddr</literal>
and <literal>radvd</literal> installed.</para>
<para>On all nova-nodes, install python-netaddr:</para>
<screen><prompt>$</prompt> <userinput>sudo apt-get install python-netaddr</userinput></screen>
<screen><prompt>#</prompt> <userinput>apt-get install python-netaddr</userinput></screen>
<para>On all <literal>nova-network</literal> nodes install <literal>radvd</literal> and configure IPv6
networking:</para>
<screen><prompt>$</prompt> <userinput>sudo apt-get install radvd</userinput>
<prompt>$</prompt> <userinput>sudo bash -c "echo 1 &gt; /proc/sys/net/ipv6/conf/all/forwarding"</userinput>
<prompt>$</prompt> <userinput>sudo bash -c "echo 0 &gt; /proc/sys/net/ipv6/conf/all/accept_ra"</userinput></screen>
<screen><prompt>#</prompt> <userinput>apt-get install radvd</userinput>
<prompt>#</prompt> <userinput>echo 1 &gt; /proc/sys/net/ipv6/conf/all/forwarding</userinput>
<prompt>#</prompt> <userinput>echo 0 &gt; /proc/sys/net/ipv6/conf/all/accept_ra</userinput></screen>
<para>Edit the <filename>nova.conf</filename> file on all nodes to
set the use_ipv6 configuration option to True. Restart all
nova- services.</para>

2
doc/config-reference/compute/section_hypervisor_kvm.xml
View File

@ -167,6 +167,6 @@ libvirt_cpu_model=Nehalem</programlisting>
set to <systemitem>kvm</systemitem>, run:</para>
<screen><prompt>#</prompt> <userinput>ls -l /dev/kvm</userinput></screen>
<para>If it is not set to <systemitem>kvm</systemitem>, run:</para>
<screen><prompt>#</prompt> <userinput>sudo udevadm trigger</userinput></screen>
<screen><prompt>#</prompt> <userinput>udevadm trigger</userinput></screen>
</section>
</section>

14
doc/config-reference/compute/section_hypervisor_qemu.xml
View File

@ -29,13 +29,13 @@ libvirt_type=qemu</programlisting></para>
<para>
For some operations you may also have to install the <command>guestmount</command> utility:</para>
<para>On Ubuntu:
<screen><prompt>$</prompt> <userinput>sudo apt-get install guestmount</userinput></screen>
<screen><prompt>#</prompt> <userinput>apt-get install guestmount</userinput></screen>
</para>
<para>On Red Hat Enterprise Linux, Fedora, or CentOS:
<screen><prompt>$</prompt> <userinput>sudo yum install libguestfs-tools</userinput></screen>
<screen><prompt>#</prompt> <userinput>yum install libguestfs-tools</userinput></screen>
</para>
<para>On openSUSE:
<screen><prompt>$</prompt> <userinput>sudo zypper install guestfs-tools</userinput></screen>
<screen><prompt>#</prompt> <userinput>zypper install guestfs-tools</userinput></screen>
</para>
<para>The QEMU hypervisor supports the following virtual machine image formats:</para>
<itemizedlist>
@ -62,9 +62,9 @@ libvirt_type=qemu</programlisting></para>
with no overcommit.</para>
<note><para>The second command, <command>setsebool</command>, may take a while.
</para></note>
<screen><prompt>$></prompt> <userinput>sudo openstack-config --set /etc/nova/nova.conf DEFAULT libvirt_type qemu</userinput>
<prompt>$></prompt> <userinput>sudo setsebool -P virt_use_execmem on</userinput>
<prompt>$></prompt> <userinput>sudo ln -s /usr/libexec/qemu-kvm /usr/bin/qemu-system-x86_64</userinput>
<prompt>$></prompt> <userinput>sudo service libvirtd restart</userinput></screen>
<screen><prompt>#</prompt> <userinput>openstack-config --set /etc/nova/nova.conf DEFAULT libvirt_type qemu</userinput>
<prompt>#</prompt> <userinput>setsebool -P virt_use_execmem on</userinput>
<prompt>#</prompt> <userinput>ln -s /usr/libexec/qemu-kvm /usr/bin/qemu-system-x86_64</userinput>
<prompt>#</prompt> <userinput>service libvirtd restart</userinput></screen>
</section>
</section>

4
doc/config-reference/object-storage/section_configure_s3.xml
View File

@ -46,10 +46,10 @@
<screen><prompt>$</prompt> <userinput>cd swift3; git checkout v1.7</userinput></screen>
<para>Then, install it using standard python mechanisms, such
as:</para>
<screen><prompt>$</prompt> <userinput>sudo python setup.py install</userinput></screen>
<screen><prompt>#</prompt> <userinput>python setup.py install</userinput></screen>
<para>Alternatively, if you have configured the Ubuntu Cloud
Archive, you may use:
<screen><prompt>$</prompt> <userinput>sudo apt-get install swift-python-s3</userinput></screen></para>
<screen><prompt>#</prompt> <userinput>apt-get install swift-python-s3</userinput></screen></para>
<para>To add this middleware to your configuration, add the <systemitem>swift3</systemitem>
middleware in front of the <systemitem>swauth</systemitem> middleware, and before any other
middleware that look at Object Storage requests (like rate limiting).</para>