from sface.rspecwindow import RSpecWindow
from sface.screens.configscreen import ConfigScreen
from sface.screens.mainscreen import MainScreen
+from sface.screens.helpscreen import HelpScreen
class Nav(QWidget):
def __init__(self, parent=None):
self.config = QLabel("", self)
self.config.setAlignment(Qt.AlignRight)
+ self.help = QLabel("", self)
+ self.help.setAlignment(Qt.AlignRight)
+
hlayout = QHBoxLayout()
hlayout.addWidget(self.title)
hlayout.addStretch()
hlayout.addWidget(QLabel("Go to: ", self))
hlayout.addWidget(self.main)
hlayout.addWidget(self.config)
+ hlayout.addWidget(self.help)
self.setLayout(hlayout)
def setTitle(self, title):
self.title.setText(title)
- def setLinks(self, main, config):
+ def setLinks(self, main, config, help):
self.main.setText(main)
self.config.setText(config)
+ self.help.setText(help)
class Status(QLabel):
self.pix = QLabel(self)
self.config_screen = ConfigScreen(self)
self.main_screen = MainScreen(self)
+ self.help_screen = HelpScreen(self)
self.screens = QStackedWidget(self)
self.screens.addWidget(self.main_screen)
self.screens.addWidget(self.config_screen)
+ self.screens.addWidget(self.help_screen)
self.screens.addWidget(self.pix)
self.next_screen = None
self.nav = Nav(self)
self.nav.setTitle(self.main_screen.getTitleText())
self.nav.setLinks(self.main_screen.getLinkText(),
- self.config_screen.getLinkText())
+ self.config_screen.getLinkText(),
+ self.help_screen.getLinkText())
self.status = Status(self)
self.log = QLabel("<a href='showlog'>Show Log</a>", self)
self.setLayout(layout)
self.resize(800, 600)
- for link in (self.nav.main, self.nav.config):
+ for link in (self.nav.main, self.nav.config, self.nav.help):
self.connect(link, SIGNAL('linkActivated(QString)'),
self.animateToScreen)
self.next_screen = self.config_screen
elif link == self.main_screen.name:
self.next_screen = self.main_screen
+ elif link == self.help_screen.name:
+ self.next_screen = self.help_screen
curr_screen = self.screens.currentWidget()
self.toConfigScreen()
elif self.next_screen == self.main_screen:
self.toMainScreen()
+ elif self.next_screen == self.help_screen:
+ self.toHelpScreen()
def toConfigScreen(self):
self.screens.setCurrentWidget(self.config_screen)
self.nav.setTitle(self.config_screen.getTitleText())
+ def toHelpScreen(self):
+ self.screens.setCurrentWidget(self.help_screen)
+ self.nav.setTitle(self.help_screen.getTitleText())
+
def toMainScreen(self):
self.screens.setCurrentWidget(self.main_screen)
self.nav.setTitle(self.main_screen.getTitleText())
--- /dev/null
+
+from PyQt4.QtCore import *
+from PyQt4.QtGui import *
+
+from sface.screens.sfascreen import SfaScreen
+
+class HelpWidget(QWidget):
+ def __init__(self, parent):
+ QWidget.__init__(self, parent)
+ self.showHelpText()
+
+ def showHelpText(self):
+ layout = QVBoxLayout(self)
+ layout.setAlignment(Qt.AlignTop)
+
+ text = QLabel(self)
+ text.setWordWrap(True)
+ text.setOpenExternalLinks(True)
+ text.setText("""
+<p>The <em>PlanetLab Federation</em> is a collection of testbeds that
+have joined forces using the <em>Slice Federation Architecture</em>
+(SFA).</p>
+
+<p>This GUI allows users of OneLab and PlanetLab to allocate resources
+belonging to any federated testbed to an existing slice. To use it,
+follow these steps:</p>
+
+<ol>
+
+<li>Go to the <b>Configure</b> screen and configure your slice, user,
+and user authority HRNs.</li>
+
+<li>Go to the <b>Main Window</b> and click <b>Update Slice
+Data</b>. This will load the set of resources currently allocated to
+your slice, and group them by testbeds. Expand the entry for a
+particular testbed to see the resources allocated there.</li>
+
+<li>To modify the resources allocated to your slice:
+
+ <ul>
+
+ <li>Double click a node to toggle its status.</li>
+
+ <li>Expand a node to see the tags assigned to that node. Right click
+ on the node to add a new tag. Double click on a tag to toggle its
+ status.</li>
+
+ <li>The first entry for each testbed begins with <em>Default
+ tags</em>. Expand this to see the set of tags that applies to all
+ nodes in the testbed. Right click on it to add a new default
+ tag. Double click on a tag to toggle its status.</li>
+
+ </ul>
+
+</li>
+
+<li>After you have made your changes, click <b>Submit</b>. This will
+submit your changes and then refresh the set of slice resources to
+reflect the current allocation. No changes are made to your slice
+allocation until you click <b>Submit</b>.</li>
+
+</ol>
+
+<p>This GUI was built by the OneLab and PlanetLab teams. Please send
+feedback on its usefulness to <a href="mailto:support@planet-lab.org">support@planet-lab.org</a></p>
+""")
+ text.setTextFormat(Qt.RichText)
+ layout.addWidget(text)
+
+class HelpScreen(SfaScreen):
+ def __init__(self, parent):
+ SfaScreen.__init__(self, parent)
+
+ widget = HelpWidget(self)
+ self.init(widget, "Help", "How to use the OneLab Federation GUI")