planetlab4.sql

   1 --
   2 -- PlanetLab Central database schema
   3 -- Version 4, PostgreSQL
   4 --
   5 -- Aaron Klingaman <alk@cs.princeton.edu>
   6 -- Reid Moran <rmoran@cs.princeton.edu>
   7 -- Mark Huang <mlhuang@cs.princeton.edu>
   8 -- Tony Mack <tmack@cs.princeton.edu>
   9 --
  10 -- Copyright (C) 2006 The Trustees of Princeton University
  11 --
  12 -- $Id: planetlab4.sql,v 1.71 2007/02/01 23:05:59 mlhuang Exp $
  13 --
  14
  15 SET client_encoding = 'UNICODE';
  16
  17 --------------------------------------------------------------------------------
  18 -- Aggregates and store procedures
  19 --------------------------------------------------------------------------------
  20
  21 -- Like MySQL GROUP_CONCAT(), this function aggregates values into a
  22 -- PostgreSQL array.
  23 CREATE AGGREGATE array_accum (
  24     sfunc = array_append,
  25     basetype = anyelement,
  26     stype = anyarray,
  27     initcond = '{}'
  28 );
  29
  30 --------------------------------------------------------------------------------
  31 -- Version
  32 --------------------------------------------------------------------------------
  33
  34 -- Database version
  35 CREATE TABLE plc_db_version (
  36     version integer NOT NULL,
  37     subversion integer NOT NULL DEFAULT 0
  38 ) WITH OIDS;
  39
  40 INSERT INTO plc_db_version (version, subversion) VALUES (4, 2);
  41
  42 --------------------------------------------------------------------------------
  43 -- Accounts
  44 --------------------------------------------------------------------------------
  45
  46 -- Accounts
  47 CREATE TABLE persons (
  48     -- Mandatory
  49     person_id serial PRIMARY KEY, -- Account identifier
  50     email text NOT NULL, -- E-mail address
  51     first_name text NOT NULL, -- First name
  52     last_name text NOT NULL, -- Last name
  53     deleted boolean NOT NULL DEFAULT false, -- Has been deleted
  54     enabled boolean NOT NULL DEFAULT false, -- Has been disabled
  55
  56     -- Password
  57     password text NOT NULL DEFAULT 'nopass', -- Password (md5crypted)
  58     verification_key text, -- Reset password key
  59     verification_expires timestamp without time zone,
  60
  61     -- Optional
  62     title text, -- Honorific
  63     phone text, -- Telephone number
  64     url text, -- Home page
  65     bio text, -- Biography
  66
  67     -- Timestamps
  68     date_created timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP,
  69     last_updated timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP
  70 ) WITH OIDS;
  71 CREATE INDEX persons_email_idx ON persons (email) WHERE deleted IS false;
  72
  73 --------------------------------------------------------------------------------
  74 -- Sites
  75 --------------------------------------------------------------------------------
  76
  77 -- Sites
  78 CREATE TABLE sites (
  79     -- Mandatory
  80     site_id serial PRIMARY KEY, -- Site identifier
  81     login_base text NOT NULL, -- Site slice prefix
  82     name text NOT NULL, -- Site name
  83     abbreviated_name text NOT NULL, -- Site abbreviated name
  84     enabled boolean NOT NULL Default true, -- Is this site enabled
  85     deleted boolean NOT NULL DEFAULT false, -- Has been deleted
  86     is_public boolean NOT NULL DEFAULT true, -- Shows up in public lists
  87     max_slices integer NOT NULL DEFAULT 0, -- Maximum number of slices
  88     max_slivers integer NOT NULL DEFAULT 1000, -- Maximum number of instantiated slivers
  89
  90     -- Optional
  91     latitude real,
  92     longitude real,
  93     url text,
  94     ext_consortium_id integer,  -- external consortium id
  95
  96     -- Timestamps
  97     date_created timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP,
  98     last_updated timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP
  99 ) WITH OIDS;
 100 CREATE INDEX sites_login_base_idx ON sites (login_base) WHERE deleted IS false;
 101
 102 -- Account site membership
 103 CREATE TABLE person_site (
 104     person_id integer REFERENCES persons NOT NULL, -- Account identifier
 105     site_id integer REFERENCES sites NOT NULL, -- Site identifier
 106     is_primary boolean NOT NULL DEFAULT false, -- Is the primary site for this account
 107     PRIMARY KEY (person_id, site_id)
 108 );
 109 CREATE INDEX person_site_person_id_idx ON person_site (person_id);
 110 CREATE INDEX person_site_site_id_idx ON person_site (site_id);
 111
 112 -- Ordered by primary site first
 113 CREATE VIEW person_site_ordered AS
 114 SELECT person_id, site_id
 115 FROM person_site
 116 ORDER BY is_primary DESC;
 117
 118 -- Sites that each person is a member of
 119 CREATE VIEW person_sites AS
 120 SELECT person_id,
 121 array_accum(site_id) AS site_ids
 122 FROM person_site_ordered
 123 GROUP BY person_id;
 124
 125 -- Accounts at each site
 126 CREATE VIEW site_persons AS
 127 SELECT site_id,
 128 array_accum(person_id) AS person_ids
 129 FROM person_site
 130 GROUP BY site_id;
 131
 132 --------------------------------------------------------------------------------
 133 -- Mailing Addresses
 134 --------------------------------------------------------------------------------
 135
 136 CREATE TABLE address_types (
 137     address_type_id serial PRIMARY KEY, -- Address type identifier
 138     name text UNIQUE NOT NULL, -- Address type
 139     description text -- Address type description
 140 ) WITH OIDS;
 141
 142 INSERT INTO address_types (name) VALUES ('Personal');
 143 INSERT INTO address_types (name) VALUES ('Shipping');
 144 -- XXX Used to be Site
 145 INSERT INTO address_types (name) VALUES ('Billing');
 146
 147 -- Mailing addresses
 148 CREATE TABLE addresses (
 149     address_id serial PRIMARY KEY, -- Address identifier
 150     line1 text NOT NULL, -- Address line 1
 151     line2 text, -- Address line 2
 152     line3 text, -- Address line 3
 153     city text NOT NULL, -- City
 154     state text NOT NULL, -- State or province
 155     postalcode text NOT NULL, -- Postal code
 156     country text NOT NULL -- Country
 157 ) WITH OIDS;
 158
 159 -- Each mailing address can be one of several types
 160 CREATE TABLE address_address_type (
 161     address_id integer REFERENCES addresses NOT NULL, -- Address identifier
 162     address_type_id integer REFERENCES address_types NOT NULL, -- Address type
 163     PRIMARY KEY (address_id, address_type_id)
 164 ) WITH OIDS;
 165 CREATE INDEX address_address_type_address_id_idx ON address_address_type (address_id);
 166 CREATE INDEX address_address_type_address_type_id_idx ON address_address_type (address_type_id);
 167
 168 CREATE VIEW address_address_types AS
 169 SELECT address_id,
 170 array_accum(address_type_id) AS address_type_ids,
 171 array_accum(address_types.name) AS address_types
 172 FROM address_address_type
 173 LEFT JOIN address_types USING (address_type_id)
 174 GROUP BY address_id;
 175
 176 CREATE TABLE site_address (
 177     site_id integer REFERENCES sites NOT NULL, -- Site identifier
 178     address_id integer REFERENCES addresses NOT NULL, -- Address identifier
 179     PRIMARY KEY (site_id, address_id)
 180 ) WITH OIDS;
 181 CREATE INDEX site_address_site_id_idx ON site_address (site_id);
 182 CREATE INDEX site_address_address_id_idx ON site_address (address_id);
 183
 184 CREATE VIEW site_addresses AS
 185 SELECT site_id,
 186 array_accum(address_id) AS address_ids
 187 FROM site_address
 188 GROUP BY site_id;
 189
 190 --------------------------------------------------------------------------------
 191 -- Authentication Keys
 192 --------------------------------------------------------------------------------
 193
 194 -- Valid key types
 195 CREATE TABLE key_types (
 196     key_type text PRIMARY KEY -- Key type
 197 ) WITH OIDS;
 198 INSERT INTO key_types (key_type) VALUES ('ssh');
 199
 200 -- Authentication keys
 201 CREATE TABLE keys (
 202     key_id serial PRIMARY KEY, -- Key identifier
 203     key_type text REFERENCES key_types NOT NULL, -- Key type
 204     key text NOT NULL, -- Key material
 205     is_blacklisted boolean NOT NULL DEFAULT false -- Has been blacklisted
 206 ) WITH OIDS;
 207
 208 -- Account authentication key(s)
 209 CREATE TABLE person_key (
 210     key_id integer REFERENCES keys PRIMARY KEY, -- Key identifier
 211     person_id integer REFERENCES persons NOT NULL -- Account identifier
 212 ) WITH OIDS;
 213 CREATE INDEX person_key_person_id_idx ON person_key (person_id);
 214
 215 CREATE VIEW person_keys AS
 216 SELECT person_id,
 217 array_accum(key_id) AS key_ids
 218 FROM person_key
 219 GROUP BY person_id;
 220
 221 --------------------------------------------------------------------------------
 222 -- Account roles
 223 --------------------------------------------------------------------------------
 224
 225 -- Valid account roles
 226 CREATE TABLE roles (
 227     role_id integer PRIMARY KEY, -- Role identifier
 228     name text UNIQUE NOT NULL -- Role symbolic name
 229 ) WITH OIDS;
 230 INSERT INTO roles (role_id, name) VALUES (10, 'admin');
 231 INSERT INTO roles (role_id, name) VALUES (20, 'pi');
 232 INSERT INTO roles (role_id, name) VALUES (30, 'user');
 233 INSERT INTO roles (role_id, name) VALUES (40, 'tech');
 234
 235 CREATE TABLE person_role (
 236     person_id integer REFERENCES persons NOT NULL, -- Account identifier
 237     role_id integer REFERENCES roles NOT NULL, -- Role identifier
 238     PRIMARY KEY (person_id, role_id)
 239 ) WITH OIDS;
 240 CREATE INDEX person_role_person_id_idx ON person_role (person_id);
 241
 242 -- Account roles
 243 CREATE VIEW person_roles AS
 244 SELECT person_id,
 245 array_accum(role_id) AS role_ids,
 246 array_accum(roles.name) AS roles
 247 FROM person_role
 248 LEFT JOIN roles USING (role_id)
 249 GROUP BY person_id;
 250
 251 --------------------------------------------------------------------------------
 252 -- Nodes
 253 --------------------------------------------------------------------------------
 254
 255 -- Valid node boot states
 256 CREATE TABLE boot_states (
 257     boot_state text PRIMARY KEY
 258 ) WITH OIDS;
 259 INSERT INTO boot_states (boot_state) VALUES ('boot');
 260 INSERT INTO boot_states (boot_state) VALUES ('dbg');
 261 INSERT INTO boot_states (boot_state) VALUES ('inst');
 262 INSERT INTO boot_states (boot_state) VALUES ('rins');
 263 INSERT INTO boot_states (boot_state) VALUES ('rcnf');
 264 INSERT INTO boot_states (boot_state) VALUES ('new');
 265
 266 -- Nodes
 267 CREATE TABLE nodes (
 268     -- Mandatory
 269     node_id serial PRIMARY KEY, -- Node identifier
 270     hostname text NOT NULL, -- Node hostname
 271     site_id integer REFERENCES sites NOT NULL, -- At which site
 272
 273     boot_state text REFERENCES boot_states NOT NULL DEFAULT 'inst', -- Node boot state
 274     deleted boolean NOT NULL DEFAULT false, -- Is deleted
 275
 276     -- Optional
 277     model text, -- Hardware make and model
 278     boot_nonce text, -- Random nonce updated by Boot Manager
 279     version text, -- Boot CD version string updated by Boot Manager
 280     ssh_rsa_key text, -- SSH host key updated by Boot Manager
 281     key text, -- Node key generated by API when configuration file is downloaded
 282
 283     -- Timestamps
 284     date_created timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP,
 285     last_updated timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP
 286 ) WITH OIDS;
 287 CREATE INDEX nodes_hostname_idx ON nodes (hostname) WHERE deleted IS false;
 288 CREATE INDEX nodes_site_id_idx ON nodes (site_id) WHERE deleted IS false;
 289
 290 -- Nodes at each site
 291 CREATE VIEW site_nodes AS
 292 SELECT site_id,
 293 array_accum(node_id) AS node_ids
 294 FROM nodes
 295 GROUP BY site_id;
 296
 297 --------------------------------------------------------------------------------
 298 -- Node groups
 299 --------------------------------------------------------------------------------
 300
 301 -- Node groups
 302 CREATE TABLE nodegroups (
 303     nodegroup_id serial PRIMARY KEY, -- Group identifier
 304     name text UNIQUE NOT NULL, -- Group name
 305     description text -- Group description
 306 ) WITH OIDS;
 307
 308 -- Node group membership
 309 CREATE TABLE nodegroup_node (
 310     nodegroup_id integer REFERENCES nodegroups NOT NULL, -- Group identifier
 311     node_id integer REFERENCES nodes NOT NULL, -- Node identifier
 312     PRIMARY KEY (nodegroup_id, node_id)
 313 ) WITH OIDS;
 314 CREATE INDEX nodegroup_node_nodegroup_id_idx ON nodegroup_node (nodegroup_id);
 315 CREATE INDEX nodegroup_node_node_id_idx ON nodegroup_node (node_id);
 316
 317 -- Nodes in each node group
 318 CREATE VIEW nodegroup_nodes AS
 319 SELECT nodegroup_id,
 320 array_accum(node_id) AS node_ids
 321 FROM nodegroup_node
 322 GROUP BY nodegroup_id;
 323
 324 -- Node groups that each node is a member of
 325 CREATE VIEW node_nodegroups AS
 326 SELECT node_id,
 327 array_accum(nodegroup_id) AS nodegroup_ids
 328 FROM nodegroup_node
 329 GROUP BY node_id;
 330
 331 --------------------------------------------------------------------------------
 332 -- Node configuration files
 333 --------------------------------------------------------------------------------
 334
 335 CREATE TABLE conf_files (
 336     conf_file_id serial PRIMARY KEY, -- Configuration file identifier
 337     enabled bool NOT NULL DEFAULT true, -- Configuration file is active
 338     source text NOT NULL, -- Relative path on the boot server where file can be downloaded
 339     dest text NOT NULL, -- Absolute path where file should be installed
 340     file_permissions text NOT NULL DEFAULT '0644', -- chmod(1) permissions
 341     file_owner text NOT NULL DEFAULT 'root', -- chown(1) owner
 342     file_group text NOT NULL DEFAULT 'root', -- chgrp(1) owner
 343     preinstall_cmd text, -- Shell command to execute prior to installing
 344     postinstall_cmd text, -- Shell command to execute after installing
 345     error_cmd text, -- Shell command to execute if any error occurs
 346     ignore_cmd_errors bool NOT NULL DEFAULT false, -- Install file anyway even if an error occurs
 347     always_update bool NOT NULL DEFAULT false -- Always attempt to install file even if unchanged
 348 );
 349
 350 CREATE TABLE conf_file_node (
 351     conf_file_id integer REFERENCES conf_files NOT NULL, -- Configuration file identifier
 352     node_id integer REFERENCES nodes NOT NULL, -- Node identifier
 353     PRIMARY KEY (conf_file_id, node_id)
 354 );
 355 CREATE INDEX conf_file_node_conf_file_id_idx ON conf_file_node (conf_file_id);
 356 CREATE INDEX conf_file_node_node_id_idx ON conf_file_node (node_id);
 357
 358 -- Nodes linked to each configuration file
 359 CREATE VIEW conf_file_nodes AS
 360 SELECT conf_file_id,
 361 array_accum(node_id) AS node_ids
 362 FROM conf_file_node
 363 GROUP BY conf_file_id;
 364
 365 -- Configuration files linked to each node
 366 CREATE VIEW node_conf_files AS
 367 SELECT node_id,
 368 array_accum(conf_file_id) AS conf_file_ids
 369 FROM conf_file_node
 370 GROUP BY node_id;
 371
 372 CREATE TABLE conf_file_nodegroup (
 373     conf_file_id integer REFERENCES conf_files NOT NULL, -- Configuration file identifier
 374     nodegroup_id integer REFERENCES nodegroups NOT NULL, -- Node group identifier
 375     PRIMARY KEY (conf_file_id, nodegroup_id)
 376 );
 377 CREATE INDEX conf_file_nodegroup_conf_file_id_idx ON conf_file_nodegroup (conf_file_id);
 378 CREATE INDEX conf_file_nodegroup_nodegroup_id_idx ON conf_file_nodegroup (nodegroup_id);
 379
 380 -- Node groups linked to each configuration file
 381 CREATE VIEW conf_file_nodegroups AS
 382 SELECT conf_file_id,
 383 array_accum(nodegroup_id) AS nodegroup_ids
 384 FROM conf_file_nodegroup
 385 GROUP BY conf_file_id;
 386
 387 -- Configuration files linked to each node group
 388 CREATE VIEW nodegroup_conf_files AS
 389 SELECT nodegroup_id,
 390 array_accum(conf_file_id) AS conf_file_ids
 391 FROM conf_file_nodegroup
 392 GROUP BY nodegroup_id;
 393
 394 --------------------------------------------------------------------------------
 395 -- Node network interfaces
 396 --------------------------------------------------------------------------------
 397
 398 -- Valid network addressing schemes
 399 CREATE TABLE network_types (
 400     type text PRIMARY KEY -- Addressing scheme
 401 ) WITH OIDS;
 402 INSERT INTO network_types (type) VALUES ('ipv4');
 403
 404 -- Valid network configuration methods
 405 CREATE TABLE network_methods (
 406     method text PRIMARY KEY -- Configuration method
 407 ) WITH OIDS;
 408 INSERT INTO network_methods (method) VALUES ('static');
 409 INSERT INTO network_methods (method) VALUES ('dhcp');
 410 INSERT INTO network_methods (method) VALUES ('proxy');
 411 INSERT INTO network_methods (method) VALUES ('tap');
 412 INSERT INTO network_methods (method) VALUES ('ipmi');
 413 INSERT INTO network_methods (method) VALUES ('unknown');
 414
 415 -- Node network interfaces
 416 CREATE TABLE nodenetworks (
 417     -- Mandatory
 418     nodenetwork_id serial PRIMARY KEY, -- Network interface identifier
 419     node_id integer REFERENCES nodes NOT NULL, -- Which node
 420     is_primary boolean NOT NULL DEFAULT false, -- Is the primary interface for this node
 421     type text REFERENCES network_types NOT NULL, -- Addressing scheme
 422     method text REFERENCES network_methods NOT NULL, -- Configuration method
 423
 424     -- Optional, depending on type and method
 425     ip text, -- IP address
 426     mac text, -- MAC address
 427     gateway text, -- Default gateway address
 428     network text, -- Network address
 429     broadcast text, -- Network broadcast address
 430     netmask text, -- Network mask
 431     dns1 text, -- Primary DNS server
 432     dns2 text, -- Secondary DNS server
 433     bwlimit integer, -- Bandwidth limit in bps
 434     hostname text -- Hostname of this interface
 435 ) WITH OIDS;
 436 CREATE INDEX nodenetworks_node_id_idx ON nodenetworks (node_id);
 437
 438 -- Ordered by primary interface first
 439 CREATE VIEW nodenetworks_ordered AS
 440 SELECT node_id, nodenetwork_id
 441 FROM nodenetworks
 442 ORDER BY is_primary DESC;
 443
 444 -- Network interfaces on each node
 445 CREATE VIEW node_nodenetworks AS
 446 SELECT node_id,
 447 array_accum(nodenetwork_id) AS nodenetwork_ids
 448 FROM nodenetworks_ordered
 449 GROUP BY node_id;
 450
 451 --------------------------------------------------------------------------------
 452 -- Power control units (PCUs)
 453 --------------------------------------------------------------------------------
 454
 455 CREATE TABLE pcus (
 456     -- Mandatory
 457     pcu_id serial PRIMARY KEY, -- PCU identifier
 458     site_id integer REFERENCES sites NOT NULL, -- Site identifier
 459     hostname text, -- Hostname, not necessarily unique (multiple logical sites could use the same PCU)
 460     ip text NOT NULL, -- IP, not necessarily unique
 461
 462     -- Optional
 463     protocol text, -- Protocol, e.g. ssh or https or telnet
 464     username text, -- Username, if applicable
 465     "password" text, -- Password, if applicable
 466     model text, -- Model, e.g. BayTech or iPal
 467     notes text -- Random notes
 468 ) WITH OIDS;
 469 CREATE INDEX pcus_site_id_idx ON pcus (site_id);
 470
 471 CREATE VIEW site_pcus AS
 472 SELECT site_id,
 473 array_accum(pcu_id) AS pcu_ids
 474 FROM pcus
 475 GROUP BY site_id;
 476
 477 CREATE TABLE pcu_node (
 478     pcu_id integer REFERENCES pcus NOT NULL, -- PCU identifier
 479     node_id integer REFERENCES nodes NOT NULL, -- Node identifier
 480     port integer NOT NULL, -- Port number
 481     PRIMARY KEY (pcu_id, node_id), -- The same node cannot be controlled by different ports
 482     UNIQUE (pcu_id, port) -- The same port cannot control multiple nodes
 483 );
 484 CREATE INDEX pcu_node_pcu_id_idx ON pcu_node (pcu_id);
 485 CREATE INDEX pcu_node_node_id_idx ON pcu_node (node_id);
 486
 487 CREATE VIEW node_pcus AS
 488 SELECT node_id,
 489 array_accum(pcu_id) AS pcu_ids,
 490 array_accum(port) AS ports
 491 FROM pcu_node
 492 GROUP BY node_id;
 493
 494 CREATE VIEW pcu_nodes AS
 495 SELECT pcu_id,
 496 array_accum(node_id) AS node_ids,
 497 array_accum(port) AS ports
 498 FROM pcu_node
 499 GROUP BY pcu_id;
 500
 501 --------------------------------------------------------------------------------
 502 -- Slices
 503 --------------------------------------------------------------------------------
 504
 505 CREATE TABLE slice_instantiations (
 506     instantiation text PRIMARY KEY
 507 ) WITH OIDS;
 508 INSERT INTO slice_instantiations (instantiation) VALUES ('not-instantiated'); -- Placeholder slice
 509 INSERT INTO slice_instantiations (instantiation) VALUES ('plc-instantiated'); -- Instantiated by Node Manager
 510 INSERT INTO slice_instantiations (instantiation) VALUES ('delegated'); -- Manually instantiated
 511
 512 -- Slices
 513 CREATE TABLE slices (
 514     slice_id serial PRIMARY KEY, -- Slice identifier
 515     site_id integer REFERENCES sites NOT NULL, -- Site identifier
 516
 517     name text NOT NULL, -- Slice name
 518     instantiation text REFERENCES slice_instantiations NOT NULL DEFAULT 'plc-instantiated', -- Slice state, e.g. plc-instantiated
 519     url text, -- Project URL
 520     description text, -- Project description
 521
 522     max_nodes integer NOT NULL DEFAULT 100, -- Maximum number of nodes that can be assigned to this slice
 523
 524     creator_person_id integer REFERENCES persons, -- Creator
 525     created timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP, -- Creation date
 526     expires timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP + '2 weeks', -- Expiration date
 527
 528     is_deleted boolean NOT NULL DEFAULT false
 529 ) WITH OIDS;
 530 CREATE INDEX slices_site_id_idx ON slices (site_id) WHERE is_deleted IS false;
 531 CREATE INDEX slices_name_idx ON slices (name) WHERE is_deleted IS false;
 532
 533 -- Slivers
 534 CREATE TABLE slice_node (
 535     slice_id integer REFERENCES slices NOT NULL, -- Slice identifier
 536     node_id integer REFERENCES nodes NOT NULL, -- Node identifier
 537     PRIMARY KEY (slice_id, node_id)
 538 ) WITH OIDS;
 539 CREATE INDEX slice_node_slice_id_idx ON slice_node (slice_id);
 540 CREATE INDEX slice_node_node_id_idx ON slice_node (node_id);
 541
 542 -- Synonym for slice_node
 543 CREATE VIEW slivers AS
 544 SELECT * FROM slice_node;
 545
 546 -- Nodes in each slice
 547 CREATE VIEW slice_nodes AS
 548 SELECT slice_id,
 549 array_accum(node_id) AS node_ids
 550 FROM slice_node
 551 GROUP BY slice_id;
 552
 553 -- Slices on each node
 554 CREATE VIEW node_slices AS
 555 SELECT node_id,
 556 array_accum(slice_id) AS slice_ids
 557 FROM slice_node
 558 GROUP BY node_id;
 559
 560 -- Slices at each site
 561 CREATE VIEW site_slices AS
 562 SELECT site_id,
 563 array_accum(slice_id) AS slice_ids
 564 FROM slices
 565 WHERE is_deleted is false
 566 GROUP BY site_id;
 567
 568 -- Slice membership
 569 CREATE TABLE slice_person (
 570     slice_id integer REFERENCES slices NOT NULL, -- Slice identifier
 571     person_id integer REFERENCES persons NOT NULL, -- Account identifier
 572     PRIMARY KEY (slice_id, person_id)
 573 ) WITH OIDS;
 574 CREATE INDEX slice_person_slice_id_idx ON slice_person (slice_id);
 575 CREATE INDEX slice_person_person_id_idx ON slice_person (person_id);
 576
 577 -- Members of the slice
 578 CREATE VIEW slice_persons AS
 579 SELECT slice_id,
 580 array_accum(person_id) AS person_ids
 581 FROM slice_person
 582 GROUP BY slice_id;
 583
 584 -- Slices of which each person is a member
 585 CREATE VIEW person_slices AS
 586 SELECT person_id,
 587 array_accum(slice_id) AS slice_ids
 588 FROM slice_person
 589 GROUP BY person_id;
 590
 591 --------------------------------------------------------------------------------
 592 -- Slice attributes
 593 --------------------------------------------------------------------------------
 594
 595 -- Slice attribute types
 596 CREATE TABLE slice_attribute_types (
 597     attribute_type_id serial PRIMARY KEY, -- Attribute type identifier
 598     name text UNIQUE NOT NULL, -- Attribute name
 599     description text, -- Attribute description
 600     min_role_id integer REFERENCES roles DEFAULT 10 -- If set, minimum (least powerful) role that can set or change this attribute
 601 ) WITH OIDS;
 602
 603 -- Slice/sliver attributes
 604 CREATE TABLE slice_attribute (
 605     slice_attribute_id serial PRIMARY KEY, -- Slice attribute identifier
 606     slice_id integer REFERENCES slices NOT NULL, -- Slice identifier
 607     node_id integer REFERENCES nodes, -- Sliver attribute if set
 608     attribute_type_id integer REFERENCES slice_attribute_types NOT NULL, -- Attribute type identifier
 609     value text
 610 ) WITH OIDS;
 611 CREATE INDEX slice_attribute_slice_id_idx ON slice_attribute (slice_id);
 612 CREATE INDEX slice_attribute_node_id_idx ON slice_attribute (node_id);
 613
 614 CREATE VIEW slice_attributes AS
 615 SELECT slice_id,
 616 array_accum(slice_attribute_id) AS slice_attribute_ids
 617 FROM slice_attribute
 618 GROUP BY slice_id;
 619
 620 --------------------------------------------------------------------------------
 621 -- Peers
 622 --------------------------------------------------------------------------------
 623
 624 -- Peers
 625 CREATE TABLE peers (
 626     peer_id serial PRIMARY KEY, -- Peer identifier
 627     peername text NOT NULL, -- Peer name
 628     peer_url text NOT NULL, -- (HTTPS) URL of the peer PLCAPI interface
 629     cacert text, -- (SSL) Public certificate of peer API server
 630     key text, -- (GPG) Public key used for authentication
 631     deleted boolean NOT NULL DEFAULT false
 632 ) WITH OIDS;
 633 CREATE INDEX peers_peername_idx ON peers (peername) WHERE deleted IS false;
 634
 635 -- Objects at each peer
 636 CREATE TABLE peer_site (
 637     site_id integer REFERENCES sites PRIMARY KEY, -- Local site identifier
 638     peer_id integer REFERENCES peers NOT NULL, -- Peer identifier
 639     peer_site_id integer NOT NULL, -- Foreign site identifier at peer
 640     UNIQUE (peer_id, peer_site_id) -- The same foreign site should not be cached twice
 641 ) WITH OIDS;
 642 CREATE INDEX peer_site_peer_id_idx ON peers (peer_id);
 643
 644 CREATE VIEW peer_sites AS
 645 SELECT peer_id,
 646 array_accum(site_id) AS site_ids,
 647 array_accum(peer_site_id) AS peer_site_ids
 648 FROM peer_site
 649 GROUP BY peer_id;
 650
 651 CREATE TABLE peer_person (
 652     person_id integer REFERENCES persons PRIMARY KEY, -- Local user identifier
 653     peer_id integer REFERENCES peers NOT NULL, -- Peer identifier
 654     peer_person_id integer NOT NULL, -- Foreign user identifier at peer
 655     UNIQUE (peer_id, peer_person_id) -- The same foreign user should not be cached twice
 656 ) WITH OIDS;
 657 CREATE INDEX peer_person_peer_id_idx ON peer_person (peer_id);
 658
 659 CREATE VIEW peer_persons AS
 660 SELECT peer_id,
 661 array_accum(person_id) AS person_ids,
 662 array_accum(peer_person_id) AS peer_person_ids
 663 FROM peer_person
 664 GROUP BY peer_id;
 665
 666 CREATE TABLE peer_key (
 667     key_id integer REFERENCES keys PRIMARY KEY, -- Local key identifier
 668     peer_id integer REFERENCES peers NOT NULL, -- Peer identifier
 669     peer_key_id integer NOT NULL, -- Foreign key identifier at peer
 670     UNIQUE (peer_id, peer_key_id) -- The same foreign key should not be cached twice
 671 ) WITH OIDS;
 672 CREATE INDEX peer_key_peer_id_idx ON peer_key (peer_id);
 673
 674 CREATE VIEW peer_keys AS
 675 SELECT peer_id,
 676 array_accum(key_id) AS key_ids,
 677 array_accum(peer_key_id) AS peer_key_ids
 678 FROM peer_key
 679 GROUP BY peer_id;
 680
 681 CREATE TABLE peer_node (
 682     node_id integer REFERENCES nodes PRIMARY KEY, -- Local node identifier
 683     peer_id integer REFERENCES peers NOT NULL, -- Peer identifier
 684     peer_node_id integer NOT NULL, -- Foreign node identifier
 685     UNIQUE (peer_id, peer_node_id) -- The same foreign node should not be cached twice
 686 ) WITH OIDS;
 687 CREATE INDEX peer_node_peer_id_idx ON peer_node (peer_id);
 688
 689 CREATE VIEW peer_nodes AS
 690 SELECT peer_id,
 691 array_accum(node_id) AS node_ids,
 692 array_accum(peer_node_id) AS peer_node_ids
 693 FROM peer_node
 694 GROUP BY peer_id;
 695
 696 CREATE TABLE peer_slice (
 697     slice_id integer REFERENCES slices PRIMARY KEY, -- Local slice identifier
 698     peer_id integer REFERENCES peers NOT NULL, -- Peer identifier
 699     peer_slice_id integer NOT NULL, -- Slice identifier at peer
 700     UNIQUE (peer_id, peer_slice_id) -- The same foreign slice should not be cached twice
 701 ) WITH OIDS;
 702 CREATE INDEX peer_slice_peer_id_idx ON peer_slice (peer_id);
 703
 704 CREATE VIEW peer_slices AS
 705 SELECT peer_id,
 706 array_accum(slice_id) AS slice_ids,
 707 array_accum(peer_slice_id) AS peer_slice_ids
 708 FROM peer_slice
 709 GROUP BY peer_id;
 710
 711 --------------------------------------------------------------------------------
 712 -- Authenticated sessions
 713 --------------------------------------------------------------------------------
 714
 715 -- Authenticated sessions
 716 CREATE TABLE sessions (
 717     session_id text PRIMARY KEY, -- Session identifier
 718     expires timestamp without time zone
 719 ) WITH OIDS;
 720
 721 -- People can have multiple sessions
 722 CREATE TABLE person_session (
 723     person_id integer REFERENCES persons NOT NULL, -- Account identifier
 724     session_id text REFERENCES sessions NOT NULL, -- Session identifier
 725     PRIMARY KEY (person_id, session_id),
 726     UNIQUE (session_id) -- Sessions are unique
 727 ) WITH OIDS;
 728 CREATE INDEX person_session_person_id_idx ON person_session (person_id);
 729
 730 -- Nodes can have only one session
 731 CREATE TABLE node_session (
 732     node_id integer REFERENCES nodes NOT NULL, -- Node identifier
 733     session_id text REFERENCES sessions NOT NULL, -- Session identifier
 734     UNIQUE (node_id), -- Nodes can have only one session
 735     UNIQUE (session_id) -- Sessions are unique
 736 ) WITH OIDS;
 737
 738 --------------------------------------------------------------------------------
 739 -- Message templates
 740 --------------------------------------------------------------------------------
 741
 742 CREATE TABLE messages (
 743     message_id text PRIMARY KEY, -- Message name
 744     subject text, -- Message summary
 745     template text, -- Message template
 746     enabled bool NOT NULL DEFAULT true -- Whether message is enabled
 747 ) WITH OIDS;
 748
 749 --------------------------------------------------------------------------------
 750 -- Events
 751 --------------------------------------------------------------------------------
 752
 753 -- Events
 754 CREATE TABLE events (
 755     event_id serial PRIMARY KEY,  -- Event identifier
 756     person_id integer REFERENCES persons, -- Person responsible for event, if any
 757     node_id integer REFERENCES nodes, -- Node responsible for event, if any
 758     fault_code integer NOT NULL DEFAULT 0, -- Did this event result in error
 759     call_name text NOT NULL, -- Call responsible for this event
 760     call text NOT NULL, -- Call responsible for this event, including parameters
 761     message text, -- High level description of this event
 762     runtime float DEFAULT 0, -- Event run time
 763     time timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP -- Event timestamp
 764 ) WITH OIDS;
 765
 766 -- Database object(s) that may have been affected by a particular event
 767 CREATE TABLE event_object (
 768     event_id integer REFERENCES events NOT NULL, -- Event identifier
 769     object_id integer NOT NULL, -- Object identifier
 770     object_type text -- What type of object is this event affecting
 771 ) WITH OIDS;
 772 CREATE INDEX event_object_event_id_idx ON event_object (event_id);
 773 CREATE INDEX event_object_object_id_idx ON event_object (object_id);
 774 CREATE INDEX event_object_object_type_idx ON event_object (object_type);
 775
 776 CREATE VIEW event_objects AS
 777 SELECT event_id,
 778 array_accum(object_id) AS object_ids,
 779 array_accum(object_type) AS object_types
 780 FROM event_object
 781 GROUP BY event_id;
 782
 783 --------------------------------------------------------------------------------
 784 -- Useful views
 785 --------------------------------------------------------------------------------
 786
 787 CREATE OR REPLACE VIEW view_events AS
 788 SELECT
 789 events.event_id,
 790 events.person_id,
 791 events.node_id,
 792 events.fault_code,
 793 events.call_name,
 794 events.call,
 795 events.message,
 796 events.runtime,
 797 CAST(date_part('epoch', events.time) AS bigint) AS time,
 798 COALESCE((SELECT object_ids FROM event_objects WHERE event_objects.event_id = events.event_id), '{}') AS object_ids,
 799 COALESCE((SELECT object_types FROM event_objects WHERE event_objects.event_id = events.event_id), '{}') AS object_types
 800 FROM events;
 801
 802 CREATE OR REPLACE VIEW view_persons AS
 803 SELECT
 804 persons.person_id,
 805 persons.email,
 806 persons.first_name,
 807 persons.last_name,
 808 persons.deleted,
 809 persons.enabled,
 810 persons.password,
 811 persons.verification_key,
 812 CAST(date_part('epoch', persons.verification_expires) AS bigint) AS verification_expires,
 813 persons.title,
 814 persons.phone,
 815 persons.url,
 816 persons.bio,
 817 CAST(date_part('epoch', persons.date_created) AS bigint) AS date_created,
 818 CAST(date_part('epoch', persons.last_updated) AS bigint) AS last_updated,
 819 peer_person.peer_id,
 820 peer_person.peer_person_id,
 821 COALESCE((SELECT role_ids FROM person_roles WHERE person_roles.person_id = persons.person_id), '{}') AS role_ids,
 822 COALESCE((SELECT roles FROM person_roles WHERE person_roles.person_id = persons.person_id), '{}') AS roles,
 823 COALESCE((SELECT site_ids FROM person_sites WHERE person_sites.person_id = persons.person_id), '{}') AS site_ids,
 824 COALESCE((SELECT key_ids FROM person_keys WHERE person_keys.person_id = persons.person_id), '{}') AS key_ids,
 825 COALESCE((SELECT slice_ids FROM person_slices WHERE person_slices.person_id = persons.person_id), '{}') AS slice_ids
 826 FROM persons
 827 LEFT JOIN peer_person USING (person_id);
 828
 829 CREATE OR REPLACE VIEW view_peers AS
 830 SELECT
 831 peers.*,
 832 COALESCE((SELECT site_ids FROM peer_sites WHERE peer_sites.peer_id = peers.peer_id), '{}') AS site_ids,
 833 COALESCE((SELECT peer_site_ids FROM peer_sites WHERE peer_sites.peer_id = peers.peer_id), '{}') AS peer_site_ids,
 834 COALESCE((SELECT person_ids FROM peer_persons WHERE peer_persons.peer_id = peers.peer_id), '{}') AS person_ids,
 835 COALESCE((SELECT peer_person_ids FROM peer_persons WHERE peer_persons.peer_id = peers.peer_id), '{}') AS peer_person_ids,
 836 COALESCE((SELECT key_ids FROM peer_keys WHERE peer_keys.peer_id = peers.peer_id), '{}') AS key_ids,
 837 COALESCE((SELECT peer_key_ids FROM peer_keys WHERE peer_keys.peer_id = peers.peer_id), '{}') AS peer_key_ids,
 838 COALESCE((SELECT node_ids FROM peer_nodes WHERE peer_nodes.peer_id = peers.peer_id), '{}') AS node_ids,
 839 COALESCE((SELECT peer_node_ids FROM peer_nodes WHERE peer_nodes.peer_id = peers.peer_id), '{}') AS peer_node_ids,
 840 COALESCE((SELECT slice_ids FROM peer_slices WHERE peer_slices.peer_id = peers.peer_id), '{}') AS slice_ids,
 841 COALESCE((SELECT peer_slice_ids FROM peer_slices WHERE peer_slices.peer_id = peers.peer_id), '{}') AS peer_slice_ids
 842 FROM peers;
 843
 844 CREATE OR REPLACE VIEW view_nodes AS
 845 SELECT
 846 nodes.node_id,
 847 nodes.hostname,
 848 nodes.site_id,
 849 nodes.boot_state,
 850 nodes.deleted,
 851 nodes.model,
 852 nodes.boot_nonce,
 853 nodes.version,
 854 nodes.ssh_rsa_key,
 855 nodes.key,
 856 CAST(date_part('epoch', nodes.date_created) AS bigint) AS date_created,
 857 CAST(date_part('epoch', nodes.last_updated) AS bigint) AS last_updated,
 858 peer_node.peer_id,
 859 peer_node.peer_node_id,
 860 COALESCE((SELECT nodenetwork_ids FROM node_nodenetworks WHERE node_nodenetworks.node_id = nodes.node_id), '{}') AS nodenetwork_ids,
 861 COALESCE((SELECT nodegroup_ids FROM node_nodegroups WHERE node_nodegroups.node_id = nodes.node_id), '{}') AS nodegroup_ids,
 862 COALESCE((SELECT slice_ids FROM node_slices WHERE node_slices.node_id = nodes.node_id), '{}') AS slice_ids,
 863 COALESCE((SELECT pcu_ids FROM node_pcus WHERE node_pcus.node_id = nodes.node_id), '{}') AS pcu_ids,
 864 COALESCE((SELECT ports FROM node_pcus WHERE node_pcus.node_id = nodes.node_id), '{}') AS ports,
 865 COALESCE((SELECT conf_file_ids FROM node_conf_files WHERE node_conf_files.node_id = nodes.node_id), '{}') AS conf_file_ids,
 866 node_session.session_id AS session
 867 FROM nodes
 868 LEFT JOIN peer_node USING (node_id)
 869 LEFT JOIN node_session USING (node_id);
 870
 871 CREATE OR REPLACE VIEW view_nodegroups AS
 872 SELECT
 873 nodegroups.*,
 874 COALESCE((SELECT node_ids FROM nodegroup_nodes WHERE nodegroup_nodes.nodegroup_id = nodegroups.nodegroup_id), '{}') AS node_ids,
 875 COALESCE((SELECT conf_file_ids FROM nodegroup_conf_files WHERE nodegroup_conf_files.nodegroup_id = nodegroups.nodegroup_id), '{}') AS conf_file_ids
 876 FROM nodegroups;
 877
 878 CREATE OR REPLACE VIEW view_conf_files AS
 879 SELECT
 880 conf_files.*,
 881 COALESCE((SELECT node_ids FROM conf_file_nodes WHERE conf_file_nodes.conf_file_id = conf_files.conf_file_id), '{}') AS node_ids,
 882 COALESCE((SELECT nodegroup_ids FROM conf_file_nodegroups WHERE conf_file_nodegroups.conf_file_id = conf_files.conf_file_id), '{}') AS nodegroup_ids
 883 FROM conf_files;
 884
 885 CREATE OR REPLACE VIEW view_pcus AS
 886 SELECT
 887 pcus.*,
 888 COALESCE((SELECT node_ids FROM pcu_nodes WHERE pcu_nodes.pcu_id = pcus.pcu_id), '{}') AS node_ids,
 889 COALESCE((SELECT ports FROM pcu_nodes WHERE pcu_nodes.pcu_id = pcus.pcu_id), '{}') AS ports
 890 FROM pcus;
 891
 892 CREATE OR REPLACE VIEW view_sites AS
 893 SELECT
 894 sites.site_id,
 895 sites.login_base,
 896 sites.name,
 897 sites.abbreviated_name,
 898 sites.deleted,
 899 sites.enabled,
 900 sites.is_public,
 901 sites.max_slices,
 902 sites.max_slivers,
 903 sites.latitude,
 904 sites.longitude,
 905 sites.url,
 906 sites.ext_consortium_id,
 907 CAST(date_part('epoch', sites.date_created) AS bigint) AS date_created,
 908 CAST(date_part('epoch', sites.last_updated) AS bigint) AS last_updated,
 909 peer_site.peer_id,
 910 peer_site.peer_site_id,
 911 COALESCE((SELECT person_ids FROM site_persons WHERE site_persons.site_id = sites.site_id), '{}') AS person_ids,
 912 COALESCE((SELECT node_ids FROM site_nodes WHERE site_nodes.site_id = sites.site_id), '{}') AS node_ids,
 913 COALESCE((SELECT address_ids FROM site_addresses WHERE site_addresses.site_id = sites.site_id), '{}') AS address_ids,
 914 COALESCE((SELECT slice_ids FROM site_slices WHERE site_slices.site_id = sites.site_id), '{}') AS slice_ids,
 915 COALESCE((SELECT pcu_ids FROM site_pcus WHERE site_pcus.site_id = sites.site_id), '{}') AS pcu_ids
 916 FROM sites
 917 LEFT JOIN peer_site USING (site_id);
 918
 919 CREATE OR REPLACE VIEW view_addresses AS
 920 SELECT
 921 addresses.*,
 922 COALESCE((SELECT address_type_ids FROM address_address_types WHERE address_address_types.address_id = addresses.address_id), '{}') AS address_type_ids,
 923 COALESCE((SELECT address_types FROM address_address_types WHERE address_address_types.address_id = addresses.address_id), '{}') AS address_types
 924 FROM addresses;
 925
 926 CREATE OR REPLACE VIEW view_keys AS
 927 SELECT
 928 keys.*,
 929 person_key.person_id,
 930 peer_key.peer_id,
 931 peer_key.peer_key_id
 932 FROM keys
 933 LEFT JOIN person_key USING (key_id)
 934 LEFT JOIN peer_key USING (key_id);
 935
 936 CREATE OR REPLACE VIEW view_slices AS
 937 SELECT
 938 slices.slice_id,
 939 slices.site_id,
 940 slices.name,
 941 slices.instantiation,
 942 slices.url,
 943 slices.description,
 944 slices.max_nodes,
 945 slices.creator_person_id,
 946 slices.is_deleted,
 947 CAST(date_part('epoch', slices.created) AS bigint) AS created,
 948 CAST(date_part('epoch', slices.expires) AS bigint) AS expires,
 949 peer_slice.peer_id,
 950 peer_slice.peer_slice_id,
 951 COALESCE((SELECT node_ids FROM slice_nodes WHERE slice_nodes.slice_id = slices.slice_id), '{}') AS node_ids,
 952 COALESCE((SELECT person_ids FROM slice_persons WHERE slice_persons.slice_id = slices.slice_id), '{}') AS person_ids,
 953 COALESCE((SELECT slice_attribute_ids FROM slice_attributes WHERE slice_attributes.slice_id = slices.slice_id), '{}') AS slice_attribute_ids
 954 FROM slices
 955 LEFT JOIN peer_slice USING (slice_id);
 956
 957 CREATE OR REPLACE VIEW view_slice_attributes AS
 958 SELECT
 959 slice_attribute.slice_attribute_id,
 960 slice_attribute.slice_id,
 961 slice_attribute.node_id,
 962 slice_attribute_types.attribute_type_id,
 963 slice_attribute_types.name,
 964 slice_attribute_types.description,
 965 slice_attribute_types.min_role_id,
 966 slice_attribute.value
 967 FROM slice_attribute
 968 INNER JOIN slice_attribute_types USING (attribute_type_id);
 969
 970 CREATE OR REPLACE VIEW view_sessions AS
 971 SELECT
 972 sessions.session_id,
 973 CAST(date_part('epoch', sessions.expires) AS bigint) AS expires,
 974 person_session.person_id,
 975 node_session.node_id
 976 FROM sessions
 977 LEFT JOIN person_session USING (session_id)
 978 LEFT JOIN node_session USING (session_id);
 979
 980 --------------------------------------------------------------------------------
 981 -- Built-in maintenance account and default site
 982 --------------------------------------------------------------------------------
 983
 984 INSERT INTO persons
 985 (first_name, last_name, email, password, enabled)
 986 VALUES
 987 ('Maintenance', 'Account', 'maint@localhost.localdomain', 'nopass', true);
 988
 989 INSERT INTO person_role (person_id, role_id) VALUES (1, 10);
 990 INSERT INTO person_role (person_id, role_id) VALUES (1, 20);
 991 INSERT INTO person_role (person_id, role_id) VALUES (1, 30);
 992 INSERT INTO person_role (person_id, role_id) VALUES (1, 40);
 993
 994 INSERT INTO sites
 995 (login_base, name, abbreviated_name, max_slices)
 996 VALUES
 997 ('pl', 'PlanetLab Central', 'PLC', 100);