diff options
| -rw-r--r-- | README.txt | 64 | ||||
| -rw-r--r-- | docs/fapi.1 | 81 | ||||
| -rw-r--r-- | docs/fapi.pod | 74 | ||||
| -rw-r--r-- | docs/fapi.txt | 64 |
4 files changed, 225 insertions, 58 deletions
@@ -1,15 +1,7 @@ NAME fapi - A humble command line tool to manage F5 BigIP loadbalancers - This is a simple command line client to do basic stuff with the iControl - F5 API such as: - - Managing Nodes - Managing Monitors - Managing Pools - Managing Virtual Servers - -Synopsis +SYNOPSIS Just run fapi -h @@ -20,7 +12,21 @@ Synopsis because it's shorter to type. -bigsuds +ABOUT + This is a simple command line client to do basic stuff with the iControl + F5 API such as: + + Managing Nodes + Managing Monitors + Managing Pools + Managing Virtual Servers + + This is a private programming project programmed in my spare time. + Therefore I didn't bother to put it on a public website and github. + Please open bug reports, feature requests and pull requests at + <https://github.com/rantanplan/fapi>. + +BIGSUDS Requirement of bigsuds This tool depends on bigsuds. Please install this library from F5 dev central manually. Otherwise this script will not work. @@ -33,13 +39,15 @@ bigsuds sudo python setyp.py install + You may also install bigsuds from the contrib dir of the fapi source + tree. + iControl reference Through bigsuds you can do everything what iControl can do: <https://devcentral.f5.com/wiki/icontrol.apireference.ashx> -Quick start - Installing +QUICK START Update your sources list: curl http://deb.buetow.org/apt/pubkey.gpg | sudo apt-key add - @@ -53,6 +61,38 @@ Quick start cp /usr/share/fapi/fapi.conf.sample ~/.fapi.conf vim ~/.fapi.conf +EXAMPLES + Setting up simple NAT Services + (Docu to be written) + + Setting up simple SNAT Services + (Docu to be written) + + Setting up a simple nPath Service + A simple nPath service can be created as follows. + + # Creating two nodes, auto resolve the IP addresses + f node fooserver1.example.com create + f node fooserver2.example.com create + + # Creating a pool and add the nodes to it + f pool foopool create + f pool foopool add member fooserver1.example.com:80 + f pool foopool add member fooserver2.example.com:80 + + # Add a monitor to the pool + f pool foopool add monitor http_lbtest + + # Create a nPath HTTP service, 'nPath' also auto disables NAT and PAT + f vserver myservice.example.com:80 create PROTOCOL_TCP nPath + + # Add the pool to the service + f vserver myservice.example.com:80 set pool foopool + + # Add a nPath HTTPS service + f vserver myservice.example.com:443 create PROTOCOL_TCP nPath + f vserver myservice.example.com:443 set pool foopool + AUTHOR Paul C. Buetow - <paul@buetow.org> diff --git a/docs/fapi.1 b/docs/fapi.1 index 2db3df6..45b65c3 100644 --- a/docs/fapi.1 +++ b/docs/fapi.1 @@ -131,18 +131,8 @@ .nh .SH "NAME" fapi \- A humble command line tool to manage F5 BigIP loadbalancers -.PP -This is a simple command line client to do basic stuff with the iControl F5 API -such as: -.PP -.Vb 4 -\& Managing Nodes -\& Managing Monitors -\& Managing Pools -\& Managing Virtual Servers -.Ve -.SH "Synopsis" -.IX Header "Synopsis" +.SH "SYNOPSIS" +.IX Header "SYNOPSIS" Just run .PP .Vb 1 @@ -156,8 +146,24 @@ or .Ve .PP because it's shorter to type. -.SH "bigsuds" -.IX Header "bigsuds" +.SH "ABOUT" +.IX Header "ABOUT" +This is a simple command line client to do basic stuff with the iControl F5 \s-1API\s0 +such as: +.PP +.Vb 4 +\& Managing Nodes +\& Managing Monitors +\& Managing Pools +\& Managing Virtual Servers +.Ve +.PP +This is a private programming project programmed in my spare time. Therefore I +didn't bother to put it on a public website and github. Please open bug +reports, feature requests and pull requests at +<https://github.com/rantanplan/fapi>. +.SH "BIGSUDS" +.IX Header "BIGSUDS" .SS "Requirement of bigsuds" .IX Subsection "Requirement of bigsuds" This tool depends on bigsuds. Please install this library from F5 dev central @@ -172,15 +178,15 @@ Unzip it and run .Vb 1 \& sudo python setyp.py install .Ve +.PP +You may also install bigsuds from the contrib dir of the fapi source tree. .SS "iControl reference" .IX Subsection "iControl reference" Through bigsuds you can do everything what iControl can do: .PP <https://devcentral.f5.com/wiki/icontrol.apireference.ashx> -.SH "Quick start" -.IX Header "Quick start" -.SS "Installing" -.IX Subsection "Installing" +.SH "QUICK START" +.IX Header "QUICK START" Update your sources list: .PP .Vb 4 @@ -197,6 +203,45 @@ And run \& cp /usr/share/fapi/fapi.conf.sample ~/.fapi.conf \& vim ~/.fapi.conf .Ve +.SH "EXAMPLES" +.IX Header "EXAMPLES" +.SS "Setting up simple \s-1NAT\s0 Services" +.IX Subsection "Setting up simple NAT Services" +.Vb 1 +\& (Docu to be written) +.Ve +.SS "Setting up simple \s-1SNAT\s0 Services" +.IX Subsection "Setting up simple SNAT Services" +.Vb 1 +\& (Docu to be written) +.Ve +.SS "Setting up a simple nPath Service" +.IX Subsection "Setting up a simple nPath Service" +A simple nPath service can be created as follows. +.PP +.Vb 3 +\& # Creating two nodes, auto resolve the IP addresses +\& f node fooserver1.example.com create +\& f node fooserver2.example.com create +\& +\& # Creating a pool and add the nodes to it +\& f pool foopool create +\& f pool foopool add member fooserver1.example.com:80 +\& f pool foopool add member fooserver2.example.com:80 +\& +\& # Add a monitor to the pool +\& f pool foopool add monitor http_lbtest +\& +\& # Create a nPath HTTP service, \*(AqnPath\*(Aq also auto disables NAT and PAT +\& f vserver myservice.example.com:80 create PROTOCOL_TCP nPath +\& +\& # Add the pool to the service +\& f vserver myservice.example.com:80 set pool foopool +\& +\& # Add a nPath HTTPS service +\& f vserver myservice.example.com:443 create PROTOCOL_TCP nPath +\& f vserver myservice.example.com:443 set pool foopool +.Ve .SH "AUTHOR" .IX Header "AUTHOR" Paul C. Buetow \- <paul@buetow.org> diff --git a/docs/fapi.pod b/docs/fapi.pod index cc0dcc7..f77c0ed 100644 --- a/docs/fapi.pod +++ b/docs/fapi.pod @@ -2,6 +2,20 @@ fapi - A humble command line tool to manage F5 BigIP loadbalancers +=head1 SYNOPSIS + +Just run + + fapi -h + +or + + f -h + +because it's shorter to type. + +=head1 ABOUT + This is a simple command line client to do basic stuff with the iControl F5 API such as: @@ -12,20 +26,11 @@ such as: This is a private programming project programmed in my spare time. Therefore I -didn't bother to put it on a public website and github. - -=head1 Synopsis - -Just run - - fapi -h - -or +didn't bother to put it on a public website and github. Please open bug +reports, feature requests and pull requests at +L<https://github.com/rantanplan/fapi>. - f -h -because it's shorter to type. - -=head1 bigsuds +=head1 BIGSUDS =head2 Requirement of bigsuds @@ -40,6 +45,8 @@ Unzip it and run sudo python setyp.py install +You may also install bigsuds from the contrib dir of the fapi source tree. + =head2 iControl reference Through bigsuds you can do everything what iControl can do: @@ -47,9 +54,7 @@ Through bigsuds you can do everything what iControl can do: L<https://devcentral.f5.com/wiki/icontrol.apireference.ashx> -=head1 Quick start - -=head2 Installing +=head1 QUICK START Update your sources list: @@ -64,6 +69,43 @@ And run cp /usr/share/fapi/fapi.conf.sample ~/.fapi.conf vim ~/.fapi.conf + +=head1 EXAMPLES + +=head2 Setting up simple NAT Services + + (Docu to be written) + +=head2 Setting up simple SNAT Services + + (Docu to be written) + +=head2 Setting up a simple nPath Service + +A simple nPath service can be created as follows. + + # Creating two nodes, auto resolve the IP addresses + f node fooserver1.example.com create + f node fooserver2.example.com create + + # Creating a pool and add the nodes to it + f pool foopool create + f pool foopool add member fooserver1.example.com:80 + f pool foopool add member fooserver2.example.com:80 + + # Add a monitor to the pool + f pool foopool add monitor http_lbtest + + # Create a nPath HTTP service, 'nPath' also auto disables NAT and PAT + f vserver myservice.example.com:80 create PROTOCOL_TCP nPath + + # Add the pool to the service + f vserver myservice.example.com:80 set pool foopool + + # Add a nPath HTTPS service + f vserver myservice.example.com:443 create PROTOCOL_TCP nPath + f vserver myservice.example.com:443 set pool foopool + =head1 AUTHOR Paul C. Buetow - <paul@buetow.org> diff --git a/docs/fapi.txt b/docs/fapi.txt index b428d34..a5cd214 100644 --- a/docs/fapi.txt +++ b/docs/fapi.txt @@ -1,15 +1,7 @@ NAME fapi - A humble command line tool to manage F5 BigIP loadbalancers - This is a simple command line client to do basic stuff with the iControl - F5 API such as: - - Managing Nodes - Managing Monitors - Managing Pools - Managing Virtual Servers - -Synopsis +SYNOPSIS Just run fapi -h @@ -20,7 +12,21 @@ Synopsis because it's shorter to type. -bigsuds +ABOUT + This is a simple command line client to do basic stuff with the iControl + F5 API such as: + + Managing Nodes + Managing Monitors + Managing Pools + Managing Virtual Servers + + This is a private programming project programmed in my spare time. + Therefore I didn't bother to put it on a public website and github. + Please open bug reports, feature requests and pull requests at + <https://github.com/rantanplan/fapi>. + +BIGSUDS Requirement of bigsuds This tool depends on bigsuds. Please install this library from F5 dev central manually. Otherwise this script will not work. @@ -33,13 +39,15 @@ bigsuds sudo python setyp.py install + You may also install bigsuds from the contrib dir of the fapi source + tree. + iControl reference Through bigsuds you can do everything what iControl can do: <https://devcentral.f5.com/wiki/icontrol.apireference.ashx> -Quick start - Installing +QUICK START Update your sources list: curl http://deb.buetow.org/apt/pubkey.gpg | sudo apt-key add - @@ -53,6 +61,38 @@ Quick start cp /usr/share/fapi/fapi.conf.sample ~/.fapi.conf vim ~/.fapi.conf +EXAMPLES + Setting up simple NAT Services + (Docu to be written) + + Setting up simple SNAT Services + (Docu to be written) + + Setting up a simple nPath Service + A simple nPath service can be created as follows. + + # Creating two nodes, auto resolve the IP addresses + f node fooserver1.example.com create + f node fooserver2.example.com create + + # Creating a pool and add the nodes to it + f pool foopool create + f pool foopool add member fooserver1.example.com:80 + f pool foopool add member fooserver2.example.com:80 + + # Add a monitor to the pool + f pool foopool add monitor http_lbtest + + # Create a nPath HTTP service, 'nPath' also auto disables NAT and PAT + f vserver myservice.example.com:80 create PROTOCOL_TCP nPath + + # Add the pool to the service + f vserver myservice.example.com:80 set pool foopool + + # Add a nPath HTTPS service + f vserver myservice.example.com:443 create PROTOCOL_TCP nPath + f vserver myservice.example.com:443 set pool foopool + AUTHOR Paul C. Buetow - <paul@buetow.org> |