2 -- PlanetLab Central database schema
3 -- Version 5, 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>
9 -- Thierry Parmentelat <thierry.parmentelat@sophia.inria.fr>
11 -- Copyright (C) 2006 The Trustees of Princeton University
16 SET client_encoding = 'UNICODE';
18 --------------------------------------------------------------------------------
20 --------------------------------------------------------------------------------
23 CREATE TABLE plc_db_version (
24 version integer NOT NULL,
25 subversion integer NOT NULL DEFAULT 0
28 INSERT INTO plc_db_version (version, subversion) VALUES (5, 0);
30 --------------------------------------------------------------------------------
31 -- Aggregates and store procedures
32 --------------------------------------------------------------------------------
34 -- Like MySQL GROUP_CONCAT(), this function aggregates values into a
36 CREATE AGGREGATE array_accum (
38 basetype = anyelement,
43 --------------------------------------------------------------------------------
45 --------------------------------------------------------------------------------
48 CREATE TABLE persons (
50 person_id serial PRIMARY KEY, -- Account identifier
51 email text NOT NULL, -- E-mail address
52 first_name text NOT NULL, -- First name
53 last_name text NOT NULL, -- Last name
54 deleted boolean NOT NULL DEFAULT false, -- Has been deleted
55 enabled boolean NOT NULL DEFAULT false, -- Has been disabled
57 password text NOT NULL DEFAULT 'nopass', -- Password (md5crypted)
58 verification_key text, -- Reset password key
59 verification_expires timestamp without time zone,
62 title text, -- Honorific
63 phone text, -- Telephone number
64 url text, -- Home page
65 bio text, -- Biography
68 date_created timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP,
69 last_updated timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP
71 CREATE INDEX persons_email_idx ON persons (email);
73 --------------------------------------------------------------------------------
75 --------------------------------------------------------------------------------
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
94 ext_consortium_id integer, -- external consortium id
97 date_created timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP,
98 last_updated timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP
100 CREATE INDEX sites_login_base_idx ON sites (login_base);
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)
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);
112 -- Ordered by primary site first
113 CREATE OR REPLACE VIEW person_site_ordered AS
114 SELECT person_id, site_id
116 ORDER BY is_primary DESC;
118 -- Sites that each person is a member of
119 CREATE OR REPLACE VIEW person_sites AS
121 array_accum(site_id) AS site_ids
122 FROM person_site_ordered
125 -- Accounts at each site
126 CREATE OR REPLACE VIEW site_persons AS
128 array_accum(person_id) AS person_ids
132 --------------------------------------------------------------------------------
134 --------------------------------------------------------------------------------
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
142 -- Multi-rows insertion "insert .. values (row1), (row2)" is not supported by pgsql-8.1
143 -- 'Billing' Used to be 'Site'
144 INSERT INTO address_types (name) VALUES ('Personal');
145 INSERT INTO address_types (name) VALUES ('Shipping');
146 INSERT INTO address_types (name) VALUES ('Billing');
149 CREATE TABLE addresses (
150 address_id serial PRIMARY KEY, -- Address identifier
151 line1 text NOT NULL, -- Address line 1
152 line2 text, -- Address line 2
153 line3 text, -- Address line 3
154 city text NOT NULL, -- City
155 state text NOT NULL, -- State or province
156 postalcode text NOT NULL, -- Postal code
157 country text NOT NULL -- Country
160 -- Each mailing address can be one of several types
161 CREATE TABLE address_address_type (
162 address_id integer REFERENCES addresses NOT NULL, -- Address identifier
163 address_type_id integer REFERENCES address_types NOT NULL, -- Address type
164 PRIMARY KEY (address_id, address_type_id)
166 CREATE INDEX address_address_type_address_id_idx ON address_address_type (address_id);
167 CREATE INDEX address_address_type_address_type_id_idx ON address_address_type (address_type_id);
169 CREATE OR REPLACE VIEW address_address_types AS
171 array_accum(address_type_id) AS address_type_ids,
172 array_accum(address_types.name) AS address_types
173 FROM address_address_type
174 LEFT JOIN address_types USING (address_type_id)
177 CREATE TABLE site_address (
178 site_id integer REFERENCES sites NOT NULL, -- Site identifier
179 address_id integer REFERENCES addresses NOT NULL, -- Address identifier
180 PRIMARY KEY (site_id, address_id)
182 CREATE INDEX site_address_site_id_idx ON site_address (site_id);
183 CREATE INDEX site_address_address_id_idx ON site_address (address_id);
185 CREATE OR REPLACE VIEW site_addresses AS
187 array_accum(address_id) AS address_ids
191 --------------------------------------------------------------------------------
192 -- Authentication Keys
193 --------------------------------------------------------------------------------
196 CREATE TABLE key_types (
197 key_type text PRIMARY KEY -- Key type
199 INSERT INTO key_types (key_type) VALUES ('ssh');
201 -- Authentication keys
203 key_id serial PRIMARY KEY, -- Key identifier
204 key_type text REFERENCES key_types NOT NULL, -- Key type
205 key text NOT NULL, -- Key material
206 is_blacklisted boolean NOT NULL DEFAULT false -- Has been blacklisted
209 -- Account authentication key(s)
210 CREATE TABLE person_key (
211 key_id integer REFERENCES keys PRIMARY KEY, -- Key identifier
212 person_id integer REFERENCES persons NOT NULL -- Account identifier
214 CREATE INDEX person_key_person_id_idx ON person_key (person_id);
216 CREATE OR REPLACE VIEW person_keys AS
218 array_accum(key_id) AS key_ids
222 --------------------------------------------------------------------------------
224 --------------------------------------------------------------------------------
226 -- Valid account roles
228 role_id integer PRIMARY KEY, -- Role identifier
229 name text UNIQUE NOT NULL -- Role symbolic name
231 INSERT INTO roles (role_id, name) VALUES (10, 'admin');
232 INSERT INTO roles (role_id, name) VALUES (20, 'pi');
233 INSERT INTO roles (role_id, name) VALUES (30, 'user');
234 INSERT INTO roles (role_id, name) VALUES (40, 'tech');
236 CREATE TABLE person_role (
237 person_id integer REFERENCES persons NOT NULL, -- Account identifier
238 role_id integer REFERENCES roles NOT NULL, -- Role identifier
239 PRIMARY KEY (person_id, role_id)
241 CREATE INDEX person_role_person_id_idx ON person_role (person_id);
244 CREATE OR REPLACE VIEW person_roles AS
246 array_accum(role_id) AS role_ids,
247 array_accum(roles.name) AS roles
249 LEFT JOIN roles USING (role_id)
252 --------------------------------------------------------------------------------
254 --------------------------------------------------------------------------------
256 -- Valid node boot states (Nodes.py expect max length to be 20)
257 CREATE TABLE boot_states (
258 boot_state text PRIMARY KEY
260 INSERT INTO boot_states (boot_state) VALUES ('boot');
261 INSERT INTO boot_states (boot_state) VALUES ('safeboot');
262 INSERT INTO boot_states (boot_state) VALUES ('failboot');
263 INSERT INTO boot_states (boot_state) VALUES ('disabled');
264 INSERT INTO boot_states (boot_state) VALUES ('install');
265 INSERT INTO boot_states (boot_state) VALUES ('reinstall');
270 node_id serial PRIMARY KEY, -- Node identifier
271 hostname text NOT NULL, -- Node hostname
272 site_id integer REFERENCES sites NOT NULL, -- At which site
274 boot_state text REFERENCES boot_states NOT NULL -- Node boot state
276 deleted boolean NOT NULL DEFAULT false, -- Is deleted
279 model text, -- Hardware make and model
280 boot_nonce text, -- Random nonce updated by Boot Manager
281 version text, -- Boot CD version string updated by Boot Manager
282 ssh_rsa_key text, -- SSH host key updated by Boot Manager
283 key text, -- Node key generated when boot file is downloaded
286 date_created timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP,
287 last_updated timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP,
288 last_contact timestamp without time zone
290 CREATE INDEX nodes_hostname_idx ON nodes (hostname);
291 CREATE INDEX nodes_site_id_idx ON nodes (site_id);
293 -- Nodes at each site
294 CREATE OR REPLACE VIEW site_nodes AS
296 array_accum(node_id) AS node_ids
298 WHERE deleted IS false
301 --------------------------------------------------------------------------------
303 --------------------------------------------------------------------------------
304 CREATE TABLE tag_types (
306 tag_type_id serial PRIMARY KEY, -- ID
307 tagname text UNIQUE NOT NULL, -- Tag Name
308 description text, -- Optional Description
309 min_role_id integer REFERENCES roles DEFAULT 10, -- set minimal role required
310 category text NOT NULL DEFAULT 'general' -- Free text for grouping tags together
313 CREATE TABLE node_tag (
314 node_tag_id serial PRIMARY KEY, -- ID
315 node_id integer REFERENCES nodes NOT NULL, -- node id
316 tag_type_id integer REFERENCES tag_types, -- tag type id
317 tagvalue text -- value attached
320 --------------------------------------------------------------------------------
321 -- (network) interfaces
322 --------------------------------------------------------------------------------
324 -- Valid network addressing schemes
325 CREATE TABLE network_types (
326 type text PRIMARY KEY -- Addressing scheme
328 INSERT INTO network_types (type) VALUES ('ipv4');
330 -- Valid network configuration methods
331 CREATE TABLE network_methods (
332 method text PRIMARY KEY -- Configuration method
335 INSERT INTO network_methods (method) VALUES ('static');
336 INSERT INTO network_methods (method) VALUES ('dhcp');
337 INSERT INTO network_methods (method) VALUES ('proxy');
338 INSERT INTO network_methods (method) VALUES ('tap');
339 INSERT INTO network_methods (method) VALUES ('ipmi');
340 INSERT INTO network_methods (method) VALUES ('unknown');
342 -- Node network interfaces
343 CREATE TABLE interfaces (
345 interface_id serial PRIMARY KEY, -- Network interface identifier
346 node_id integer REFERENCES nodes NOT NULL, -- Which node
347 is_primary boolean NOT NULL DEFAULT false, -- Is the primary interface for this node
348 type text REFERENCES network_types NOT NULL, -- Addressing scheme
349 method text REFERENCES network_methods NOT NULL, -- Configuration method
351 -- Optional, depending on type and method
352 ip text, -- IP address
353 mac text, -- MAC address
354 gateway text, -- Default gateway address
355 network text, -- Network address
356 broadcast text, -- Network broadcast address
357 netmask text, -- Network mask
358 dns1 text, -- Primary DNS server
359 dns2 text, -- Secondary DNS server
360 bwlimit integer, -- Bandwidth limit in bps
361 hostname text -- Hostname of this interface
363 CREATE INDEX interfaces_node_id_idx ON interfaces (node_id);
365 -- Ordered by primary interface first
366 CREATE OR REPLACE VIEW interfaces_ordered AS
367 SELECT node_id, interface_id
369 ORDER BY is_primary DESC;
371 -- Network interfaces on each node
372 CREATE OR REPLACE VIEW node_interfaces AS
374 array_accum(interface_id) AS interface_ids
375 FROM interfaces_ordered
378 --------------------------------------------------------------------------------
379 -- Interface tags (formerly known as interface settings)
380 --------------------------------------------------------------------------------
382 CREATE TABLE interface_tag (
383 interface_tag_id serial PRIMARY KEY, -- Interface Setting Identifier
384 interface_id integer REFERENCES interfaces NOT NULL,-- the interface this applies to
385 tag_type_id integer REFERENCES tag_types NOT NULL, -- the setting type
386 value text -- value attached
389 CREATE OR REPLACE VIEW interface_tags AS
391 array_accum(interface_tag_id) AS interface_tag_ids
393 GROUP BY interface_id;
395 CREATE OR REPLACE VIEW view_interface_tags AS
397 interface_tag.interface_tag_id,
398 interface_tag.interface_id,
399 tag_types.tag_type_id,
401 tag_types.description,
403 tag_types.min_role_id,
406 INNER JOIN tag_types USING (tag_type_id);
408 CREATE OR REPLACE VIEW view_interfaces AS
410 interfaces.interface_id,
412 interfaces.is_primary,
419 interfaces.broadcast,
425 COALESCE((SELECT interface_tag_ids FROM interface_tags WHERE interface_tags.interface_id = interfaces.interface_id), '{}') AS interface_tag_ids
428 --------------------------------------------------------------------------------
429 -- ilinks : links between interfaces
430 --------------------------------------------------------------------------------
432 ilink_id serial PRIMARY KEY, -- id
433 tag_type_id integer REFERENCES tag_types, -- id of the tag type
434 src_interface_id integer REFERENCES interfaces not NULL, -- id of src interface
435 dst_interface_id integer REFERENCES interfaces NOT NULL, -- id of dst interface
436 value text -- optional value on the link
439 CREATE OR REPLACE VIEW view_ilinks AS
440 SELECT * FROM tag_types
441 INNER JOIN ilink USING (tag_type_id);
443 -- expose node_ids ???
444 -- -- cannot mention the same table twice in a join ?
445 -- -- CREATE OR REPLACE VIEW ilink_src_node AS
447 -- ilink.tag_type_id,
448 -- ilink.src_interface_id,
449 -- interfaces.node_id AS src_node_id,
450 -- ilink.dst_interface_id
452 -- INNER JOIN interfaces ON ilink.src_interface_id = interfaces.interface_id;
454 -- CREATE OR REPLACE VIEW ilink_nodes AS
457 -- interfaces.node_id as dst_node_id
458 -- FROM ilink_src_node
459 -- INNER JOIN interfaces ON ilink_src_node.dst_interface_id = interfaces.interface_id;
461 --------------------------------------------------------------------------------
463 --------------------------------------------------------------------------------
466 CREATE TABLE nodegroups (
467 nodegroup_id serial PRIMARY KEY, -- Group identifier
468 groupname text UNIQUE NOT NULL, -- Group name
469 tag_type_id integer REFERENCES tag_types, -- node is in nodegroup if it has this tag defined
470 -- can be null, make management faster & easier
471 tagvalue text -- with this value attached
474 -- xxx - first rough implem. similar to former semantics but might be slow
475 CREATE OR REPLACE VIEW nodegroup_node AS
476 SELECT nodegroup_id, node_id
481 USING (tag_type_id,tagvalue);
483 CREATE OR REPLACE VIEW nodegroup_nodes AS
485 array_accum(node_id) AS node_ids
487 GROUP BY nodegroup_id;
489 -- Node groups that each node is a member of
490 CREATE OR REPLACE VIEW node_nodegroups AS
492 array_accum(nodegroup_id) AS nodegroup_ids
496 --------------------------------------------------------------------------------
497 -- Node configuration files
498 --------------------------------------------------------------------------------
500 CREATE TABLE conf_files (
501 conf_file_id serial PRIMARY KEY, -- Configuration file identifier
502 enabled bool NOT NULL DEFAULT true, -- Configuration file is active
503 source text NOT NULL, -- Relative path on the boot server
504 -- where file can be downloaded
505 dest text NOT NULL, -- Absolute path where file should be installed
506 file_permissions text NOT NULL DEFAULT '0644', -- chmod(1) permissions
507 file_owner text NOT NULL DEFAULT 'root', -- chown(1) owner
508 file_group text NOT NULL DEFAULT 'root', -- chgrp(1) owner
509 preinstall_cmd text, -- Shell command to execute prior to installing
510 postinstall_cmd text, -- Shell command to execute after installing
511 error_cmd text, -- Shell command to execute if any error occurs
512 ignore_cmd_errors bool NOT NULL DEFAULT false, -- Install file anyway even if an error occurs
513 always_update bool NOT NULL DEFAULT false -- Always attempt to install file even if unchanged
516 CREATE TABLE conf_file_node (
517 conf_file_id integer REFERENCES conf_files NOT NULL, -- Configuration file identifier
518 node_id integer REFERENCES nodes NOT NULL, -- Node identifier
519 PRIMARY KEY (conf_file_id, node_id)
521 CREATE INDEX conf_file_node_conf_file_id_idx ON conf_file_node (conf_file_id);
522 CREATE INDEX conf_file_node_node_id_idx ON conf_file_node (node_id);
524 -- Nodes linked to each configuration file
525 CREATE OR REPLACE VIEW conf_file_nodes AS
527 array_accum(node_id) AS node_ids
529 GROUP BY conf_file_id;
531 -- Configuration files linked to each node
532 CREATE OR REPLACE VIEW node_conf_files AS
534 array_accum(conf_file_id) AS conf_file_ids
538 CREATE TABLE conf_file_nodegroup (
539 conf_file_id integer REFERENCES conf_files NOT NULL, -- Configuration file identifier
540 nodegroup_id integer REFERENCES nodegroups NOT NULL, -- Node group identifier
541 PRIMARY KEY (conf_file_id, nodegroup_id)
543 CREATE INDEX conf_file_nodegroup_conf_file_id_idx ON conf_file_nodegroup (conf_file_id);
544 CREATE INDEX conf_file_nodegroup_nodegroup_id_idx ON conf_file_nodegroup (nodegroup_id);
546 -- Node groups linked to each configuration file
547 CREATE OR REPLACE VIEW conf_file_nodegroups AS
549 array_accum(nodegroup_id) AS nodegroup_ids
550 FROM conf_file_nodegroup
551 GROUP BY conf_file_id;
553 -- Configuration files linked to each node group
554 CREATE OR REPLACE VIEW nodegroup_conf_files AS
556 array_accum(conf_file_id) AS conf_file_ids
557 FROM conf_file_nodegroup
558 GROUP BY nodegroup_id;
560 --------------------------------------------------------------------------------
561 -- Power control units (PCUs)
562 --------------------------------------------------------------------------------
566 pcu_id serial PRIMARY KEY, -- PCU identifier
567 site_id integer REFERENCES sites NOT NULL, -- Site identifier
568 hostname text, -- Hostname, not necessarily unique
569 -- (multiple logical sites could use the same PCU)
570 ip text NOT NULL, -- IP, not necessarily unique
573 protocol text, -- Protocol, e.g. ssh or https or telnet
574 username text, -- Username, if applicable
575 "password" text, -- Password, if applicable
576 model text, -- Model, e.g. BayTech or iPal
577 notes text -- Random notes
579 CREATE INDEX pcus_site_id_idx ON pcus (site_id);
581 CREATE OR REPLACE VIEW site_pcus AS
583 array_accum(pcu_id) AS pcu_ids
587 CREATE TABLE pcu_node (
588 pcu_id integer REFERENCES pcus NOT NULL, -- PCU identifier
589 node_id integer REFERENCES nodes NOT NULL, -- Node identifier
590 port integer NOT NULL, -- Port number
591 PRIMARY KEY (pcu_id, node_id), -- The same node cannot be controlled by different ports
592 UNIQUE (pcu_id, port) -- The same port cannot control multiple nodes
594 CREATE INDEX pcu_node_pcu_id_idx ON pcu_node (pcu_id);
595 CREATE INDEX pcu_node_node_id_idx ON pcu_node (node_id);
597 CREATE OR REPLACE VIEW node_pcus AS
599 array_accum(pcu_id) AS pcu_ids,
600 array_accum(port) AS ports
604 CREATE OR REPLACE VIEW pcu_nodes AS
606 array_accum(node_id) AS node_ids,
607 array_accum(port) AS ports
611 --------------------------------------------------------------------------------
613 --------------------------------------------------------------------------------
615 CREATE TABLE slice_instantiations (
616 instantiation text PRIMARY KEY
618 INSERT INTO slice_instantiations (instantiation) VALUES ('not-instantiated'); -- Placeholder slice
619 INSERT INTO slice_instantiations (instantiation) VALUES ('plc-instantiated'); -- Instantiated by Node Manager
620 INSERT INTO slice_instantiations (instantiation) VALUES ('delegated'); -- Manually instantiated
621 INSERT INTO slice_instantiations (instantiation) VALUES ('nm-controller'); -- NM Controller
624 CREATE TABLE slices (
625 slice_id serial PRIMARY KEY, -- Slice identifier
626 site_id integer REFERENCES sites NOT NULL, -- Site identifier
628 name text NOT NULL, -- Slice name
629 instantiation text REFERENCES slice_instantiations -- Slice state, e.g. plc-instantiated
630 NOT NULL DEFAULT 'plc-instantiated',
631 url text, -- Project URL
632 description text, -- Project description
634 max_nodes integer NOT NULL DEFAULT 100, -- Maximum number of nodes that can be assigned to this slice
636 creator_person_id integer REFERENCES persons, -- Creator
637 created timestamp without time zone NOT NULL -- Creation date
638 DEFAULT CURRENT_TIMESTAMP,
639 expires timestamp without time zone NOT NULL -- Expiration date
640 DEFAULT CURRENT_TIMESTAMP + '2 weeks',
642 is_deleted boolean NOT NULL DEFAULT false
644 CREATE INDEX slices_site_id_idx ON slices (site_id);
645 CREATE INDEX slices_name_idx ON slices (name);
648 CREATE TABLE slice_node (
649 slice_id integer REFERENCES slices NOT NULL, -- Slice identifier
650 node_id integer REFERENCES nodes NOT NULL, -- Node identifier
651 PRIMARY KEY (slice_id, node_id)
653 CREATE INDEX slice_node_slice_id_idx ON slice_node (slice_id);
654 CREATE INDEX slice_node_node_id_idx ON slice_node (node_id);
656 -- Synonym for slice_node
657 CREATE OR REPLACE VIEW slivers AS
658 SELECT * FROM slice_node;
660 -- Nodes in each slice
661 CREATE OR REPLACE VIEW slice_nodes AS
663 array_accum(node_id) AS node_ids
667 -- Slices on each node
668 CREATE OR REPLACE VIEW node_slices AS
670 array_accum(slice_id) AS slice_ids
674 -- Slices at each site
675 CREATE OR REPLACE VIEW site_slices AS
677 array_accum(slice_id) AS slice_ids
679 WHERE is_deleted is false
683 CREATE TABLE slice_person (
684 slice_id integer REFERENCES slices NOT NULL, -- Slice identifier
685 person_id integer REFERENCES persons NOT NULL, -- Account identifier
686 PRIMARY KEY (slice_id, person_id)
688 CREATE INDEX slice_person_slice_id_idx ON slice_person (slice_id);
689 CREATE INDEX slice_person_person_id_idx ON slice_person (person_id);
691 -- Members of the slice
692 CREATE OR REPLACE VIEW slice_persons AS
694 array_accum(person_id) AS person_ids
698 -- Slices of which each person is a member
699 CREATE OR REPLACE VIEW person_slices AS
701 array_accum(slice_id) AS slice_ids
705 --------------------------------------------------------------------------------
707 --------------------------------------------------------------------------------
708 -- slice whitelist on nodes
709 CREATE TABLE node_slice_whitelist (
710 node_id integer REFERENCES nodes NOT NULL, -- Node id of whitelist
711 slice_id integer REFERENCES slices NOT NULL, -- Slice id thats allowd on this node
712 PRIMARY KEY (node_id, slice_id)
714 CREATE INDEX node_slice_whitelist_node_id_idx ON node_slice_whitelist (node_id);
715 CREATE INDEX node_slice_whitelist_slice_id_idx ON node_slice_whitelist (slice_id);
717 -- Slices on each node
718 CREATE OR REPLACE VIEW node_slices_whitelist AS
720 array_accum(slice_id) AS slice_ids_whitelist
721 FROM node_slice_whitelist
724 --------------------------------------------------------------------------------
725 -- Slice tags (formerly known as slice attributes)
726 --------------------------------------------------------------------------------
728 -- Slice/sliver attributes
729 CREATE TABLE slice_tag (
730 slice_tag_id serial PRIMARY KEY, -- Slice attribute identifier
731 slice_id integer REFERENCES slices NOT NULL, -- Slice identifier
732 node_id integer REFERENCES nodes, -- Sliver attribute if set
733 nodegroup_id integer REFERENCES nodegroups, -- Node group attribute if set
734 tag_type_id integer REFERENCES tag_types NOT NULL, -- Attribute type identifier
737 CREATE INDEX slice_tag_slice_id_idx ON slice_tag (slice_id);
738 CREATE INDEX slice_tag_node_id_idx ON slice_tag (node_id);
739 CREATE INDEX slice_tag_nodegroup_id_idx ON slice_tag (nodegroup_id);
741 --------------------------------------------------------------------------------
743 --------------------------------------------------------------------------------
746 CREATE TABLE initscripts (
747 initscript_id serial PRIMARY KEY, -- Initscript identifier
748 name text NOT NULL, -- Initscript name
749 enabled bool NOT NULL DEFAULT true, -- Initscript is active
750 script text NOT NULL, -- Initscript body
753 CREATE INDEX initscripts_name_idx ON initscripts (name);
756 --------------------------------------------------------------------------------
758 --------------------------------------------------------------------------------
762 peer_id serial PRIMARY KEY, -- Peer identifier
763 peername text NOT NULL, -- Peer name
764 peer_url text NOT NULL, -- (HTTPS) URL of the peer PLCAPI interface
765 cacert text, -- (SSL) Public certificate of peer API server
766 key text, -- (GPG) Public key used for authentication
767 deleted boolean NOT NULL DEFAULT false
769 CREATE INDEX peers_peername_idx ON peers (peername) WHERE deleted IS false;
771 -- Objects at each peer
772 CREATE TABLE peer_site (
773 site_id integer REFERENCES sites PRIMARY KEY, -- Local site identifier
774 peer_id integer REFERENCES peers NOT NULL, -- Peer identifier
775 peer_site_id integer NOT NULL, -- Foreign site identifier at peer
776 UNIQUE (peer_id, peer_site_id) -- The same foreign site should not be cached twice
778 CREATE INDEX peer_site_peer_id_idx ON peers (peer_id);
780 CREATE OR REPLACE VIEW peer_sites AS
782 array_accum(site_id) AS site_ids,
783 array_accum(peer_site_id) AS peer_site_ids
787 CREATE TABLE peer_person (
788 person_id integer REFERENCES persons PRIMARY KEY, -- Local user identifier
789 peer_id integer REFERENCES peers NOT NULL, -- Peer identifier
790 peer_person_id integer NOT NULL, -- Foreign user identifier at peer
791 UNIQUE (peer_id, peer_person_id) -- The same foreign user should not be cached twice
793 CREATE INDEX peer_person_peer_id_idx ON peer_person (peer_id);
795 CREATE OR REPLACE VIEW peer_persons AS
797 array_accum(person_id) AS person_ids,
798 array_accum(peer_person_id) AS peer_person_ids
802 CREATE TABLE peer_key (
803 key_id integer REFERENCES keys PRIMARY KEY, -- Local key identifier
804 peer_id integer REFERENCES peers NOT NULL, -- Peer identifier
805 peer_key_id integer NOT NULL, -- Foreign key identifier at peer
806 UNIQUE (peer_id, peer_key_id) -- The same foreign key should not be cached twice
808 CREATE INDEX peer_key_peer_id_idx ON peer_key (peer_id);
810 CREATE OR REPLACE VIEW peer_keys AS
812 array_accum(key_id) AS key_ids,
813 array_accum(peer_key_id) AS peer_key_ids
817 CREATE TABLE peer_node (
818 node_id integer REFERENCES nodes PRIMARY KEY, -- Local node identifier
819 peer_id integer REFERENCES peers NOT NULL, -- Peer identifier
820 peer_node_id integer NOT NULL, -- Foreign node identifier
821 UNIQUE (peer_id, peer_node_id) -- The same foreign node should not be cached twice
823 CREATE INDEX peer_node_peer_id_idx ON peer_node (peer_id);
825 CREATE OR REPLACE VIEW peer_nodes AS
827 array_accum(node_id) AS node_ids,
828 array_accum(peer_node_id) AS peer_node_ids
832 CREATE TABLE peer_slice (
833 slice_id integer REFERENCES slices PRIMARY KEY, -- Local slice identifier
834 peer_id integer REFERENCES peers NOT NULL, -- Peer identifier
835 peer_slice_id integer NOT NULL, -- Slice identifier at peer
836 UNIQUE (peer_id, peer_slice_id) -- The same foreign slice should not be cached twice
838 CREATE INDEX peer_slice_peer_id_idx ON peer_slice (peer_id);
840 CREATE OR REPLACE VIEW peer_slices AS
842 array_accum(slice_id) AS slice_ids,
843 array_accum(peer_slice_id) AS peer_slice_ids
847 --------------------------------------------------------------------------------
848 -- Authenticated sessions
849 --------------------------------------------------------------------------------
851 -- Authenticated sessions
852 CREATE TABLE sessions (
853 session_id text PRIMARY KEY, -- Session identifier
854 expires timestamp without time zone
857 -- People can have multiple sessions
858 CREATE TABLE person_session (
859 person_id integer REFERENCES persons NOT NULL, -- Account identifier
860 session_id text REFERENCES sessions NOT NULL, -- Session identifier
861 PRIMARY KEY (person_id, session_id),
862 UNIQUE (session_id) -- Sessions are unique
864 CREATE INDEX person_session_person_id_idx ON person_session (person_id);
866 -- Nodes can have only one session
867 CREATE TABLE node_session (
868 node_id integer REFERENCES nodes NOT NULL, -- Node identifier
869 session_id text REFERENCES sessions NOT NULL, -- Session identifier
870 UNIQUE (node_id), -- Nodes can have only one session
871 UNIQUE (session_id) -- Sessions are unique
874 -------------------------------------------------------------------------------
876 ------------------------------------------------------------------------------
877 CREATE TABLE pcu_types (
878 pcu_type_id serial PRIMARY KEY,
879 model text NOT NULL , -- PCU model name
880 name text -- Full PCU model name
882 CREATE INDEX pcu_types_model_idx ON pcu_types (model);
884 CREATE TABLE pcu_protocol_type (
885 pcu_protocol_type_id serial PRIMARY KEY,
886 pcu_type_id integer REFERENCES pcu_types NOT NULL, -- PCU type identifier
887 port integer NOT NULL, -- PCU port
888 protocol text NOT NULL, -- Protocol
889 supported boolean NOT NULL DEFAULT True -- Does PLC support
891 CREATE INDEX pcu_protocol_type_pcu_type_id ON pcu_protocol_type (pcu_type_id);
894 CREATE OR REPLACE VIEW pcu_protocol_types AS
896 array_accum(pcu_protocol_type_id) as pcu_protocol_type_ids
897 FROM pcu_protocol_type
898 GROUP BY pcu_type_id;
900 --------------------------------------------------------------------------------
902 --------------------------------------------------------------------------------
904 CREATE TABLE messages (
905 message_id text PRIMARY KEY, -- Message name
906 subject text, -- Message summary
907 template text, -- Message template
908 enabled bool NOT NULL DEFAULT true -- Whether message is enabled
911 --------------------------------------------------------------------------------
913 --------------------------------------------------------------------------------
916 CREATE TABLE events (
917 event_id serial PRIMARY KEY, -- Event identifier
918 person_id integer REFERENCES persons, -- Person responsible for event, if any
919 node_id integer REFERENCES nodes, -- Node responsible for event, if any
920 auth_type text, -- Type of auth used. i.e. AuthMethod
921 fault_code integer NOT NULL DEFAULT 0, -- Did this event result in error
922 call_name text NOT NULL, -- Call responsible for this event
923 call text NOT NULL, -- Call responsible for this event, including parameters
924 message text, -- High level description of this event
925 runtime float DEFAULT 0, -- Event run time
926 time timestamp without time zone NOT NULL -- Event timestamp
927 DEFAULT CURRENT_TIMESTAMP
930 -- Database object(s) that may have been affected by a particular event
931 CREATE TABLE event_object (
932 event_id integer REFERENCES events NOT NULL, -- Event identifier
933 object_id integer NOT NULL, -- Object identifier
934 object_type text NOT NULL Default 'Unknown' -- What type of object is this event affecting
936 CREATE INDEX event_object_event_id_idx ON event_object (event_id);
937 CREATE INDEX event_object_object_id_idx ON event_object (object_id);
938 CREATE INDEX event_object_object_type_idx ON event_object (object_type);
940 CREATE OR REPLACE VIEW event_objects AS
942 array_accum(object_id) AS object_ids,
943 array_accum(object_type) AS object_types
947 --------------------------------------------------------------------------------
949 --------------------------------------------------------------------------------
950 CREATE OR REPLACE VIEW view_pcu_types AS
952 pcu_types.pcu_type_id,
955 COALESCE((SELECT pcu_protocol_type_ids FROM pcu_protocol_types
956 WHERE pcu_protocol_types.pcu_type_id = pcu_types.pcu_type_id), '{}')
957 AS pcu_protocol_type_ids
960 --------------------------------------------------------------------------------
961 CREATE OR REPLACE VIEW view_events AS
972 CAST(date_part('epoch', events.time) AS bigint) AS time,
973 COALESCE((SELECT object_ids FROM event_objects WHERE event_objects.event_id = events.event_id), '{}') AS object_ids,
974 COALESCE((SELECT object_types FROM event_objects WHERE event_objects.event_id = events.event_id), '{}') AS object_types
977 CREATE OR REPLACE VIEW view_event_objects AS
987 CAST(date_part('epoch', events.time) AS bigint) AS time,
988 event_object.object_id,
989 event_object.object_type
990 FROM events LEFT JOIN event_object USING (event_id);
992 --------------------------------------------------------------------------------
993 CREATE OR REPLACE VIEW view_persons AS
1002 persons.verification_key,
1003 CAST(date_part('epoch', persons.verification_expires) AS bigint) AS verification_expires,
1008 CAST(date_part('epoch', persons.date_created) AS bigint) AS date_created,
1009 CAST(date_part('epoch', persons.last_updated) AS bigint) AS last_updated,
1010 peer_person.peer_id,
1011 peer_person.peer_person_id,
1012 COALESCE((SELECT role_ids FROM person_roles WHERE person_roles.person_id = persons.person_id), '{}') AS role_ids,
1013 COALESCE((SELECT roles FROM person_roles WHERE person_roles.person_id = persons.person_id), '{}') AS roles,
1014 COALESCE((SELECT site_ids FROM person_sites WHERE person_sites.person_id = persons.person_id), '{}') AS site_ids,
1015 COALESCE((SELECT key_ids FROM person_keys WHERE person_keys.person_id = persons.person_id), '{}') AS key_ids,
1016 COALESCE((SELECT slice_ids FROM person_slices WHERE person_slices.person_id = persons.person_id), '{}') AS slice_ids
1018 LEFT JOIN peer_person USING (person_id);
1020 --------------------------------------------------------------------------------
1021 CREATE OR REPLACE VIEW view_peers AS
1024 COALESCE((SELECT site_ids FROM peer_sites WHERE peer_sites.peer_id = peers.peer_id), '{}') AS site_ids,
1025 COALESCE((SELECT peer_site_ids FROM peer_sites WHERE peer_sites.peer_id = peers.peer_id), '{}') AS peer_site_ids,
1026 COALESCE((SELECT person_ids FROM peer_persons WHERE peer_persons.peer_id = peers.peer_id), '{}') AS person_ids,
1027 COALESCE((SELECT peer_person_ids FROM peer_persons WHERE peer_persons.peer_id = peers.peer_id), '{}') AS peer_person_ids,
1028 COALESCE((SELECT key_ids FROM peer_keys WHERE peer_keys.peer_id = peers.peer_id), '{}') AS key_ids,
1029 COALESCE((SELECT peer_key_ids FROM peer_keys WHERE peer_keys.peer_id = peers.peer_id), '{}') AS peer_key_ids,
1030 COALESCE((SELECT node_ids FROM peer_nodes WHERE peer_nodes.peer_id = peers.peer_id), '{}') AS node_ids,
1031 COALESCE((SELECT peer_node_ids FROM peer_nodes WHERE peer_nodes.peer_id = peers.peer_id), '{}') AS peer_node_ids,
1032 COALESCE((SELECT slice_ids FROM peer_slices WHERE peer_slices.peer_id = peers.peer_id), '{}') AS slice_ids,
1033 COALESCE((SELECT peer_slice_ids FROM peer_slices WHERE peer_slices.peer_id = peers.peer_id), '{}') AS peer_slice_ids
1036 --------------------------------------------------------------------------------
1037 CREATE OR REPLACE VIEW node_tags AS
1039 array_accum(node_tag_id) AS tag_ids
1043 CREATE OR REPLACE VIEW view_node_tags AS
1045 node_tag.node_tag_id,
1048 tag_types.tag_type_id,
1050 tag_types.description,
1052 tag_types.min_role_id,
1055 INNER JOIN tag_types USING (tag_type_id)
1056 INNER JOIN nodes USING (node_id);
1058 CREATE OR REPLACE VIEW view_nodes AS
1070 CAST(date_part('epoch', nodes.date_created) AS bigint) AS date_created,
1071 CAST(date_part('epoch', nodes.last_updated) AS bigint) AS last_updated,
1072 CAST(date_part('epoch', nodes.last_contact) AS bigint) AS last_contact,
1074 peer_node.peer_node_id,
1075 COALESCE((SELECT interface_ids FROM node_interfaces
1076 WHERE node_interfaces.node_id = nodes.node_id), '{}')
1078 COALESCE((SELECT nodegroup_ids FROM node_nodegroups
1079 WHERE node_nodegroups.node_id = nodes.node_id), '{}')
1081 COALESCE((SELECT slice_ids FROM node_slices
1082 WHERE node_slices.node_id = nodes.node_id), '{}')
1084 COALESCE((SELECT slice_ids_whitelist FROM node_slices_whitelist
1085 WHERE node_slices_whitelist.node_id = nodes.node_id), '{}')
1086 AS slice_ids_whitelist,
1087 COALESCE((SELECT pcu_ids FROM node_pcus
1088 WHERE node_pcus.node_id = nodes.node_id), '{}')
1090 COALESCE((SELECT ports FROM node_pcus
1091 WHERE node_pcus.node_id = nodes.node_id), '{}')
1093 COALESCE((SELECT conf_file_ids FROM node_conf_files
1094 WHERE node_conf_files.node_id = nodes.node_id), '{}')
1096 COALESCE((SELECT tag_ids FROM node_tags
1097 WHERE node_tags.node_id = nodes.node_id), '{}')
1099 node_session.session_id AS session
1101 LEFT JOIN peer_node USING (node_id)
1102 LEFT JOIN node_session USING (node_id);
1104 --------------------------------------------------------------------------------
1105 CREATE OR REPLACE VIEW view_nodegroups AS
1109 COALESCE((SELECT conf_file_ids FROM nodegroup_conf_files
1110 WHERE nodegroup_conf_files.nodegroup_id = nodegroups.nodegroup_id), '{}')
1112 COALESCE((SELECT node_ids FROM nodegroup_nodes
1113 WHERE nodegroup_nodes.nodegroup_id = nodegroups.nodegroup_id), '{}')
1115 FROM nodegroups INNER JOIN tag_types USING (tag_type_id);
1117 --------------------------------------------------------------------------------
1118 CREATE OR REPLACE VIEW view_conf_files AS
1121 COALESCE((SELECT node_ids FROM conf_file_nodes
1122 WHERE conf_file_nodes.conf_file_id = conf_files.conf_file_id), '{}')
1124 COALESCE((SELECT nodegroup_ids FROM conf_file_nodegroups
1125 WHERE conf_file_nodegroups.conf_file_id = conf_files.conf_file_id), '{}')
1129 --------------------------------------------------------------------------------
1130 CREATE OR REPLACE VIEW view_pcus AS
1133 COALESCE((SELECT node_ids FROM pcu_nodes WHERE pcu_nodes.pcu_id = pcus.pcu_id), '{}') AS node_ids,
1134 COALESCE((SELECT ports FROM pcu_nodes WHERE pcu_nodes.pcu_id = pcus.pcu_id), '{}') AS ports
1137 --------------------------------------------------------------------------------
1138 CREATE OR REPLACE VIEW view_sites AS
1143 sites.abbreviated_name,
1152 sites.ext_consortium_id,
1153 CAST(date_part('epoch', sites.date_created) AS bigint) AS date_created,
1154 CAST(date_part('epoch', sites.last_updated) AS bigint) AS last_updated,
1156 peer_site.peer_site_id,
1157 COALESCE((SELECT person_ids FROM site_persons WHERE site_persons.site_id = sites.site_id), '{}') AS person_ids,
1158 COALESCE((SELECT node_ids FROM site_nodes WHERE site_nodes.site_id = sites.site_id), '{}') AS node_ids,
1159 COALESCE((SELECT address_ids FROM site_addresses WHERE site_addresses.site_id = sites.site_id), '{}') AS address_ids,
1160 COALESCE((SELECT slice_ids FROM site_slices WHERE site_slices.site_id = sites.site_id), '{}') AS slice_ids,
1161 COALESCE((SELECT pcu_ids FROM site_pcus WHERE site_pcus.site_id = sites.site_id), '{}') AS pcu_ids
1163 LEFT JOIN peer_site USING (site_id);
1165 --------------------------------------------------------------------------------
1166 CREATE OR REPLACE VIEW view_addresses AS
1169 COALESCE((SELECT address_type_ids FROM address_address_types WHERE address_address_types.address_id = addresses.address_id), '{}') AS address_type_ids,
1170 COALESCE((SELECT address_types FROM address_address_types WHERE address_address_types.address_id = addresses.address_id), '{}') AS address_types
1173 --------------------------------------------------------------------------------
1174 CREATE OR REPLACE VIEW view_keys AS
1177 person_key.person_id,
1179 peer_key.peer_key_id
1181 LEFT JOIN person_key USING (key_id)
1182 LEFT JOIN peer_key USING (key_id);
1184 --------------------------------------------------------------------------------
1185 CREATE OR REPLACE VIEW slice_tags AS
1187 array_accum(slice_tag_id) AS slice_tag_ids
1191 CREATE OR REPLACE VIEW view_slices AS
1196 slices.instantiation,
1200 slices.creator_person_id,
1202 CAST(date_part('epoch', slices.created) AS bigint) AS created,
1203 CAST(date_part('epoch', slices.expires) AS bigint) AS expires,
1205 peer_slice.peer_slice_id,
1206 COALESCE((SELECT node_ids FROM slice_nodes WHERE slice_nodes.slice_id = slices.slice_id), '{}') AS node_ids,
1207 COALESCE((SELECT person_ids FROM slice_persons WHERE slice_persons.slice_id = slices.slice_id), '{}') AS person_ids,
1208 COALESCE((SELECT slice_tag_ids FROM slice_tags WHERE slice_tags.slice_id = slices.slice_id), '{}') AS slice_tag_ids
1210 LEFT JOIN peer_slice USING (slice_id);
1212 CREATE OR REPLACE VIEW view_slice_tags AS
1214 slice_tag.slice_tag_id,
1217 slice_tag.nodegroup_id,
1218 tag_types.tag_type_id,
1220 tag_types.description,
1222 tag_types.min_role_id,
1225 INNER JOIN tag_types USING (tag_type_id);
1227 --------------------------------------------------------------------------------
1228 CREATE OR REPLACE VIEW view_sessions AS
1230 sessions.session_id,
1231 CAST(date_part('epoch', sessions.expires) AS bigint) AS expires,
1232 person_session.person_id,
1233 node_session.node_id
1235 LEFT JOIN person_session USING (session_id)
1236 LEFT JOIN node_session USING (session_id);
1238 --------------------------------------------------------------------------------
1239 -- Built-in maintenance account and default site
1240 --------------------------------------------------------------------------------
1242 INSERT INTO persons (first_name, last_name, email, password, enabled)
1243 VALUES ('Maintenance', 'Account', 'maint@localhost.localdomain', 'nopass', true);
1245 INSERT INTO person_role (person_id, role_id) VALUES (1, 10);
1246 INSERT INTO person_role (person_id, role_id) VALUES (1, 20);
1247 INSERT INTO person_role (person_id, role_id) VALUES (1, 30);
1248 INSERT INTO person_role (person_id, role_id) VALUES (1, 40);
1250 INSERT INTO sites (login_base, name, abbreviated_name, max_slices)
1251 VALUES ('pl', 'PlanetLab Central', 'PLC', 100);