netscalerautomaon - virtues.it · puppet expert! blog: about)hendricus your ... introduction >...

NetScaler Automa.on USING PUPPET TO TALK NITRO

Lisbon 2015 #E2EVC 2

§  15+ years of Technical Consulting

§  Senior Consultant at PepperByte §  MSc Computer Science §  Design | Implement | Troubleshooting §  Small <-> Large infrastructures §  Government | Industry | Commerce

§  Citrix Technology Professional (Class of 2015)

§  Author of: §  Citrix XenApp 6.5 Expert Cookbook

Your Presenter: Esther Barthel Senior Technical Consultant

@virtues_IT hBp://nl.linkedin.com/in/ebarthel hBp://www.virtues.it

About Esther


§  10+ years of Technical Consulting §  Consultant at PepperByte §  Design | Implement | Troubleshooting §  Small <-> Large infrastructures §  Government | Industry | Commerce

§  Puppet expert §  Blog: http://www.puppetblog.nl/

About Hendricus

Your Presenter: Hendricus Kramer Technical Consultant

@HendricusK hBp:// www.linkedin.com/in/hendricus hBp://www.hendric.us

Agenda

q  Introduc*on q  RESTful APIs & NITRO q  Puppet NetScaler Module

q  Automa*ng NetScaler Configura*ons q  NetScaler System se@ngs q  NetScaler Load Balancing

q  Demo

q  Bonus q  Deploy NetScaler VPX with fixed IP-‐address q  Upload files to the NetScaler


RESTful APIs  REpresentaNonal State Transfer (REST): ◦  Client-‐Server ◦  Stateless ◦  PlaNorm & language-‐independent ◦  Standards-‐based (runs on top of HTTP) ◦  Can easily be used in presence of firewalls

 NITRO (RESTful service on NetScaler): ◦  Communicate with NetScaler programma*cally ◦  Human readable HTTP-‐based interac*on ◦  NITRO SDKs available for mul*ple languages (Java, Python, .NET, REST)

Introduction > Automation > Bonus


RESTful APIs  A way to interact with an API via series on HTTP calls

◦  VERB: HTTP Method (GET, PUT, POST, DELETE, OPTIONS) ◦  URI: the URI of the resource on which the opera*on is performed ◦  HTTP Version: usually "HTTP v1.1" ◦  Request Header: contains metadata (forma@ng, etc.) ◦  Request Body: actual message content



NITRO  A way to interact with an API via series on HTTP calls

◦  HTTP Method (GET, PUT, POST, DELETE, OPTIONS)

◦  There are two basic URL stems to use with Nitro: ◦  h[p://<NSIP>/nitro/v1/stat/ –> en*ty and system sta*s*cs ◦  h[p://<NSIP>/nitro/v1/config/ –> configura*on opera*ons

◦  Add the resource type (and in some cases also the resource name) to the URL: ◦  h[p://<NSIP>/nitro/v1/config/nsfeature/feature

◦  Specify an acNon (bind, add, enable, ...) for the URL: ◦  h[p://<NSIP>/nitro/v1/config/nsfeature?acNon=enable




◦  Specify the Content-‐Type in the Request Header: ◦  Content-‐Type:applica*on/vnd.com.citrix.netscaler.nsfeature+json

◦  Add the JSON payload to the Request Body:



NITRO Why use NITRO? ◦  Simple HTTP calls for data exchange between systems ◦  Programs or scripts can include NetScaler sta*s*cs

◦  If server load = max, then automa*cally enable more services on the NetScaler ◦  Build your own automated NetScaler deployments

◦  Essen*al for datacenter automa*on/SDN

NITRO Enhancements in 10.5 ◦  Python SDK ◦  File Opera*ons (automa*cally upload license and cer*ficate files) ◦  New APIs (techsupport, batch, nstrace) ◦  SSH Commands (ping, traceroute)



NITRO requirements  NetScaler 9.2 or later ◦  Authen*cate with an account with execute permissions ◦  Access to the NetScaler NSIP (or SNIP) with Management Access enabled

 REST Client or programming language ◦  Use a client like cURL & POSTMAN, or ◦  Download and install the NITRO SDK for your programming language



NITRO Documenta.on



Citrix Blog


source: h[ps://www.citrix.com/blogs/2014/10/08/scrip*ng-‐automa*ng-‐netscaler-‐configura*ons-‐using-‐nitro-‐rest-‐api-‐and-‐powershell-‐part-‐5/


NITRO & PowerShell



Puppet NetScaler Module

source: h[ps://forge.puppetlabs.com/puppetlabs/netscaler



NetScaler Automa.on w/ puppet  What can we automate with the NetScaler Puppet Module?


Global NetScaler Features Load Balancing

File (.cert, .key, .txt) Content Switching

User & Groups SSL

Hostname Server & Service defini*ons

NetScaler IP Addresses Monitors

NTP Server Configura*on Responder

Routes Rewrite

SNMP Configura*ons VLANs


NetScaler Automa.on Sample NetScaler Features



NetScaler Automa.on w/ CLI NetScaler Features

 NetScaler CLI:



NetScaler Automa.on w/ NITRO NetScaler Features

 NITRO (REST):



NetScaler Automa.on w/ Puppet NetScaler Features

 Puppet:



NetScaler Automa.on w/ PowerShell NetScaler Features

 PowerShell:



NetScaler Automa.on w/ PowerShell & REST



NetScaler Automa.on w/ Puppet Basic System Segngs



NetScaler Automa.on w/ Puppet NetScaler Load Balancing



Puppet in Ac.on



Bonus: NetScaler VPX with fixed IP CTX128236: How To Auto-‐Provision NetScaler VPX on XenServer


Read all the details in the blogpost at: h[p://www.virtues.it/2015/11/ps-‐import-‐ns-‐vpx-‐fixed-‐ip-‐on-‐xs


Script in Ac.on



Bonus: Upload files to the NetScaler NITRO can perform file uploads up to 2 MB



Bonus: Upload files to the NetScaler  PowerShell File Upload w/ WinSCP Wrapper

source: h[p://dotps1.github.io/WinSCP/


Read all the details in the blogpost at: h[p://www.virtues.it/2015/11/ps-‐upload-‐file-‐with-‐winscp-‐wrapper

Hendricus Kramer Technical Consultant

@Hendricusk hBp://www.linkedin.com/en/hendricus hBp://www.hendric.us

Presented by: Esther Barthel Senior Technical Consultant

@virtues_IT hBp://nl.linkedin.com/in/ebarthel hBp://www.virtues.it


Resources  Citrix blogs: ◦  h[ps://www.citrix.com/blogs/2014/09/19/scrip*ng-‐automa*ng-‐netscaler-‐configura*ons-‐using-‐nitro-‐rest-‐api-‐and-‐powershell-‐part-‐1/

◦  h[ps://www.citrix.com/blogs/2014/02/04/using-‐curl-‐with-‐the-‐netscaler-‐nitro-‐rest-‐api/ ◦  h[p://support.citrix.com/ar*cle/CTX128236

 NetScaler Masterclasses: ◦  h[ps://www.citrix.com/events/netscaler-‐master-‐class.html

 WinSCP Wrapper: ◦  h[p://dotps1.github.io/WinSCP/

 Puppet NetScaler Module: ◦  h[ps://forge.puppetlabs.com/puppetlabs/netscaler/readme

netscalerautomaon - virtues.it · puppet expert! blog: about)hendricus your ... introduction >...

Documents