The document details the process of building an InfluxDB cart, including its structure and components such as RPMs and custom scripts for configuring DevOps tools. It outlines steps for adding, customizing, and modifying the cart and node XML files, as well as deploying RPMs on the fly. Additionally, it includes examples of host profiles and configurations necessary for successful installation and operation.

1. Workshop - Building a cart
Aishwarya Venkataraman
Software Engineer

2. What is a Cart?
Site Specific Pallets
▪ Contains site-specific RPM
▪ Contains site-specific configurations
▪ Structurally and Functionally equivalent to a Pallet
Example: Client Cart
▪ Contains RPMS to install DevOps tools
▪ Contains custom post-install scripts to configure DevOps tools
▪ Contains custom post-install scripts to run DevOps tools to bring system up to
requisite configuration.

3. Adding a New InfluxDB Cart
# stack add cart influxDb
# stack list cart
NAME BOXES
screen: default
influxDb: ---------

4. Customizing a Cart
# cd /export/stack/carts/influxDb
Add the InfluxDB rpm
# cd RPMS
# wget https://s3.amazonaws.com/influxdb/influxdb-0.10.3-1.x86_64.
rpm
# vim nodes/cart-influxDb-backend.xml

5. Modifying Node XML file
<?xml version="1.0" standalone="no"?>
<kickstart>
<description>InfluxDb cart backend appliance extensions</description>
<package>influxdb</package>
<!-- shell code for post RPM installation -->
<post>
/sbin/chkconfig --add influxdb
/sbin/chkconfig influxdb on
</post>
</kickstart>

6. Adding Cart to a Box
# stack list box
NAME OS PALLETS CARTS
default: redhat os-6.7-6.x stacki-3.0-6.x ipmi-1.0-3.0 screen
# stack enable cart influxDb
# stack list box
NAME OS PALLETS CARTS
default: redhat os-6.7-6.x stacki-3.0-6.x ipmi-1.0-3.0 screen influxDb

7. Viewing the Host Profile
%packages --ignoremissing
foundation-rcs
influxdb
libcap
ntp
openssh
openssh-askpass
Openssh-clients
%post --log=/var/log/stack-install.log
/sbin/chkconfig --add influxdb
/sbin/chkconfig influxdb on
%end
%post --log=/var/log/stack-install.log
cat >> /var/log/stack-install.log << 'EOF'
/export/stack/carts/influxDb/nodes/cart-influxDb-
backend.xml: end post section
EOF
# stack list host profile node204 > /tmp/node204.cfg

8. Adding Conditionals to Node XML
<?xml version="1.0" standalone="no"?>
<kickstart>
<description>
influxDb cart backend appliance extensions
</description>
<package>influxdb</package>
<!-- shell code for post RPM installation -->
<post cond="'&appliance;' == 'prod'">
/sbin/chkconfig --add influxdb
/sbin/chkconfig influxdb on
</post>
</kickstart>

9. Additional Node XML Customizations
<?xml version="1.0" standalone="no"?>
<kickstart>
<description>
influxDb cart backend appliance extensions
</description>
<package>influxdb</package>
<!-- shell code for post RPM installation -->
<post cond="'&appliance;' == 'prod'">
/sbin/chkconfig --add influxdb
/sbin/chkconfig influxdb on
</post>
<post>
<file name="/etc/motd" perms="0755">
Influx package is available
</file>
</post>
</kickstart>

10. Modifying Graph XML file
<?xml version="1.0" standalone="no"?>
<graph>
<description>
influxDb cart
</description>
<order head="backend" tail="cart-influxDb-backend"/>
<edge from="backend" to="cart-influxDb-backend"/>
<order head="prod" tail="cart-influxDb-prod"/>
<edge from="prod" to="cart-influxDb-prod"/>
</graph>

11. Viewing the Host Profile
stack list host profile node204 > /tmp/node204.cfg
%packages --ignoremissing
foundation-rcs
influxdb
libcap
ntp
openssh
openssh-askpass
Openssh-clients
%post --log=/var/log/stack-install.log
/sbin/chkconfig --add influxdb
/sbin/chkconfig influxdb on
%end
%post --log=/var/log/stack-install.log
cat >> /var/log/stack-install.log << 'EOF'
/export/stack/carts/influxDb/nodes/cart-influxDb-
backend.xml: end post section
EOF

12. Deploying RPMS on the fly
# stack compile cart influxDb
# stack report host yum node204 | stack report script | ssh -T node204
%packages --ignoremissing
foundation-rcs
influxdb
libcap
ntp
openssh
openssh-askpass
Openssh-clients
%post --log=/var/log/stack-install.log
/sbin/chkconfig --add influxdb
/sbin/chkconfig influxdb on
%end
%post --log=/var/log/stack-install.log
cat >> /var/log/stack-install.log << 'EOF'
/export/stack/carts/influxDb/nodes/cart-influxDb-
backend.xml: end post section
EOF

13. Viewing the Host Profile
stack list host profile node204 > /tmp/node204.cfg
%packages --ignoremissing
foundation-rcs
influxdb
libcap
ntp
openssh
openssh-askpass
Openssh-clients
%post --log=/var/log/stack-install.log
/sbin/chkconfig --add influxdb
/sbin/chkconfig influxdb on
%end
%post --log=/var/log/stack-install.log
cat >> /var/log/stack-install.log << 'EOF'
/export/stack/carts/influxDb/nodes/cart-influxDb-
backend.xml: end post section
EOF

14. Cart is ready to roll!