2 -- PlanetLab Central database schema
3 -- Version 4, PostgreSQL
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>
10 -- Copyright (C) 2006 The Trustees of Princeton University
15 SET client_encoding = 'UNICODE';
17 --------------------------------------------------------------------------------
19 --------------------------------------------------------------------------------
22 CREATE TABLE plc_db_version (
23 version integer NOT NULL,
24 subversion integer NOT NULL DEFAULT 0
27 INSERT INTO plc_db_version (version, subversion) VALUES (5, 0);
29 --------------------------------------------------------------------------------
30 -- Aggregates and store procedures
31 --------------------------------------------------------------------------------
33 -- Like MySQL GROUP_CONCAT(), this function aggregates values into a
35 CREATE AGGREGATE array_accum (
37 basetype = anyelement,
42 --------------------------------------------------------------------------------
44 --------------------------------------------------------------------------------
47 CREATE TABLE persons (
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
56 password text NOT NULL DEFAULT 'nopass', -- Password (md5crypted)
57 verification_key text, -- Reset password key
58 verification_expires timestamp without time zone,
61 title text, -- Honorific
62 phone text, -- Telephone number
63 url text, -- Home page
64 bio text, -- Biography
67 date_created timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP,
68 last_updated timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP
70 CREATE INDEX persons_email_idx ON persons (email);
72 --------------------------------------------------------------------------------
74 --------------------------------------------------------------------------------
79 site_id serial PRIMARY KEY, -- Site identifier
80 login_base text NOT NULL, -- Site slice prefix
81 name text NOT NULL, -- Site name
82 abbreviated_name text NOT NULL, -- Site abbreviated name
83 enabled boolean NOT NULL Default true, -- Is this site enabled
84 deleted boolean NOT NULL DEFAULT false, -- Has been deleted
85 is_public boolean NOT NULL DEFAULT true, -- Shows up in public lists
86 max_slices integer NOT NULL DEFAULT 0, -- Maximum number of slices
87 max_slivers integer NOT NULL DEFAULT 1000, -- Maximum number of instantiated slivers
93 ext_consortium_id integer, -- external consortium id
96 date_created timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP,
97 last_updated timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP
99 CREATE INDEX sites_login_base_idx ON sites (login_base);
101 -- Account site membership
102 CREATE TABLE person_site (
103 person_id integer REFERENCES persons NOT NULL, -- Account identifier
104 site_id integer REFERENCES sites NOT NULL, -- Site identifier
105 is_primary boolean NOT NULL DEFAULT false, -- Is the primary site for this account
106 PRIMARY KEY (person_id, site_id)
108 CREATE INDEX person_site_person_id_idx ON person_site (person_id);
109 CREATE INDEX person_site_site_id_idx ON person_site (site_id);
111 -- Ordered by primary site first
112 CREATE OR REPLACE VIEW person_site_ordered AS
113 SELECT person_id, site_id
115 ORDER BY is_primary DESC;
117 -- Sites that each person is a member of
118 CREATE OR REPLACE VIEW person_sites AS
120 array_accum(site_id) AS site_ids
121 FROM person_site_ordered
124 -- Accounts at each site
125 CREATE OR REPLACE VIEW site_persons AS
127 array_accum(person_id) AS person_ids
131 --------------------------------------------------------------------------------
133 --------------------------------------------------------------------------------
135 CREATE TABLE address_types (
136 address_type_id serial PRIMARY KEY, -- Address type identifier
137 name text UNIQUE NOT NULL, -- Address type
138 description text -- Address type description
141 -- 'Billing' Used to be 'Site'
142 INSERT INTO address_types (name) VALUES ('Personal'), ('Shipping'), ('Billing');
145 CREATE TABLE addresses (
146 address_id serial PRIMARY KEY, -- Address identifier
147 line1 text NOT NULL, -- Address line 1
148 line2 text, -- Address line 2
149 line3 text, -- Address line 3
150 city text NOT NULL, -- City
151 state text NOT NULL, -- State or province
152 postalcode text NOT NULL, -- Postal code
153 country text NOT NULL -- Country
156 -- Each mailing address can be one of several types
157 CREATE TABLE address_address_type (
158 address_id integer REFERENCES addresses NOT NULL, -- Address identifier
159 address_type_id integer REFERENCES address_types NOT NULL, -- Address type
160 PRIMARY KEY (address_id, address_type_id)
162 CREATE INDEX address_address_type_address_id_idx ON address_address_type (address_id);
163 CREATE INDEX address_address_type_address_type_id_idx ON address_address_type (address_type_id);
165 CREATE OR REPLACE VIEW address_address_types AS
167 array_accum(address_type_id) AS address_type_ids,
168 array_accum(address_types.name) AS address_types
169 FROM address_address_type
170 LEFT JOIN address_types USING (address_type_id)
173 CREATE TABLE site_address (
174 site_id integer REFERENCES sites NOT NULL, -- Site identifier
175 address_id integer REFERENCES addresses NOT NULL, -- Address identifier
176 PRIMARY KEY (site_id, address_id)
178 CREATE INDEX site_address_site_id_idx ON site_address (site_id);
179 CREATE INDEX site_address_address_id_idx ON site_address (address_id);
181 CREATE OR REPLACE VIEW site_addresses AS
183 array_accum(address_id) AS address_ids
187 --------------------------------------------------------------------------------
188 -- Authentication Keys
189 --------------------------------------------------------------------------------
192 CREATE TABLE key_types (
193 key_type text PRIMARY KEY -- Key type
195 INSERT INTO key_types (key_type) VALUES ('ssh');
197 -- Authentication keys
199 key_id serial PRIMARY KEY, -- Key identifier
200 key_type text REFERENCES key_types NOT NULL, -- Key type
201 key text NOT NULL, -- Key material
202 is_blacklisted boolean NOT NULL DEFAULT false -- Has been blacklisted
205 -- Account authentication key(s)
206 CREATE TABLE person_key (
207 key_id integer REFERENCES keys PRIMARY KEY, -- Key identifier
208 person_id integer REFERENCES persons NOT NULL -- Account identifier
210 CREATE INDEX person_key_person_id_idx ON person_key (person_id);
212 CREATE OR REPLACE VIEW person_keys AS
214 array_accum(key_id) AS key_ids
218 --------------------------------------------------------------------------------
220 --------------------------------------------------------------------------------
222 -- Valid account roles
224 role_id integer PRIMARY KEY, -- Role identifier
225 name text UNIQUE NOT NULL -- Role symbolic name
227 INSERT INTO roles (role_id, name) VALUES (10, 'admin'), (20, 'pi'), (30, 'user'), (40, 'tech');
229 CREATE TABLE person_role (
230 person_id integer REFERENCES persons NOT NULL, -- Account identifier
231 role_id integer REFERENCES roles NOT NULL, -- Role identifier
232 PRIMARY KEY (person_id, role_id)
234 CREATE INDEX person_role_person_id_idx ON person_role (person_id);
237 CREATE OR REPLACE VIEW person_roles AS
239 array_accum(role_id) AS role_ids,
240 array_accum(roles.name) AS roles
242 LEFT JOIN roles USING (role_id)
245 --------------------------------------------------------------------------------
247 --------------------------------------------------------------------------------
249 -- Valid node boot states
250 CREATE TABLE boot_states (
251 boot_state text PRIMARY KEY
253 INSERT INTO boot_states (boot_state)
254 VALUES ('boot'), ('dbg'), ('diag'), ('disable'), ('inst'), ('rins'), ('new');
259 node_id serial PRIMARY KEY, -- Node identifier
260 hostname text NOT NULL, -- Node hostname
261 site_id integer REFERENCES sites NOT NULL, -- At which site
263 boot_state text REFERENCES boot_states NOT NULL -- Node boot state
265 deleted boolean NOT NULL DEFAULT false, -- Is deleted
268 model text, -- Hardware make and model
269 boot_nonce text, -- Random nonce updated by Boot Manager
270 version text, -- Boot CD version string updated by Boot Manager
271 ssh_rsa_key text, -- SSH host key updated by Boot Manager
272 key text, -- Node key generated when boot file is downloaded
275 date_created timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP,
276 last_updated timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP,
277 last_contact timestamp without time zone
279 CREATE INDEX nodes_hostname_idx ON nodes (hostname);
280 CREATE INDEX nodes_site_id_idx ON nodes (site_id);
282 -- Nodes at each site
283 CREATE OR REPLACE VIEW site_nodes AS
285 array_accum(node_id) AS node_ids
287 WHERE deleted IS false
290 --------------------------------------------------------------------------------
292 --------------------------------------------------------------------------------
293 CREATE TABLE node_tag_types (
295 node_tag_type_id serial PRIMARY KEY, -- ID
296 tagname text UNIQUE NOT NULL, -- Tag Name
297 description text, -- Optional Description
298 category text NOT NULL DEFAULT 'general', -- Free text for grouping tags together
299 min_role_id integer REFERENCES roles DEFAULT 10 -- set minimal role required
302 CREATE TABLE node_tag (
303 node_tag_id serial PRIMARY KEY, -- ID
304 node_id integer REFERENCES nodes NOT NULL, -- node id
305 node_tag_type_id integer REFERENCES node_tag_types, -- tag type id
306 tagvalue text -- value attached
309 CREATE OR REPLACE VIEW node_tags AS
311 array_accum(node_tag_id) AS tag_ids
315 CREATE OR REPLACE VIEW view_node_tags AS
317 node_tag.node_tag_id,
320 node_tag_types.node_tag_type_id,
321 node_tag_types.tagname,
322 node_tag_types.description,
323 node_tag_types.category,
324 node_tag_types.min_role_id,
327 INNER JOIN node_tag_types USING (node_tag_type_id)
328 INNER JOIN nodes USING (node_id);
330 --------------------------------------------------------------------------------
331 -- (network) interfaces
332 --------------------------------------------------------------------------------
334 -- Valid network addressing schemes
335 CREATE TABLE network_types (
336 type text PRIMARY KEY -- Addressing scheme
338 INSERT INTO network_types (type) VALUES ('ipv4');
340 -- Valid network configuration methods
341 CREATE TABLE network_methods (
342 method text PRIMARY KEY -- Configuration method
344 INSERT INTO network_methods (method) VALUES
345 ('static'), ('dhcp'), ('proxy'), ('tap'), ('ipmi'), ('unknown');
347 -- Node network interfaces
348 CREATE TABLE interfaces (
350 interface_id serial PRIMARY KEY, -- Network interface identifier
351 node_id integer REFERENCES nodes NOT NULL, -- Which node
352 is_primary boolean NOT NULL DEFAULT false, -- Is the primary interface for this node
353 type text REFERENCES network_types NOT NULL, -- Addressing scheme
354 method text REFERENCES network_methods NOT NULL, -- Configuration method
356 -- Optional, depending on type and method
357 ip text, -- IP address
358 mac text, -- MAC address
359 gateway text, -- Default gateway address
360 network text, -- Network address
361 broadcast text, -- Network broadcast address
362 netmask text, -- Network mask
363 dns1 text, -- Primary DNS server
364 dns2 text, -- Secondary DNS server
365 bwlimit integer, -- Bandwidth limit in bps
366 hostname text -- Hostname of this interface
368 CREATE INDEX interfaces_node_id_idx ON interfaces (node_id);
370 -- Ordered by primary interface first
371 CREATE OR REPLACE VIEW interfaces_ordered AS
372 SELECT node_id, interface_id
374 ORDER BY is_primary DESC;
376 -- Network interfaces on each node
377 CREATE OR REPLACE VIEW node_interfaces AS
379 array_accum(interface_id) AS interface_ids
380 FROM interfaces_ordered
383 --------------------------------------------------------------------------------
384 -- Interface setting types and interfaces settings
385 --------------------------------------------------------------------------------
387 CREATE TABLE interface_setting_types (
388 interface_setting_type_id serial PRIMARY KEY, -- Setting Type Identifier
389 name text UNIQUE NOT NULL, -- Setting Name
390 description text, -- Optional Description
391 category text NOT NULL DEFAULT 'general', -- Free text for grouping, e.g. Wifi, or whatever
392 min_role_id integer REFERENCES roles DEFAULT 10 -- minimal role required
395 CREATE TABLE interface_setting (
396 interface_setting_id serial PRIMARY KEY, -- Interface Setting Identifier
397 interface_id integer REFERENCES interfaces NOT NULL,-- the interface this applies to
398 interface_setting_type_id integer
399 REFERENCES interface_setting_types NOT NULL, -- the setting type
400 value text -- value attached
403 CREATE OR REPLACE VIEW interface_settings AS
405 array_accum(interface_setting_id) AS interface_setting_ids
406 FROM interface_setting
407 GROUP BY interface_id;
409 CREATE OR REPLACE VIEW view_interface_settings AS
411 interface_setting.interface_setting_id,
412 interface_setting.interface_id,
413 interface_setting_types.interface_setting_type_id,
414 interface_setting_types.name,
415 interface_setting_types.description,
416 interface_setting_types.category,
417 interface_setting_types.min_role_id,
418 interface_setting.value
419 FROM interface_setting
420 INNER JOIN interface_setting_types USING (interface_setting_type_id);
422 CREATE OR REPLACE VIEW view_interfaces AS
424 interfaces.interface_id,
426 interfaces.is_primary,
433 interfaces.broadcast,
439 COALESCE((SELECT interface_setting_ids FROM interface_settings WHERE interface_settings.interface_id = interfaces.interface_id), '{}') AS interface_setting_ids
442 --------------------------------------------------------------------------------
443 -- ilinks : links between interfaces
444 --------------------------------------------------------------------------------
445 CREATE TABLE link_types (
446 link_type_id serial PRIMARY KEY, -- id
447 name text UNIQUE NOT NULL, -- link name
448 description text, -- optional description
449 min_role_id integer REFERENCES roles DEFAULT 10 -- minimal role required
453 ilink_id serial PRIMARY KEY, -- id
454 link_type_id integer REFERENCES link_types, -- id of the ilink type
455 src_interface_id integer REFERENCES interfaces not NULL, -- id of src interface
456 dst_interface_id integer REFERENCES interfaces NOT NULL, -- id of dst interface
457 value text -- optional value on the link
460 CREATE OR REPLACE VIEW view_ilinks AS
461 SELECT * FROM link_types
462 INNER JOIN ilink USING (link_type_id);
464 -- expose node_ids ???
465 -- -- cannot mention the same table twice in a join ?
466 -- -- CREATE OR REPLACE VIEW ilink_src_node AS
468 -- ilink.link_type_id,
469 -- ilink.src_interface_id,
470 -- interfaces.node_id AS src_node_id,
471 -- ilink.dst_interface_id
473 -- INNER JOIN interfaces ON ilink.src_interface_id = interfaces.interface_id;
475 -- CREATE OR REPLACE VIEW ilink_nodes AS
478 -- interfaces.node_id as dst_node_id
479 -- FROM ilink_src_node
480 -- INNER JOIN interfaces ON ilink_src_node.dst_interface_id = interfaces.interface_id;
482 --------------------------------------------------------------------------------
484 --------------------------------------------------------------------------------
487 CREATE TABLE nodegroups (
488 nodegroup_id serial PRIMARY KEY, -- Group identifier
489 groupname text UNIQUE NOT NULL, -- Group name
490 node_tag_type_id integer REFERENCES node_tag_types, -- node is in nodegroup if it has this tag defined
491 tagvalue text NOT NULL -- with this value attached
494 -- xxx - first rough implem. similar to former semantics but might be slow
495 CREATE OR REPLACE VIEW nodegroup_node AS
496 SELECT nodegroup_id, node_id
499 USING (node_tag_type_id)
501 USING (node_tag_type_id,tagvalue);
503 CREATE OR REPLACE VIEW nodegroup_nodes AS
505 array_accum(node_id) AS node_ids
507 GROUP BY nodegroup_id;
509 -- Node groups that each node is a member of
510 CREATE OR REPLACE VIEW node_nodegroups AS
512 array_accum(nodegroup_id) AS nodegroup_ids
516 --------------------------------------------------------------------------------
517 -- Node configuration files
518 --------------------------------------------------------------------------------
520 CREATE TABLE conf_files (
521 conf_file_id serial PRIMARY KEY, -- Configuration file identifier
522 enabled bool NOT NULL DEFAULT true, -- Configuration file is active
523 source text NOT NULL, -- Relative path on the boot server
524 -- where file can be downloaded
525 dest text NOT NULL, -- Absolute path where file should be installed
526 file_permissions text NOT NULL DEFAULT '0644', -- chmod(1) permissions
527 file_owner text NOT NULL DEFAULT 'root', -- chown(1) owner
528 file_group text NOT NULL DEFAULT 'root', -- chgrp(1) owner
529 preinstall_cmd text, -- Shell command to execute prior to installing
530 postinstall_cmd text, -- Shell command to execute after installing
531 error_cmd text, -- Shell command to execute if any error occurs
532 ignore_cmd_errors bool NOT NULL DEFAULT false, -- Install file anyway even if an error occurs
533 always_update bool NOT NULL DEFAULT false -- Always attempt to install file even if unchanged
536 CREATE TABLE conf_file_node (
537 conf_file_id integer REFERENCES conf_files NOT NULL, -- Configuration file identifier
538 node_id integer REFERENCES nodes NOT NULL, -- Node identifier
539 PRIMARY KEY (conf_file_id, node_id)
541 CREATE INDEX conf_file_node_conf_file_id_idx ON conf_file_node (conf_file_id);
542 CREATE INDEX conf_file_node_node_id_idx ON conf_file_node (node_id);
544 -- Nodes linked to each configuration file
545 CREATE OR REPLACE VIEW conf_file_nodes AS
547 array_accum(node_id) AS node_ids
549 GROUP BY conf_file_id;
551 -- Configuration files linked to each node
552 CREATE OR REPLACE VIEW node_conf_files AS
554 array_accum(conf_file_id) AS conf_file_ids
558 CREATE TABLE conf_file_nodegroup (
559 conf_file_id integer REFERENCES conf_files NOT NULL, -- Configuration file identifier
560 nodegroup_id integer REFERENCES nodegroups NOT NULL, -- Node group identifier
561 PRIMARY KEY (conf_file_id, nodegroup_id)
563 CREATE INDEX conf_file_nodegroup_conf_file_id_idx ON conf_file_nodegroup (conf_file_id);
564 CREATE INDEX conf_file_nodegroup_nodegroup_id_idx ON conf_file_nodegroup (nodegroup_id);
566 -- Node groups linked to each configuration file
567 CREATE OR REPLACE VIEW conf_file_nodegroups AS
569 array_accum(nodegroup_id) AS nodegroup_ids
570 FROM conf_file_nodegroup
571 GROUP BY conf_file_id;
573 -- Configuration files linked to each node group
574 CREATE OR REPLACE VIEW nodegroup_conf_files AS
576 array_accum(conf_file_id) AS conf_file_ids
577 FROM conf_file_nodegroup
578 GROUP BY nodegroup_id;
580 --------------------------------------------------------------------------------
581 -- Power control units (PCUs)
582 --------------------------------------------------------------------------------
586 pcu_id serial PRIMARY KEY, -- PCU identifier
587 site_id integer REFERENCES sites NOT NULL, -- Site identifier
588 hostname text, -- Hostname, not necessarily unique
589 -- (multiple logical sites could use the same PCU)
590 ip text NOT NULL, -- IP, not necessarily unique
593 protocol text, -- Protocol, e.g. ssh or https or telnet
594 username text, -- Username, if applicable
595 "password" text, -- Password, if applicable
596 model text, -- Model, e.g. BayTech or iPal
597 notes text -- Random notes
599 CREATE INDEX pcus_site_id_idx ON pcus (site_id);
601 CREATE OR REPLACE VIEW site_pcus AS
603 array_accum(pcu_id) AS pcu_ids
607 CREATE TABLE pcu_node (
608 pcu_id integer REFERENCES pcus NOT NULL, -- PCU identifier
609 node_id integer REFERENCES nodes NOT NULL, -- Node identifier
610 port integer NOT NULL, -- Port number
611 PRIMARY KEY (pcu_id, node_id), -- The same node cannot be controlled by different ports
612 UNIQUE (pcu_id, port) -- The same port cannot control multiple nodes
614 CREATE INDEX pcu_node_pcu_id_idx ON pcu_node (pcu_id);
615 CREATE INDEX pcu_node_node_id_idx ON pcu_node (node_id);
617 CREATE OR REPLACE VIEW node_pcus AS
619 array_accum(pcu_id) AS pcu_ids,
620 array_accum(port) AS ports
624 CREATE OR REPLACE VIEW pcu_nodes AS
626 array_accum(node_id) AS node_ids,
627 array_accum(port) AS ports
631 --------------------------------------------------------------------------------
633 --------------------------------------------------------------------------------
635 CREATE TABLE slice_instantiations (
636 instantiation text PRIMARY KEY
638 INSERT INTO slice_instantiations (instantiation) VALUES
639 ('not-instantiated'), -- Placeholder slice
640 ('plc-instantiated'), -- Instantiated by Node Manager
641 ('delegated'), -- Manually instantiated
642 ('nm-controller'); -- NM Controller
645 CREATE TABLE slices (
646 slice_id serial PRIMARY KEY, -- Slice identifier
647 site_id integer REFERENCES sites NOT NULL, -- Site identifier
649 name text NOT NULL, -- Slice name
650 instantiation text REFERENCES slice_instantiations -- Slice state, e.g. plc-instantiated
651 NOT NULL DEFAULT 'plc-instantiated',
652 url text, -- Project URL
653 description text, -- Project description
655 max_nodes integer NOT NULL DEFAULT 100, -- Maximum number of nodes that can be assigned to this slice
657 creator_person_id integer REFERENCES persons, -- Creator
658 created timestamp without time zone NOT NULL -- Creation date
659 DEFAULT CURRENT_TIMESTAMP,
660 expires timestamp without time zone NOT NULL -- Expiration date
661 DEFAULT CURRENT_TIMESTAMP + '2 weeks',
663 is_deleted boolean NOT NULL DEFAULT false
665 CREATE INDEX slices_site_id_idx ON slices (site_id);
666 CREATE INDEX slices_name_idx ON slices (name);
669 CREATE TABLE slice_node (
670 slice_id integer REFERENCES slices NOT NULL, -- Slice identifier
671 node_id integer REFERENCES nodes NOT NULL, -- Node identifier
672 PRIMARY KEY (slice_id, node_id)
674 CREATE INDEX slice_node_slice_id_idx ON slice_node (slice_id);
675 CREATE INDEX slice_node_node_id_idx ON slice_node (node_id);
677 -- Synonym for slice_node
678 CREATE OR REPLACE VIEW slivers AS
679 SELECT * FROM slice_node;
681 -- Nodes in each slice
682 CREATE OR REPLACE VIEW slice_nodes AS
684 array_accum(node_id) AS node_ids
688 -- Slices on each node
689 CREATE OR REPLACE VIEW node_slices AS
691 array_accum(slice_id) AS slice_ids
695 -- Slices at each site
696 CREATE OR REPLACE VIEW site_slices AS
698 array_accum(slice_id) AS slice_ids
700 WHERE is_deleted is false
704 CREATE TABLE slice_person (
705 slice_id integer REFERENCES slices NOT NULL, -- Slice identifier
706 person_id integer REFERENCES persons NOT NULL, -- Account identifier
707 PRIMARY KEY (slice_id, person_id)
709 CREATE INDEX slice_person_slice_id_idx ON slice_person (slice_id);
710 CREATE INDEX slice_person_person_id_idx ON slice_person (person_id);
712 -- Members of the slice
713 CREATE OR REPLACE VIEW slice_persons AS
715 array_accum(person_id) AS person_ids
719 -- Slices of which each person is a member
720 CREATE OR REPLACE VIEW person_slices AS
722 array_accum(slice_id) AS slice_ids
726 --------------------------------------------------------------------------------
728 --------------------------------------------------------------------------------
729 -- slice whitelist on nodes
730 CREATE TABLE node_slice_whitelist (
731 node_id integer REFERENCES nodes NOT NULL, -- Node id of whitelist
732 slice_id integer REFERENCES slices NOT NULL, -- Slice id thats allowd on this node
733 PRIMARY KEY (node_id, slice_id)
735 CREATE INDEX node_slice_whitelist_node_id_idx ON node_slice_whitelist (node_id);
736 CREATE INDEX node_slice_whitelist_slice_id_idx ON node_slice_whitelist (slice_id);
738 -- Slices on each node
739 CREATE OR REPLACE VIEW node_slices_whitelist AS
741 array_accum(slice_id) AS slice_ids_whitelist
742 FROM node_slice_whitelist
745 --------------------------------------------------------------------------------
747 --------------------------------------------------------------------------------
749 -- Slice attribute types
750 CREATE TABLE slice_attribute_types (
751 attribute_type_id serial PRIMARY KEY, -- Attribute type identifier
752 name text UNIQUE NOT NULL, -- Attribute name
753 description text, -- Attribute description
754 min_role_id integer REFERENCES roles DEFAULT 10 -- If set, minimum (least powerful) role that can
755 -- set or change this attribute
758 -- Slice/sliver attributes
759 CREATE TABLE slice_attribute (
760 slice_attribute_id serial PRIMARY KEY, -- Slice attribute identifier
761 slice_id integer REFERENCES slices NOT NULL, -- Slice identifier
762 node_id integer REFERENCES nodes, -- Sliver attribute if set
763 nodegroup_id integer REFERENCES nodegroups, -- Node group attribute if set
764 attribute_type_id integer -- Attribute type identifier
765 REFERENCES slice_attribute_types NOT NULL,
768 CREATE INDEX slice_attribute_slice_id_idx ON slice_attribute (slice_id);
769 CREATE INDEX slice_attribute_node_id_idx ON slice_attribute (node_id);
770 CREATE INDEX slice_attribute_nodegroup_id_idx ON slice_attribute (nodegroup_id);
772 CREATE OR REPLACE VIEW slice_attributes AS
774 array_accum(slice_attribute_id) AS slice_attribute_ids
778 --------------------------------------------------------------------------------
780 --------------------------------------------------------------------------------
783 CREATE TABLE initscripts (
784 initscript_id serial PRIMARY KEY, -- Initscript identifier
785 name text NOT NULL, -- Initscript name
786 enabled bool NOT NULL DEFAULT true, -- Initscript is active
787 script text NOT NULL, -- Initscript body
790 CREATE INDEX initscripts_name_idx ON initscripts (name);
793 --------------------------------------------------------------------------------
795 --------------------------------------------------------------------------------
799 peer_id serial PRIMARY KEY, -- Peer identifier
800 peername text NOT NULL, -- Peer name
801 peer_url text NOT NULL, -- (HTTPS) URL of the peer PLCAPI interface
802 cacert text, -- (SSL) Public certificate of peer API server
803 key text, -- (GPG) Public key used for authentication
804 deleted boolean NOT NULL DEFAULT false
806 CREATE INDEX peers_peername_idx ON peers (peername) WHERE deleted IS false;
808 -- Objects at each peer
809 CREATE TABLE peer_site (
810 site_id integer REFERENCES sites PRIMARY KEY, -- Local site identifier
811 peer_id integer REFERENCES peers NOT NULL, -- Peer identifier
812 peer_site_id integer NOT NULL, -- Foreign site identifier at peer
813 UNIQUE (peer_id, peer_site_id) -- The same foreign site should not be cached twice
815 CREATE INDEX peer_site_peer_id_idx ON peers (peer_id);
817 CREATE OR REPLACE VIEW peer_sites AS
819 array_accum(site_id) AS site_ids,
820 array_accum(peer_site_id) AS peer_site_ids
824 CREATE TABLE peer_person (
825 person_id integer REFERENCES persons PRIMARY KEY, -- Local user identifier
826 peer_id integer REFERENCES peers NOT NULL, -- Peer identifier
827 peer_person_id integer NOT NULL, -- Foreign user identifier at peer
828 UNIQUE (peer_id, peer_person_id) -- The same foreign user should not be cached twice
830 CREATE INDEX peer_person_peer_id_idx ON peer_person (peer_id);
832 CREATE OR REPLACE VIEW peer_persons AS
834 array_accum(person_id) AS person_ids,
835 array_accum(peer_person_id) AS peer_person_ids
839 CREATE TABLE peer_key (
840 key_id integer REFERENCES keys PRIMARY KEY, -- Local key identifier
841 peer_id integer REFERENCES peers NOT NULL, -- Peer identifier
842 peer_key_id integer NOT NULL, -- Foreign key identifier at peer
843 UNIQUE (peer_id, peer_key_id) -- The same foreign key should not be cached twice
845 CREATE INDEX peer_key_peer_id_idx ON peer_key (peer_id);
847 CREATE OR REPLACE VIEW peer_keys AS
849 array_accum(key_id) AS key_ids,
850 array_accum(peer_key_id) AS peer_key_ids
854 CREATE TABLE peer_node (
855 node_id integer REFERENCES nodes PRIMARY KEY, -- Local node identifier
856 peer_id integer REFERENCES peers NOT NULL, -- Peer identifier
857 peer_node_id integer NOT NULL, -- Foreign node identifier
858 UNIQUE (peer_id, peer_node_id) -- The same foreign node should not be cached twice
860 CREATE INDEX peer_node_peer_id_idx ON peer_node (peer_id);
862 CREATE OR REPLACE VIEW peer_nodes AS
864 array_accum(node_id) AS node_ids,
865 array_accum(peer_node_id) AS peer_node_ids
869 CREATE TABLE peer_slice (
870 slice_id integer REFERENCES slices PRIMARY KEY, -- Local slice identifier
871 peer_id integer REFERENCES peers NOT NULL, -- Peer identifier
872 peer_slice_id integer NOT NULL, -- Slice identifier at peer
873 UNIQUE (peer_id, peer_slice_id) -- The same foreign slice should not be cached twice
875 CREATE INDEX peer_slice_peer_id_idx ON peer_slice (peer_id);
877 CREATE OR REPLACE VIEW peer_slices AS
879 array_accum(slice_id) AS slice_ids,
880 array_accum(peer_slice_id) AS peer_slice_ids
884 --------------------------------------------------------------------------------
885 -- Authenticated sessions
886 --------------------------------------------------------------------------------
888 -- Authenticated sessions
889 CREATE TABLE sessions (
890 session_id text PRIMARY KEY, -- Session identifier
891 expires timestamp without time zone
894 -- People can have multiple sessions
895 CREATE TABLE person_session (
896 person_id integer REFERENCES persons NOT NULL, -- Account identifier
897 session_id text REFERENCES sessions NOT NULL, -- Session identifier
898 PRIMARY KEY (person_id, session_id),
899 UNIQUE (session_id) -- Sessions are unique
901 CREATE INDEX person_session_person_id_idx ON person_session (person_id);
903 -- Nodes can have only one session
904 CREATE TABLE node_session (
905 node_id integer REFERENCES nodes NOT NULL, -- Node identifier
906 session_id text REFERENCES sessions NOT NULL, -- Session identifier
907 UNIQUE (node_id), -- Nodes can have only one session
908 UNIQUE (session_id) -- Sessions are unique
911 -------------------------------------------------------------------------------
913 ------------------------------------------------------------------------------
914 CREATE TABLE pcu_types (
915 pcu_type_id serial PRIMARY KEY,
916 model text NOT NULL , -- PCU model name
917 name text -- Full PCU model name
919 CREATE INDEX pcu_types_model_idx ON pcu_types (model);
921 CREATE TABLE pcu_protocol_type (
922 pcu_protocol_type_id serial PRIMARY KEY,
923 pcu_type_id integer REFERENCES pcu_types NOT NULL, -- PCU type identifier
924 port integer NOT NULL, -- PCU port
925 protocol text NOT NULL, -- Protocol
926 supported boolean NOT NULL DEFAULT True -- Does PLC support
928 CREATE INDEX pcu_protocol_type_pcu_type_id ON pcu_protocol_type (pcu_type_id);
931 CREATE OR REPLACE VIEW pcu_protocol_types AS
933 array_accum(pcu_protocol_type_id) as pcu_protocol_type_ids
934 FROM pcu_protocol_type
935 GROUP BY pcu_type_id;
937 --------------------------------------------------------------------------------
939 --------------------------------------------------------------------------------
941 CREATE TABLE messages (
942 message_id text PRIMARY KEY, -- Message name
943 subject text, -- Message summary
944 template text, -- Message template
945 enabled bool NOT NULL DEFAULT true -- Whether message is enabled
948 --------------------------------------------------------------------------------
950 --------------------------------------------------------------------------------
953 CREATE TABLE events (
954 event_id serial PRIMARY KEY, -- Event identifier
955 person_id integer REFERENCES persons, -- Person responsible for event, if any
956 node_id integer REFERENCES nodes, -- Node responsible for event, if any
957 auth_type text, -- Type of auth used. i.e. AuthMethod
958 fault_code integer NOT NULL DEFAULT 0, -- Did this event result in error
959 call_name text NOT NULL, -- Call responsible for this event
960 call text NOT NULL, -- Call responsible for this event, including parameters
961 message text, -- High level description of this event
962 runtime float DEFAULT 0, -- Event run time
963 time timestamp without time zone NOT NULL -- Event timestamp
964 DEFAULT CURRENT_TIMESTAMP
967 -- Database object(s) that may have been affected by a particular event
968 CREATE TABLE event_object (
969 event_id integer REFERENCES events NOT NULL, -- Event identifier
970 object_id integer NOT NULL, -- Object identifier
971 object_type text NOT NULL Default 'Unknown' -- What type of object is this event affecting
973 CREATE INDEX event_object_event_id_idx ON event_object (event_id);
974 CREATE INDEX event_object_object_id_idx ON event_object (object_id);
975 CREATE INDEX event_object_object_type_idx ON event_object (object_type);
977 CREATE OR REPLACE VIEW event_objects AS
979 array_accum(object_id) AS object_ids,
980 array_accum(object_type) AS object_types
984 --------------------------------------------------------------------------------
986 --------------------------------------------------------------------------------
987 CREATE OR REPLACE VIEW view_pcu_types AS
989 pcu_types.pcu_type_id,
992 COALESCE((SELECT pcu_protocol_type_ids FROM pcu_protocol_types
993 WHERE pcu_protocol_types.pcu_type_id = pcu_types.pcu_type_id), '{}')
994 AS pcu_protocol_type_ids
997 CREATE OR REPLACE VIEW view_events AS
1008 CAST(date_part('epoch', events.time) AS bigint) AS time,
1009 COALESCE((SELECT object_ids FROM event_objects WHERE event_objects.event_id = events.event_id), '{}') AS object_ids,
1010 COALESCE((SELECT object_types FROM event_objects WHERE event_objects.event_id = events.event_id), '{}') AS object_types
1013 CREATE OR REPLACE VIEW view_event_objects AS
1023 CAST(date_part('epoch', events.time) AS bigint) AS time,
1024 event_object.object_id,
1025 event_object.object_type
1026 FROM events LEFT JOIN event_object USING (event_id);
1028 CREATE OR REPLACE VIEW view_persons AS
1037 persons.verification_key,
1038 CAST(date_part('epoch', persons.verification_expires) AS bigint) AS verification_expires,
1043 CAST(date_part('epoch', persons.date_created) AS bigint) AS date_created,
1044 CAST(date_part('epoch', persons.last_updated) AS bigint) AS last_updated,
1045 peer_person.peer_id,
1046 peer_person.peer_person_id,
1047 COALESCE((SELECT role_ids FROM person_roles WHERE person_roles.person_id = persons.person_id), '{}') AS role_ids,
1048 COALESCE((SELECT roles FROM person_roles WHERE person_roles.person_id = persons.person_id), '{}') AS roles,
1049 COALESCE((SELECT site_ids FROM person_sites WHERE person_sites.person_id = persons.person_id), '{}') AS site_ids,
1050 COALESCE((SELECT key_ids FROM person_keys WHERE person_keys.person_id = persons.person_id), '{}') AS key_ids,
1051 COALESCE((SELECT slice_ids FROM person_slices WHERE person_slices.person_id = persons.person_id), '{}') AS slice_ids
1053 LEFT JOIN peer_person USING (person_id);
1055 CREATE OR REPLACE VIEW view_peers AS
1058 COALESCE((SELECT site_ids FROM peer_sites WHERE peer_sites.peer_id = peers.peer_id), '{}') AS site_ids,
1059 COALESCE((SELECT peer_site_ids FROM peer_sites WHERE peer_sites.peer_id = peers.peer_id), '{}') AS peer_site_ids,
1060 COALESCE((SELECT person_ids FROM peer_persons WHERE peer_persons.peer_id = peers.peer_id), '{}') AS person_ids,
1061 COALESCE((SELECT peer_person_ids FROM peer_persons WHERE peer_persons.peer_id = peers.peer_id), '{}') AS peer_person_ids,
1062 COALESCE((SELECT key_ids FROM peer_keys WHERE peer_keys.peer_id = peers.peer_id), '{}') AS key_ids,
1063 COALESCE((SELECT peer_key_ids FROM peer_keys WHERE peer_keys.peer_id = peers.peer_id), '{}') AS peer_key_ids,
1064 COALESCE((SELECT node_ids FROM peer_nodes WHERE peer_nodes.peer_id = peers.peer_id), '{}') AS node_ids,
1065 COALESCE((SELECT peer_node_ids FROM peer_nodes WHERE peer_nodes.peer_id = peers.peer_id), '{}') AS peer_node_ids,
1066 COALESCE((SELECT slice_ids FROM peer_slices WHERE peer_slices.peer_id = peers.peer_id), '{}') AS slice_ids,
1067 COALESCE((SELECT peer_slice_ids FROM peer_slices WHERE peer_slices.peer_id = peers.peer_id), '{}') AS peer_slice_ids
1070 CREATE OR REPLACE VIEW view_nodes AS
1082 CAST(date_part('epoch', nodes.date_created) AS bigint) AS date_created,
1083 CAST(date_part('epoch', nodes.last_updated) AS bigint) AS last_updated,
1084 CAST(date_part('epoch', nodes.last_contact) AS bigint) AS last_contact,
1086 peer_node.peer_node_id,
1087 COALESCE((SELECT interface_ids FROM node_interfaces
1088 WHERE node_interfaces.node_id = nodes.node_id), '{}')
1090 COALESCE((SELECT nodegroup_ids FROM node_nodegroups
1091 WHERE node_nodegroups.node_id = nodes.node_id), '{}')
1093 COALESCE((SELECT slice_ids FROM node_slices
1094 WHERE node_slices.node_id = nodes.node_id), '{}')
1096 COALESCE((SELECT slice_ids_whitelist FROM node_slices_whitelist
1097 WHERE node_slices_whitelist.node_id = nodes.node_id), '{}')
1098 AS slice_ids_whitelist,
1099 COALESCE((SELECT pcu_ids FROM node_pcus
1100 WHERE node_pcus.node_id = nodes.node_id), '{}')
1102 COALESCE((SELECT ports FROM node_pcus
1103 WHERE node_pcus.node_id = nodes.node_id), '{}')
1105 COALESCE((SELECT conf_file_ids FROM node_conf_files
1106 WHERE node_conf_files.node_id = nodes.node_id), '{}')
1108 COALESCE((SELECT tag_ids FROM node_tags
1109 WHERE node_tags.node_id = nodes.node_id), '{}')
1111 node_session.session_id AS session
1113 LEFT JOIN peer_node USING (node_id)
1114 LEFT JOIN node_session USING (node_id);
1116 CREATE OR REPLACE VIEW view_nodegroups AS
1119 node_tag_types.tagname,
1120 COALESCE((SELECT conf_file_ids FROM nodegroup_conf_files
1121 WHERE nodegroup_conf_files.nodegroup_id = nodegroups.nodegroup_id), '{}')
1123 COALESCE((SELECT node_ids FROM nodegroup_nodes
1124 WHERE nodegroup_nodes.nodegroup_id = nodegroups.nodegroup_id), '{}')
1126 FROM nodegroups INNER JOIN node_tag_types USING (node_tag_type_id);
1128 CREATE OR REPLACE VIEW view_conf_files AS
1131 COALESCE((SELECT node_ids FROM conf_file_nodes
1132 WHERE conf_file_nodes.conf_file_id = conf_files.conf_file_id), '{}')
1134 COALESCE((SELECT nodegroup_ids FROM conf_file_nodegroups
1135 WHERE conf_file_nodegroups.conf_file_id = conf_files.conf_file_id), '{}')
1139 CREATE OR REPLACE VIEW view_pcus AS
1142 COALESCE((SELECT node_ids FROM pcu_nodes WHERE pcu_nodes.pcu_id = pcus.pcu_id), '{}') AS node_ids,
1143 COALESCE((SELECT ports FROM pcu_nodes WHERE pcu_nodes.pcu_id = pcus.pcu_id), '{}') AS ports
1146 CREATE OR REPLACE VIEW view_sites AS
1151 sites.abbreviated_name,
1160 sites.ext_consortium_id,
1161 CAST(date_part('epoch', sites.date_created) AS bigint) AS date_created,
1162 CAST(date_part('epoch', sites.last_updated) AS bigint) AS last_updated,
1164 peer_site.peer_site_id,
1165 COALESCE((SELECT person_ids FROM site_persons WHERE site_persons.site_id = sites.site_id), '{}') AS person_ids,
1166 COALESCE((SELECT node_ids FROM site_nodes WHERE site_nodes.site_id = sites.site_id), '{}') AS node_ids,
1167 COALESCE((SELECT address_ids FROM site_addresses WHERE site_addresses.site_id = sites.site_id), '{}') AS address_ids,
1168 COALESCE((SELECT slice_ids FROM site_slices WHERE site_slices.site_id = sites.site_id), '{}') AS slice_ids,
1169 COALESCE((SELECT pcu_ids FROM site_pcus WHERE site_pcus.site_id = sites.site_id), '{}') AS pcu_ids
1171 LEFT JOIN peer_site USING (site_id);
1173 CREATE OR REPLACE VIEW view_addresses AS
1176 COALESCE((SELECT address_type_ids FROM address_address_types WHERE address_address_types.address_id = addresses.address_id), '{}') AS address_type_ids,
1177 COALESCE((SELECT address_types FROM address_address_types WHERE address_address_types.address_id = addresses.address_id), '{}') AS address_types
1180 CREATE OR REPLACE VIEW view_keys AS
1183 person_key.person_id,
1185 peer_key.peer_key_id
1187 LEFT JOIN person_key USING (key_id)
1188 LEFT JOIN peer_key USING (key_id);
1190 CREATE OR REPLACE VIEW view_slices AS
1195 slices.instantiation,
1199 slices.creator_person_id,
1201 CAST(date_part('epoch', slices.created) AS bigint) AS created,
1202 CAST(date_part('epoch', slices.expires) AS bigint) AS expires,
1204 peer_slice.peer_slice_id,
1205 COALESCE((SELECT node_ids FROM slice_nodes WHERE slice_nodes.slice_id = slices.slice_id), '{}') AS node_ids,
1206 COALESCE((SELECT person_ids FROM slice_persons WHERE slice_persons.slice_id = slices.slice_id), '{}') AS person_ids,
1207 COALESCE((SELECT slice_attribute_ids FROM slice_attributes WHERE slice_attributes.slice_id = slices.slice_id), '{}') AS slice_attribute_ids
1209 LEFT JOIN peer_slice USING (slice_id);
1211 CREATE OR REPLACE VIEW view_slice_attributes AS
1213 slice_attribute.slice_attribute_id,
1214 slice_attribute.slice_id,
1215 slice_attribute.node_id,
1216 slice_attribute.nodegroup_id,
1217 slice_attribute_types.attribute_type_id,
1218 slice_attribute_types.name,
1219 slice_attribute_types.description,
1220 slice_attribute_types.min_role_id,
1221 slice_attribute.value
1222 FROM slice_attribute
1223 INNER JOIN slice_attribute_types USING (attribute_type_id);
1225 CREATE OR REPLACE VIEW view_sessions AS
1227 sessions.session_id,
1228 CAST(date_part('epoch', sessions.expires) AS bigint) AS expires,
1229 person_session.person_id,
1230 node_session.node_id
1232 LEFT JOIN person_session USING (session_id)
1233 LEFT JOIN node_session USING (session_id);
1235 --------------------------------------------------------------------------------
1236 -- Built-in maintenance account and default site
1237 --------------------------------------------------------------------------------
1240 (first_name, last_name, email, password, enabled)
1242 ('Maintenance', 'Account', 'maint@localhost.localdomain', 'nopass', true);
1244 INSERT INTO person_role (person_id, role_id)
1245 VALUES (1, 10), (1, 20), (1, 30), (1, 40);
1248 (login_base, name, abbreviated_name, max_slices)
1250 ('pl', 'PlanetLab Central', 'PLC', 100);