stackforge-attic/murano-docs
Code Issues Proposed changes

Fix issues in admin guide

Browse Source 
* comments mentioned in https://review.openstack.org/#/c/65926/
* document style (XML style, formatting issues)

Closes-Bug: 1268537

Change-Id: Ia0673f74b425e78a623aa14a300002adecf2c5fe
This commit is contained in:
Dmitry Teselkin 2014-01-17 15:35:50 +04:00
parent a9ba7729cd
commit 34a23ac18c
3 changed files with 1304 additions and 1135 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

694
src/administrators-guide/src/docbkx/content/linux-image-bulder.xml
View File

@ -17,410 +17,410 @@
--> -->
<chapter xmlns="http://docbook.org/ns/docbook" <chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xlink="http://www.w3.org/1999/xlink"
xsi:schemaLocation="http://docbook.org/ns/docbook http://www.docbook.org/xml/5.0/xsd/docbook.xsd http://www.w3.org/1999/xlink http://www.w3.org/1999/xlink.xsd" xsi:schemaLocation="http://docbook.org/ns/docbook http://www.docbook.org/xml/5.0/xsd/docbook.xsd http://www.w3.org/1999/xlink http://www.w3.org/1999/xlink.xsd"
version="5.0"> version="5.0">
<title>Building Linux Image</title> <title>Building Linux Image</title>
<section> <section>
<title>Install Required Packages</title> <title>Install Required Packages</title>
<note> <note>
<para> <para>
Please check that hardware virtualization is supported and enabled in BIOS. Please check that hardware virtualization is supported and enabled in BIOS.
</para> </para>
</note> </note>
<para> <para>
The following packages should be installed on any host which will be used to build Linux Image: The following packages should be installed on any host which will be used to build Linux Image:
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para> <para>
ipxe-qemu ipxe-qemu
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
kvm-ipxe kvm-ipxe
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
qemu-kvm qemu-kvm
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
munin-libvirt-plugins python-libvirt
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
python-libvirt libvirt-bin
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
libvirt-bin libvirt0
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
libvirt0 virt-goodies
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
munin-libvirt-plugins virt-manager
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
python-libvirt virt-top
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
virt-goodies virt-what
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
virt-manager virtinst
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
virt-top python
</para> </para>
</listitem> </listitem>
<listitem>
<para>
virt-what
</para>
</listitem>
<listitem>
<para>
virtinst
</para>
</listitem>
<listitem>
<para>
python
</para>
</listitem>
</itemizedlist> </itemizedlist>
</para> </para>
<para> <para>
On Ubuntu you could install them using the command below: On Ubuntu you could install them using the command below:
</para> </para>
<screen> <screen>
># apt-get install ipxe-qemu kvm-ipxe qemu-kvm virt-goodies \ ># apt-get install ipxe-qemu kvm-ipxe qemu-kvm virt-goodies \
virtinst virt-manager libvirt0 libvirt-bin \ virtinst virt-manager libvirt0 libvirt-bin \
munin-libvirt-plugins python python-libvirt \ python python-libvirt \
python-libxml2 python-minimal python-pycurl \ python-libxml2 python-minimal python-pycurl \
python-pyorbit python-requests python-six \ python-pyorbit python-requests python-six \
samba samba-common openssh-server virt-top virt-what samba samba-common openssh-server virt-top virt-what
</screen> </screen>
</section> </section>
<section> <section>
<title>Build Linux Image</title> <title>Build Linux Image</title>
<para> <para>
<emphasis role="strong">Create a VM</emphasis> <emphasis role="strong">Create a VM</emphasis>
</para> </para>
<para>This section describes steps required to build an image of Linux Virtual Machine <para>
This section describes the steps required to build an image of Linux Virtual Machine
which could be used with Murano. There are two possible ways to create it - from which could be used with Murano. There are two possible ways to create it - from
CLI or using GUI tools. We describe both in this section. CLI or using GUI tools. We describe both in this section.
</para>
<note>
<para>
Run all commands as root.
</para> </para>
</note> <note>
<para> <para>
<emphasis role="strong">Way 1: Using CLI Tools</emphasis> Run all commands as root.
</para> </para>
<para> </note>
This section describes the required step to launch a VM using CLI tools only. <para>
</para> <emphasis role="strong">Way 1: Using CLI Tools</emphasis>
</para>
<para>
This section describes the required step to launch a VM using CLI tools only.
</para>
<para> <para>
<orderedlist> <orderedlist>
<listitem> <listitem>
<para> <para>
Preallocate disk image Preallocate disk image
</para> </para>
<screen> <screen>
># qemu-img create -f qcow2 /var/lib/libvirt/images/cloud-linux.img 10G ># qemu-img create -f qcow2 /var/lib/libvirt/images/cloud-linux.img 10G
</screen> </screen>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Start the VM Start the VM
</para> </para>
<screen> <screen>
># virt-install --connect qemu:///system --hvm --name cloud-linux \ ># virt-install --connect qemu:///system --hvm --name cloud-linux \
--ram 2048 --vcpus 2 --cdrom /PATH_TO_YOUR_LINUX.ISO \ --ram 2048 --vcpus 2 --cdrom /PATH_TO_YOUR_LINUX.ISO \
--disk path=/var/lib/libvirt/images/cloud-linux.img, \ --disk path=/var/lib/libvirt/images/cloud-linux.img, \
format=qcow2,bus=virtio,cache=none \ format=qcow2,bus=virtio,cache=none \
--network network=default,model=virtio \ --network network=default,model=virtio \
--memballoon model=virtio --vnc --os-type=linux \ --memballoon model=virtio --vnc --os-type=linux \
--accelerate --noapic --keymap=en-us --video=cirrus --force --accelerate --noapic --keymap=en-us --video=cirrus --force
</screen> </screen>
</listitem> </listitem>
</orderedlist> </orderedlist>
</para> </para>
<para> <para>
<emphasis role="strong">Way 2: Using virt-manager UI</emphasis> <emphasis role="strong">Way 2: Using virt-manager UI</emphasis>
</para>
<para>
A VM also could be lauched via GUI tools like virt-manager.
</para>
<para>
<orderedlist>
<listitem>
<para>Launch <emphasis role="italic">virt-manager</emphasis> from shell
as root </para>
</listitem>
<listitem>
<para>
Set a name for VM and select Local install media
</para>
</listitem>
<listitem>
<para>
Add one cdrom and attach your linux ISO image to it
</para>
</listitem>
<listitem>
<para>
Select OS type <emphasis role="bold">Linux</emphasis> and it's
version <emphasis role="bold">choose yours</emphasis>
</para> </para>
</listitem> <para>
<listitem> A VM also could be lauched via GUI tools like virt-manager.
<para>
Set CPU and RAM amount
</para>
</listitem>
<listitem>
<para>
Deselect option <emphasis role="bold">Enable storage for this
virtual machine</emphasis>
</para> </para>
</listitem> <para>
<listitem> <orderedlist>
<para> <listitem>
Select option <emphasis role="bold">Customize configuration before <para>
install</emphasis> Launch <emphasis role="italic">virt-manager</emphasis> from shell as root
</para>
</listitem>
<listitem>
<para>
Set a name for VM and select Local install media
</para>
</listitem>
<listitem>
<para>
Add one cdrom and attach your linux ISO image to it
</para>
</listitem>
<listitem>
<para>
Select OS type <emphasis role="bold">Linux</emphasis> and it's
version <emphasis role="bold">choose yours</emphasis>
</para>
</listitem>
<listitem>
<para>
Set CPU and RAM amount
</para>
</listitem>
<listitem>
<para>
Deselect option <emphasis role="bold">Enable storage for this
virtual machine</emphasis>
</para>
</listitem>
<listitem>
<para>
Select option <emphasis role="bold">Customize configuration before
install</emphasis>
</para>
</listitem>
<listitem>
<para>
Add (or create new) HDD image with Disk bus <emphasis role="bold">VirtIO</emphasis>
and storage format <emphasis role="bold">QCOW2</emphasis>
</para>
</listitem>
<listitem>
<para>
Set network device model <emphasis role="bold">VirtIO</emphasis>
</para>
</listitem>
<listitem>
<para>
Start installation process and open guest vm screen through
<emphasis role="bold">Console</emphasis> button
</para>
</listitem>
</orderedlist>
</para> </para>
</listitem>
<listitem>
<para>
Add (or create new) HDD image with Disk bus <emphasis role="bold">VirtIO</emphasis> and storage format <emphasis role="bold">QCOW2</emphasis>
</para>
</listitem>
<listitem>
<para>Set network device model <emphasis role="bold">VirtIO</emphasis>
</para>
</listitem>
<listitem>
<para>Start installation process and open guest vm screen through
<emphasis role="bold">Console</emphasis> button
</para>
</listitem>
</orderedlist>
</para>
</section> </section>
<section> <section>
<title>Guest VM Linux OS preparation</title> <title>Guest VM Linux OS preparation</title>
<para> <para>
<emphasis role="strong">Ubuntu 12.04 LTS x86_64</emphasis> <emphasis role="strong">Ubuntu 12.04 LTS x86_64</emphasis>
</para> </para>
<screen> <screen>
># for action in update upgrade dist-upgrade;do apt-get -y $action;done ># apt-get -y update; apt-get -y dist-upgrade
># apt-get install -y git unzip make cmake gcc python-dev python-pip openssh-server sudo ># apt-get install -y git unzip make cmake gcc \
</screen> python-dev python-pip openssh-server
<para> </screen>
<emphasis role="strong">CentOS 6.4 x86_64</emphasis> <para>
</para> <emphasis role="strong">CentOS 6.4 x86_64</emphasis>
<screen> </para>
># rpm -ivh http://dl.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm <screen>
># for action in update upgrade;do yum -y $action; done ># rpm -ivh http://dl.fedoraproject.org/pub/epel/6/\
># yum install -y git unzip make cmake gcc python-devel python-pip openssh-server openssh-clients sudo x86_64/epel-release-6-8.noarch.rpm
</screen> ># yum -y update; yum -y upgrade
<para> ># yum install -y git unzip make cmake gcc \
<emphasis role="strong">murano-agent installation steps</emphasis> python-devel python-pip openssh-server openssh-clients sudo
</para> </screen>
<screen> <para>
<emphasis role="strong">murano-agent installation steps</emphasis>
</para>
<screen>
># mkdir -p /opt/git ># mkdir -p /opt/git
># cd /opt/git ># cd /opt/git
># git clone https://github.com/stackforge/murano-agent.git ># git clone https://github.com/stackforge/murano-agent.git
># cd murano-agent/python-agent ># cd murano-agent/python-agent
># git checkout release-0.3 ># git checkout release-0.3
># chmod a+x setup*.sh ># chmod a+x setup*.sh
# To install Murano Agent on Ubuntu run:
># ./setup.sh install ># ./setup.sh install
or
# To install Murano Agent on CentOS run:
># ./setup-centos.sh install ># ./setup-centos.sh install
</screen> </screen>
<para> <para>
<emphasis role="strong">cloud-init installation steps</emphasis> <emphasis role="strong">cloud-init installation steps</emphasis>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para> <para>
<emphasis role="bold">Ubuntu</emphasis> <emphasis role="bold">Ubuntu</emphasis>
</para> </para>
<screen> <screen>
># apt-get install -y cloud-init cloud-initramfs-growroot ># apt-get install -y cloud-init cloud-initramfs-growroot
</screen> </screen>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
<emphasis role="bold">CentOS</emphasis> <emphasis role="bold">CentOS</emphasis>
</para> </para>
<screen> <screen>
># yum install -y cloud-init ># yum install -y cloud-init
</screen> </screen>
<note> <note>
<para> <para>
<emphasis role="bold">Ubuntu only</emphasis> <emphasis role="bold">Ubuntu only</emphasis>
</para> </para>
<screen> <screen>
># dpkg-reconfigure cloud-init ># dpkg-reconfigure cloud-init
</screen> </screen>
<para> <para>
Mark <emphasis role="bold">EC2</emphasis> data source support, save and exit or add manualy <emphasis role="bold">Ec2</emphasis> to the datasource_list variable in the /etc/cloud/cloud.cfg.d/90_dfkg.cfg Mark <emphasis role="bold">EC2</emphasis> data source support, save and exit or add manualy <emphasis role="bold">Ec2</emphasis> to the datasource_list variable in the /etc/cloud/cloud.cfg.d/90_dfkg.cfg
</para> </para>
</note> </note>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
<emphasis role="strong">Minimal cloud-init configuration options</emphasis> <emphasis role="strong">Minimal cloud-init configuration options</emphasis>
</para> </para>
<screen> <screen>
># vi /etc/cloud/cloud.cfg: ># vi /etc/cloud/cloud.cfg
user: ec2-user </screen>
disable_root: 1 <screen>
preserve_hostname: False user: ec2-user
</screen> disable_root: 1
</listitem> preserve_hostname: False
</itemizedlist> </screen>
</para> </listitem>
<para> </itemizedlist>
<emphasis role="strong">Security setup</emphasis> </para>
</para> <para>
<para> <emphasis role="strong">Security setup</emphasis>
Create user and make it able to run commands through sudo without password prompt. </para>
<itemizedlist> <para>
<listitem> Create user and make it able to run commands through sudo without password prompt.
<para> <itemizedlist>
<emphasis role="strong">Ubuntu</emphasis> <listitem>
</para> <para>
<screen> <emphasis role="strong">Ubuntu</emphasis>
</para>
<screen>
># useradd -m -G sudo -s /bin/bash ec2-user ># useradd -m -G sudo -s /bin/bash ec2-user
># passwd ec2-user ># passwd ec2-user
</screen> </screen>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
<emphasis role="strong">CentOS</emphasis> <emphasis role="strong">CentOS</emphasis>
</para> </para>
<screen> <screen>
># useradd -m -G wheel -s /bin/bash ec2-user ># useradd -m -G wheel -s /bin/bash ec2-user
># passwd ec2-user ># passwd ec2-user
</screen> </screen>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
<emphasis role="strong">Sudo</emphasis> <emphasis role="strong">Sudo</emphasis>
</para> </para>
<screen> <screen>
># echo "ec2-user ALL=(ALL) NOPASSWD: ALL" > /etc/sudoers.d/ec2-user ># echo "ec2-user ALL=(ALL) NOPASSWD: ALL" > /etc/sudoers.d/ec2-user
># chmod 440 /etc/sudoers.d/ec2-user ># chmod 440 /etc/sudoers.d/ec2-user
</screen> </screen>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
<emphasis role="strong">Disable SSH password-based logins in the /etc/ssh/sshd_config.</emphasis> <emphasis role="strong">Disable SSH password-based logins in the /etc/ssh/sshd_config.</emphasis>
</para> </para>
<screen> <screen>
... ...
GSSAPIAuthentication no GSSAPIAuthentication no
PasswordAuthentication no PasswordAuthentication no
PermitRootLogin no PermitRootLogin no
... ...
</screen> </screen>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
</para>
<para>
<emphasis role="strong">Network handling</emphasis>
<itemizedlist>
<listitem>
<para>
<emphasis role="strong">Ubuntu</emphasis>
</para>
<screen>
># rm -rf /etc/udev/rules.d/70-persistent-net.rules
</screen>
</listitem>
<listitem>
<para>
<emphasis role="strong">CentOS</emphasis>
Remove or comment out HWADDR and UUID in /etc/sysconfig/network-scripts/ifcfg-eth*
</para>
<screen>
># rm -rf /etc/udev/rules.d/70-persistent-net.rules
</screen>
</listitem>
</itemizedlist>
</para>
<para>
<emphasis role="strong">Shutdown VM</emphasis>
</para>
<formalpara>
<title>Convert the image from RAW to QCOW2 format if you made it as RAW</title>
<para>
The image must be converted from RAW format to QCOW2 before being imorted into Glance.
</para> </para>
</formalpara> <para>
<para> <emphasis role="strong">Network handling</emphasis>
<screen> <itemizedlist>
<listitem>
<para>
<emphasis role="strong">Ubuntu</emphasis>
</para>
<screen>
># rm -f /etc/udev/rules.d/70-persistent-net.rules
</screen>
</listitem>
<listitem>
<para>
<emphasis role="strong">CentOS</emphasis>
Remove or comment out HWADDR and UUID in /etc/sysconfig/network-scripts/ifcfg-eth*
</para>
<screen>
># rm -f /etc/udev/rules.d/70-persistent-net.rules
</screen>
</listitem>
</itemizedlist>
</para>
<para>
<emphasis role="strong">Shutdown VM</emphasis>
</para>
<formalpara>
<title>Convert the image from RAW to QCOW2 format if you made it as RAW</title>
<para>
The image must be converted from RAW format to QCOW2 before being imported into Glance.
</para>
</formalpara>
<para>
<screen>
># qemu-img convert -O qcow2 /var/lib/libvirt/images/cloud-linux.img \ ># qemu-img convert -O qcow2 /var/lib/libvirt/images/cloud-linux.img \
/var/lib/libvirt/images/cloud-linux.img.qcow2 /var/lib/libvirt/images/cloud-linux.img.qcow2
</screen> </screen>
</para> </para>
</section> </section>
<section> <section>
<title>Upload Image Into Glance</title> <title>Upload Image Into Glance</title>
<para> <para>
Services deployed by Murano require specially prepared images. Services deployed by Murano require specially prepared images.
After images are created they should be registered in Openstack Glance - image operation service. After images are created they should be registered in Openstack Glance - image operation service.
</para> </para>
<screen> <screen>
># glance image-create --disk-format=qcow2 --container-format=bare --is-public=true --file=cloud-linux.img --name=cloud-linux ># glance image-create --disk-format=qcow2 --container-format=bare \
</screen> --is-public=true --file=cloud-linux.img --name=cloud-linux
<note> </screen>
<para>Image should be marked with an appropriate type. That could be done through the Horizon UI. <note>
Navigate to Project -&gt; Environments -&gt; Marked Images -&gt; Mark Image and fill up form: <para>
<itemizedlist> Image should be marked with an appropriate type. That could be done through the Horizon UI.
<listitem> Navigate to Project -&gt; Environments -&gt; Marked Images -&gt; Mark Image and fill up form:
<para> <itemizedlist>
<emphasis role="bold">Image</emphasis> - cloud-linux <listitem>
</para> <para>
</listitem> <emphasis role="bold">Image</emphasis> - cloud-linux
<listitem> </para>
<para> </listitem>
<emphasis role="bold">Title</emphasis> - My Cloud-ready Linux <listitem>
</para> <para>
</listitem> <emphasis role="bold">Title</emphasis> - My Cloud-ready Linux
<listitem> </para>
<para> </listitem>
<emphasis role="bold">Type</emphasis> - Generic Linux <listitem>
</para> <para>
</listitem> <emphasis role="bold">Type</emphasis> - Generic Linux
</itemizedlist> </para>
</listitem>
</itemizedlist>
</para>
</note>
<para>
After these steps desired image can be chosen in Murano dashboard and used for services platform.
</para> </para>
</note>
<para>
After these steps desired image can be chosen in Murano dashboard and used for services platform.
</para>
</section> </section>
</chapter> </chapter>

