Input

book: Create a structured PDF document with headings, chapters, etc.
webpage: Specifies that the HTML sources are unstructured (plain web pages.) A page break is inserted between each file or URL in the output.
continuous: Specifies that the HTML sources are unstructured (plain web pages.) No page breaks are inserted between each file or URL in the output.
Title of the document for the front page.
Extract the first heading of the document and use it as title. If checked the title field has no effect.
The title image or HTML page. These file has to be an attachments!
Specify document version to be displayed on the title page.
Intellectual property owner of this document.
Copyright notice for this document.
Information about who and when modified the document are applied at the end.

Output

Specifies the output format.
Grayscale document  Title page
Compression :   JPEG big images 

Pagina

 
User defined page size 		 Choose one of the predefined standard sizes or select user defined.
Specifies the page size using a standard name or in points (no suffix or ##x##pt), inches (##x##in), centimeters (##x##cm), or millimeters (##x##mm).
Set the target browser width in pixels (400-1200). This determines the page scaling of images.
   2-Sided   Landscape
   
   
   
Specifies the margin size using points (no suffix or ##x##pt), inches (##x##in), centimeters (##x##cm), or millimeters (##x##mm). Keep empty for default value.
Left
Middle
Right
Sets the page header to use on body pages.
Left
Middle
Right
Sets the page footer to use on body pages.

Indice

Sets the number of levels in the table-of-contents. Empty for unlimited levels.
   Numbered headings Check to number all of the headings in the document.
Sets the title for the table-of-contents. Empty for default title.
Left
Middle
Right
Sets the page header to use on table-of-contents pages.
Left
Middle
Right
Sets the page footer to use on table-of-contents pages.

Colors

Enter the HTML color for the body (background).
Enter the image file for the body (background). These file has to be an attachments!
Enter the HTML color for the text.
Sets the color of links.
Enables generation of links in PDF files.

Fonts

Set the default size of text.
Set the spacing between lines of text.
Choose the default typeface (font) of text.
Choose the default typeface (font) of headings.
Set the size of header and footer text.
Choose the font for header and footer text.
Change the encoding of the text in document.
Check to embed font in the output file.

PDF

Controls the initial viewing mode for the document.
Document: Displays only the docuemnt pages.
Outline: Display the table-of-contents outline as well as the document pages.
Full-screen: Displays pages on the whole screen; this mode is used primarily for presentations.
Controls the initial layout of document pages on the screen.
Single: Displays a single page at a time.
One column: Displays a single column of pages at a time.
Two column left/right: Display two columns of pages at a time; the first page is displayed in the left or right column as selected.
Choose the initial page that will be shown.

Security

Check to number all of the headings in the document.
 Versione stampabile   Modify
 Copy   Annotate		 Specifies the document permissions.
Specifies the user password to restrict viewing permissions on this PDF document. Empty for no encryption.
Specifies the owner password to control who can change document permissions etc. If this field is left blank, a random 32-character password is generated so that no one can change the document.

Expert

Specify language to use for date and time format.
Shrink code blocks on page.
Show line numbers for code blocks.
Make spaces visable by dots (·) instead of white spaces.
Make line breaks visable by a extra character (¶) at the end.
Enable this feature if you searching for problems or intent to report a bug report

About

Version 2.4.2 (MoinMoin 1.9.7)


MoinMoin - Generate PDF document using HTMLDOC

This action script generate PDF documents from a Wiki site using
the HTMLDOC (http://www.htmldoc.org) software packages which has
to be preinstalled first.

Copy this script in your's MoinMoin action script plugin directory.

Thanks goes to Pascal Bauermeister who initiated the implementaion.
Lot of things changes since then but the idear using HTMLDOC is the
main concept of this implementation.

Please visit the homepage for further informations:
http://moinmo.in/ActionMarket/PdfAction

@copyright: (C) 2006 Pascal Bauermeister
@copyright: (C) 2006-2010 Raphael Bossek <raphael.bossek@solutions4linux.de>
@license: GNU GPL, see COPYING for details

       

Italiano English
Modifica History Actions

ConfineVMHowTo

Le sedi di Ninux sono:

a Roma presso il FusoLab

  • Fusolab

a Pisa all'EigenLab

  • Eingelab

a Cosenza presso la sede dell'Hacklab Cosenza

  • HLCS

a Catanzaro presso la sede dell'Hacklab Catanzaro

  • HLCZ

a Firenze presso l'exfila

  • exfila

a Bologna presso il makerspace di RaspiBO

  • NinuxBO

Ninux.org partecipa al World IPv6 day

  • WorldIpv6Day

Come creare macchine virtuali per esperimenti e servizi sperimentali in CONFINE

CONFINE è un progetto di ricerca che ha l’obiettivo di costruire un’infrastruttura all’interno di varie community network europee per metterla a disposizione dei ricercatori, che possono così studiare reti reali, con utenti veri, anziché limitarsi ad esperimenti in laboratorio o simulati.

Questa guida spiega come creare Sliver, ovvero macchine virtuali, per effettuare esperimenti o fornire servizi sperimentali, all'interno dell'infrastruttura CommunityLab di CONFINE.

Vedere anche ConfineHowTo

Indice

  1. Come creare macchine virtuali per esperimenti e servizi sperimentali in CONFINE
    1. Concetti di base
    2. Creazione di una slice
    3. Accedere alle sliver
    4. VPN di management (tinc)
    5. Limitazioni attuali
    6. REST API
    7. TODO

Concetti di base

Per poter utilizzare CommunityLab sono necessarie alcune conoscenze sulla terminologia e l'architettura.

architecture.png

Per nodi o research device si intendono computer (tipicamente Intel NUC) sparsi all'interno della community network.

I research device possono ospitare zero o piu' macchine virtuali o sliver. Queste sono basate sui linux container (LXC).

Una slice è una collezione di sliver ospitate su più research device che tipicamente fanno parte dello stesso esperimento o servizio.

Ogni sliver è basata su un template, ovvero la distribuzione Linux (tipicamente OpenWrt o Debian) che viene installata al momento della creazione della sliver.

Le sliver hanno tipicamente tre tipi principali di indirizzi:

  • indirizzi privati, appartenenti alla subnet 192.168.157.0/24, validi solo all'interno del research device (in un bridge virtuale interno). Di solito possono essere ignorati. L'interfaccia corrispondente ha di default il nome priv all'interno della sliver

  • indirizzi di management, appartenenti alla subnet fdf5:5351:1dfd::/48, raggiungibili tramite la VPN di management tinc (vedere sotto). L'interfaccia corrispondente ha di default il nome mgmt0 all'interno della sliver

  • indirizzi community-public, assegnati dal server DHCP locale e raggiungibili all'interno della community network (ad esempio 10.176.0.118/24). Spesso questi indirizzi sono chiamati pubblici all'interno di CommunityLab, anche se si tratta indirizzi IP privati RFC1918. L'interfaccia corrispondente ha di default il nome pub0 all'interno della sliver

Per maggiori informazioni vedere Node architecture

Creazione di una slice

Ecco i passi necessari per la creazione di una slice all'interno di CommunityLab.

  • fare il log-in su https://panel.community-lab.net . In caso non si disponga di un account bisogna registrarsi

  • cliccare sul proprio nome in alto a destra per accedere al proprio profilo

  • verificare che si disponga dei permessi di "Slice admin (researcher)" per il gruppo ninux.org. In caso contrario scrivere a <clauz AT NONMISPAMMARE ninux DOT org> per farsi abilitare

  • aggiungere una o più chiavi SSH nella sezione authentication tokens

screenshot_ssh_key.png

  • salvare

  • cliccare su "SLICES->SLICES" in alto

  • cliccare su "add slice"

screenshot_slices.png

  • scegliere un nome per la slice
  • scegliere il gruppo "ninux.org"
  • opzionalmente, scegliere in "resource requests" lo spazio su disco da allocare per ogni sliver (il default e' circa 200MiB, il massimo 1000MiB)

screenshot_slice_resources.png

  • scegliere il template (ad esempio "Debian Squeeze (debian)")
  • lasciare il "set state" su "START"
  • salvare la slice

  • in basso sulla pagina cliccare su "add slivers"

screenshot_add_slivers.png

  • scegliere su quali nodi creare le sliver: per rendere più semplice la selezione, usare la colonna a destra cliccando su "By set state PRODUCTION" e "By group ninux.org"

screenshot_choose_nodes.png

  • cliccare su "Create slivers"

  • nella schermata successiva selezionare le opzioni "public4" (indispensabile per i servizi) e "management" (di default già selezionata)

screenshot_interfaces.png

  • cliccare su "Yes, create slivers"

  • nella pagina relativa alla slice cambiare il set state da "REGISTER" a "START"

  • la creazione delle sliver sui nodi selezionati richiede tempi dell'ordine della decina di minuti

Accedere alle sliver

  • per vedere la lista delle sliver cliccare su "SLICES->SLIVERS" in alto

  • per vedere solamente le sliver associate alla propria slice cliccare sulla colonna di destra sul nome della slice
  • le sliver che si trovano nello stato "STARTED" sono quelle effettivamente utilizzabili

screenshot_sliverlist.png

  • cliccando sullo stato ("STARTED") si accede ad una pagina che mostra varie informazioni sulla sliver, tra cui gli indirizzi community-public e di management

screenshot_sliverstate_json.png

  • se ci si trova all'interno della community network allora si puo' accedere direttamente in SSH alla sliver usando l'indirizzo "public4" della sliver e utente root, altrimenti bisogna utilizzare l'indrizzo di management attraverso la VPN (vedere sotto)

VPN di management (tinc)

La VPN di management è unica per tutti i nodi e le sliver ed è basata sul software VPN tinc.

Per accedere alla VPN:

  • andare in alto su "TINC->HOSTS"

  • cliccare su "Add Host" a destra

  • scegliere un nome per la macchina da aggiungere alla vpn di management
  • scegliere come isola "ninux.org"
  • lasciare il resto vuoto e cliccare su "save and continue editing"

  • clicare su "Help" in alto a destra (consiglio: aprire in un nuovo tab)

  • seguire le istruzioni dettagliate riportate sulla pagina

  • dopo aver generato le chiavi tinc con il comando tincd -n communitylab -K aprire di nuovo la pagina di modifica dell'host tinc (o passare al tab precedente) e copiare e incollare all'interno del campo "public key" la chiave pubblica generata

screenshot_tinc_key.png

  • salvare
  • avviare tinc seguendo le istruzioni che si trovano in fondo alla pagina "Help" (aperta in precedenza)

  • provare a pingare il server: ping6 fdf5:5351:1dfd::2

Limitazioni attuali

  • il massimo spazio disco allocabile per è al momento 1GiB
  • i dati scritti su disco vengono persi al riavvio della sliver (o del research device)
  • le periferiche USB (dischi, pennette) non sono visti dalle sliver (a meno di non agire sulla configurazione delle sliver a livello di research device)

REST API

Community-Lab espone un'API che può essere utilizzata per ottenere informazioni sullo stato delle sliver e dei nodi, per creare e distruggere sliver, etc.

Documentazione: http://wiki.confine-project.eu/arch:rest-api Esempi: http://redmine.confine-project.eu/projects/confine-utils/repository

TODO

  • guida alla creazione template personalizzati
  • uso di "experiment data"
  • FAQ
  • tips and tricks