294
src/administrators-guide/src/docbkx/content/troubleshooting.xml
View File

@ -6,7 +6,7 @@
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.
You may obtain a copy of the License at You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0 http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS, distributed under the License is distributed on an "AS IS" BASIS,
@ -17,123 +17,177 @@
--> -->
<chapter xmlns="http://docbook.org/ns/docbook" <chapter xmlns="http://docbook.org/ns/docbook"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xlink="http://www.w3.org/1999/xlink"
xsi:schemaLocation="http://docbook.org/ns/docbook http://www.docbook.org/xml/5.0/xsd/docbook.xsd xsi:schemaLocation="http://docbook.org/ns/docbook http://www.docbook.org/xml/5.0/xsd/docbook.xsd
http://www.w3.org/1999/xlink http://www.w3.org/1999/xlink.xsd" http://www.w3.org/1999/xlink http://www.w3.org/1999/xlink.xsd"
version="5.0"> version="5.0">
<title>Troubleshooting</title> <title>Troubleshooting</title>
<formalpara> <formalpara>
<title>General Notes</title> <title>General Notes</title>
<para>The following debug sequence should be used when you have no idea about why the <para>
system isn't working. If you have one, you may skip unnecessary sections.</para> The following debug sequence should be used when you have no idea about why the
</formalpara> system isn't working. If you have one, you may skip unnecessary sections.
<para>Set debug options to "True" in the following Murano configuration files:<itemizedlist> </para>
<listitem> </formalpara>
<para>/etc/murano-api/murano-api.conf</para> <para>
</listitem> Set debug options to "True" in the following Murano configuration files:
<listitem> <itemizedlist>
<para>/etc/murano-conductor/conductor.conf</para> <listitem>
</listitem> <para>
</itemizedlist></para> /etc/murano-api/murano-api.conf
<para>Stop both <emphasis role="bold">murano-api</emphasis> and <emphasis role="bold" </para>
>murano-conductor</emphasis> services. We will start them one by one from the </listitem>
console.</para> <listitem>
<formalpara> <para>
<title>murano-api</title> /etc/murano-conductor/conductor.conf
<para>First, the murano-api must be started.</para> </para>
</formalpara> </listitem>
<para> </itemizedlist>
<itemizedlist> </para>
<listitem> <para>
<para>Open new console</para> Stop both <emphasis role="bold">murano-api</emphasis> and
</listitem> <emphasis role="bold">murano-conductor</emphasis> services.
<listitem> We will start them one by one from the console.
<para>Start <emphasis role="bold">murano-api</emphasis> service </para>
manually<screen>># murano-api --config-dir /etc/murano-api 2>&amp;1 \ <formalpara>
> /var/log/murano-api-live.log &amp; <title>murano-api</title>
># tailf /var/log/murano-api-live.log</screen></para> <para>
</listitem> First, the murano-api must be started.
<listitem> </para>
<para>Open dashboard, create and send to deploy some simple </formalpara>
environment.</para> <para>
</listitem> <itemizedlist>
<listitem> <listitem>
<para>Open RabbitMQ web console, open your vhost and ensure that queues were <para>
created and there is at least one message.</para> Open new console
</listitem> </para>
<listitem> </listitem>
<para>Check log for errors - there shouldn't be any</para> <listitem>
</listitem> <para>
<listitem> Start <emphasis role="bold">murano-api</emphasis> service manually
<para>Keep <emphasis role="bold">murano-api</emphasis> service <screen>
running</para> ># murano-api --config-dir /etc/murano-api 2>&amp;1 >\
</listitem> /var/log/murano-api-live.log &amp;
</itemizedlist> ># tailf /var/log/murano-api-live.log
</para> </screen>
<formalpara> </para>
<title>murano-conductor</title> </listitem>
<para>Next to the <emphasis role="bold">murano-api</emphasis> the <emphasis role="bold" <listitem>
>murano-conductor</emphasis> should be started <para>
</para> Open dashboard, create and send to deploy some simple environment.
</formalpara> </para>
<para> </listitem>
<itemizedlist> <listitem>
<listitem> <para>
<para>Open new console</para> Open RabbitMQ web console, open your vhost and ensure that queues
</listitem> were created and there is at least one message.
<listitem> </para>
<para>Start conductor from </listitem>
console<screen>># muranoconductor --config-dir /etc/murano-conductor \ <listitem>
> /var/log/murano-conductor-live.log &amp; <para>
># tailf /var/log/murano-conductor-live.log</screen></para> Check log for errors - there shouldn't be any
</listitem> </para>
<listitem> </listitem>
<para>Check that there is no python exceptions in the log. Some errors like <listitem>
404 are ok, as conductor tries to delete environment that doesn't <para>
exist</para> Keep <emphasis role="bold">murano-api</emphasis> service running
</listitem> </para>
<listitem> </listitem>
<para>Check heat stack status. It should not be in FAILED state. If it is - </itemizedlist>
check heat and nova error log to find the cause.</para> </para>
</listitem> <formalpara>
<listitem> <title>murano-conductor</title>
<para>Keep murano-conductor service running.</para> <para>
</listitem> Next to the <emphasis role="bold">murano-api</emphasis> the
</itemizedlist> <emphasis role="bold">murano-conductor</emphasis> should be started
</para> </para>
<formalpara> </formalpara>
<title>Log Files</title> <para>
<para>There are various log files which will help you to debug the system.</para> <itemizedlist>
</formalpara> <listitem>
<para><emphasis role="bold">Murano Log Files</emphasis> <para>
<itemizedlist> Open new console
<listitem> </para>
<para>/var/log/murano-api.log</para> </listitem>
</listitem> <listitem>
<listitem> <para>
<para>/var/log/murano-conductor.log</para> Start conductor from console
</listitem> <screen>
<listitem> ># muranoconductor --config-dir /etc/murano-conductor >\
<para>/var/log/apache2/errors.log</para> /var/log/murano-conductor-live.log &amp;
</listitem> ># tailf /var/log/murano-conductor-live.log
<listitem> </screen>
<para>/var/log/httpd/errors.log</para> </para>
</listitem> </listitem>
</itemizedlist> <listitem>
</para> <para>
<para><emphasis role="bold">Windows Log Files</emphasis> Check that there is no python exceptions in the log. Some errors like
<itemizedlist> 404 are ok, as conductor tries to delete environment that doesn't exist
<listitem> </para>
<para>C:\Program Files (x86)\CloudBase Solutions\logs\log.txt</para> </listitem>
</listitem> <listitem>
<listitem> <para>
<para>C:\Murano\Agent\log.txt</para> Check heat stack status. It should not be in FAILED state.
</listitem> If it is - check heat and nova error log to find the cause.
<listitem> </para>
<para>C:\Murano\PowerShell.log</para> </listitem>
</listitem> <listitem>
</itemizedlist> <para>
</para> Keep murano-conductor service running.
</para>
</listitem>
</itemizedlist>
</para>
<formalpara>
<title>Log Files</title>
<para>
There are various log files which will help you to debug the system.
</para>
</formalpara>
<para>
<emphasis role="bold">Murano Log Files</emphasis>
<itemizedlist>
<listitem>
<para>
/var/log/murano-api.log
</para>
</listitem>
<listitem>
<para>
/var/log/murano-conductor.log
</para>
</listitem>
<listitem>
<para>
/var/log/apache2/errors.log
</para>
</listitem>
<listitem>
<para>
/var/log/httpd/errors.log
</para>
</listitem>
</itemizedlist>
</para>
<para>
<emphasis role="bold">Windows Log Files</emphasis>
<itemizedlist>
<listitem>
<para>
C:\Program Files (x86)\CloudBase Solutions\logs\log.txt
</para>
</listitem>
<listitem>
<para>
C:\Murano\Agent\log.txt
</para>
</listitem>
<listitem>
<para>
C:\Murano\PowerShell.log
</para>
</listitem>
</itemizedlist>
</para>
</chapter> </chapter>

1451
src/administrators-guide/src/docbkx/content/windows-image-bulder.xml
View File

File diff suppressed because it is too large Load Diff