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
13 -- NOTE: this file was first created for version 4.3, the filename might be confusing
18 SET client_encoding = 'UNICODE';
20 --------------------------------------------------------------------------------
22 --------------------------------------------------------------------------------
25 CREATE TABLE plc_db_version (
26 version integer NOT NULL,
27 subversion integer NOT NULL DEFAULT 0
30 INSERT INTO plc_db_version (version, subversion) VALUES (5, 0);
32 --------------------------------------------------------------------------------
33 -- Aggregates and store procedures
34 --------------------------------------------------------------------------------
36 -- Like MySQL GROUP_CONCAT(), this function aggregates values into a
38 CREATE AGGREGATE array_accum (
40 basetype = anyelement,
45 --------------------------------------------------------------------------------
47 --------------------------------------------------------------------------------
50 CREATE TABLE persons (
52 person_id serial PRIMARY KEY, -- Account identifier
53 email text NOT NULL, -- E-mail address
54 first_name text NOT NULL, -- First name
55 last_name text NOT NULL, -- Last name
56 deleted boolean NOT NULL DEFAULT false, -- Has been deleted
57 enabled boolean NOT NULL DEFAULT false, -- Has been disabled
59 password text NOT NULL DEFAULT 'nopass', -- Password (md5crypted)
60 verification_key text, -- Reset password key
61 verification_expires timestamp without time zone,
64 title text, -- Honorific
65 phone text, -- Telephone number
66 url text, -- Home page
67 bio text, -- Biography
70 date_created timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP,
71 last_updated timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP
73 CREATE INDEX persons_email_idx ON persons (email);
75 --------------------------------------------------------------------------------
77 --------------------------------------------------------------------------------
82 site_id serial PRIMARY KEY, -- Site identifier
83 login_base text NOT NULL, -- Site slice prefix
84 name text NOT NULL, -- Site name
85 abbreviated_name text NOT NULL, -- Site abbreviated name
86 enabled boolean NOT NULL Default true, -- Is this site enabled
87 deleted boolean NOT NULL DEFAULT false, -- Has been deleted
88 is_public boolean NOT NULL DEFAULT true, -- Shows up in public lists
89 max_slices integer NOT NULL DEFAULT 0, -- Maximum number of slices
90 max_slivers integer NOT NULL DEFAULT 1000, -- Maximum number of instantiated slivers
96 ext_consortium_id integer, -- external consortium id
99 date_created timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP,
100 last_updated timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP
102 CREATE INDEX sites_login_base_idx ON sites (login_base);
104 -- Account site membership
105 CREATE TABLE person_site (
106 person_id integer REFERENCES persons NOT NULL, -- Account identifier
107 site_id integer REFERENCES sites NOT NULL, -- Site identifier
108 is_primary boolean NOT NULL DEFAULT false, -- Is the primary site for this account
109 PRIMARY KEY (person_id, site_id)
111 CREATE INDEX person_site_person_id_idx ON person_site (person_id);
112 CREATE INDEX person_site_site_id_idx ON person_site (site_id);
114 -- Ordered by primary site first
115 CREATE OR REPLACE VIEW person_site_ordered AS
116 SELECT person_id, site_id
118 ORDER BY is_primary DESC;
120 -- Sites that each person is a member of
121 CREATE OR REPLACE VIEW person_sites AS
123 array_accum(site_id) AS site_ids
124 FROM person_site_ordered
127 -- Accounts at each site
128 CREATE OR REPLACE VIEW site_persons AS
130 array_accum(person_id) AS person_ids
134 --------------------------------------------------------------------------------
136 --------------------------------------------------------------------------------
138 CREATE TABLE address_types (
139 address_type_id serial PRIMARY KEY, -- Address type identifier
140 name text UNIQUE NOT NULL, -- Address type
141 description text -- Address type description
144 -- Multi-rows insertion "insert .. values (row1), (row2)" is not supported by pgsql-8.1
145 -- 'Billing' Used to be 'Site'
146 INSERT INTO address_types (name) VALUES ('Personal');
147 INSERT INTO address_types (name) VALUES ('Shipping');
148 INSERT INTO address_types (name) VALUES ('Billing');
151 CREATE TABLE addresses (
152 address_id serial PRIMARY KEY, -- Address identifier
153 line1 text NOT NULL, -- Address line 1
154 line2 text, -- Address line 2
155 line3 text, -- Address line 3
156 city text NOT NULL, -- City
157 state text NOT NULL, -- State or province
158 postalcode text NOT NULL, -- Postal code
159 country text NOT NULL -- Country
162 -- Each mailing address can be one of several types
163 CREATE TABLE address_address_type (
164 address_id integer REFERENCES addresses NOT NULL, -- Address identifier
165 address_type_id integer REFERENCES address_types NOT NULL, -- Address type
166 PRIMARY KEY (address_id, address_type_id)
168 CREATE INDEX address_address_type_address_id_idx ON address_address_type (address_id);
169 CREATE INDEX address_address_type_address_type_id_idx ON address_address_type (address_type_id);
171 CREATE OR REPLACE VIEW address_address_types AS
173 array_accum(address_type_id) AS address_type_ids,
174 array_accum(address_types.name) AS address_types
175 FROM address_address_type
176 LEFT JOIN address_types USING (address_type_id)
179 CREATE TABLE site_address (
180 site_id integer REFERENCES sites NOT NULL, -- Site identifier
181 address_id integer REFERENCES addresses NOT NULL, -- Address identifier
182 PRIMARY KEY (site_id, address_id)
184 CREATE INDEX site_address_site_id_idx ON site_address (site_id);
185 CREATE INDEX site_address_address_id_idx ON site_address (address_id);
187 CREATE OR REPLACE VIEW site_addresses AS
189 array_accum(address_id) AS address_ids
193 --------------------------------------------------------------------------------
194 -- Authentication Keys
195 --------------------------------------------------------------------------------
198 CREATE TABLE key_types (
199 key_type text PRIMARY KEY -- Key type
201 INSERT INTO key_types (key_type) VALUES ('ssh');
203 -- Authentication keys
205 key_id serial PRIMARY KEY, -- Key identifier
206 key_type text REFERENCES key_types NOT NULL, -- Key type
207 key text NOT NULL, -- Key material
208 is_blacklisted boolean NOT NULL DEFAULT false -- Has been blacklisted
211 -- Account authentication key(s)
212 CREATE TABLE person_key (
213 key_id integer REFERENCES keys PRIMARY KEY, -- Key identifier
214 person_id integer REFERENCES persons NOT NULL -- Account identifier
216 CREATE INDEX person_key_person_id_idx ON person_key (person_id);
218 CREATE OR REPLACE VIEW person_keys AS
220 array_accum(key_id) AS key_ids
224 --------------------------------------------------------------------------------
226 --------------------------------------------------------------------------------
228 -- Valid account roles
230 role_id integer PRIMARY KEY, -- Role identifier
231 name text UNIQUE NOT NULL -- Role symbolic name
233 INSERT INTO roles (role_id, name) VALUES (10, 'admin');
234 INSERT INTO roles (role_id, name) VALUES (20, 'pi');
235 INSERT INTO roles (role_id, name) VALUES (30, 'user');
236 INSERT INTO roles (role_id, name) VALUES (40, 'tech');
238 CREATE TABLE person_role (
239 person_id integer REFERENCES persons NOT NULL, -- Account identifier
240 role_id integer REFERENCES roles NOT NULL, -- Role identifier
241 PRIMARY KEY (person_id, role_id)
243 CREATE INDEX person_role_person_id_idx ON person_role (person_id);
246 CREATE OR REPLACE VIEW person_roles AS
248 array_accum(role_id) AS role_ids,
249 array_accum(roles.name) AS roles
251 LEFT JOIN roles USING (role_id)
254 --------------------------------------------------------------------------------
256 --------------------------------------------------------------------------------
258 -- Valid node boot states (Nodes.py expect max length to be 20)
259 CREATE TABLE boot_states (
260 boot_state text PRIMARY KEY
262 INSERT INTO boot_states (boot_state) VALUES ('boot');
263 INSERT INTO boot_states (boot_state) VALUES ('safeboot');
264 INSERT INTO boot_states (boot_state) VALUES ('reinstall');
265 INSERT INTO boot_states (boot_state) VALUES ('disabled');
267 CREATE TABLE run_levels (
268 run_level text PRIMARY KEY
270 INSERT INTO run_levels (run_level) VALUES ('boot');
271 INSERT INTO run_levels (run_level) VALUES ('safeboot');
272 INSERT INTO run_levels (run_level) VALUES ('failboot');
273 INSERT INTO run_levels (run_level) VALUES ('reinstall');
275 -- Known node types (Nodes.py expect max length to be 20)
276 CREATE TABLE node_types (
277 node_type text PRIMARY KEY
279 INSERT INTO node_types (node_type) VALUES ('regular');
280 INSERT INTO node_types (node_type) VALUES ('dummynet');
285 node_id serial PRIMARY KEY, -- Node identifier
286 node_type text REFERENCES node_types -- node type
289 hostname text NOT NULL, -- Node hostname
290 site_id integer REFERENCES sites NOT NULL, -- At which site
291 boot_state text REFERENCES boot_states NOT NULL -- Node boot state
293 run_level text REFERENCES run_levels DEFAULT NULL, -- Node Run Level
294 deleted boolean NOT NULL DEFAULT false, -- Is deleted
297 model text, -- Hardware make and model
298 boot_nonce text, -- Random nonce updated by Boot Manager
299 version text, -- Boot CD version string updated by Boot Manager
300 ssh_rsa_key text, -- SSH host key updated by Boot Manager
301 key text, -- Node key generated when boot file is downloaded
302 verified boolean NOT NULL DEFAULT false, -- whether or not the node & pcu are verified
306 date_created timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP,
307 last_updated timestamp without time zone NOT NULL DEFAULT CURRENT_TIMESTAMP,
308 last_contact timestamp without time zone
310 CREATE INDEX nodes_hostname_idx ON nodes (hostname);
311 CREATE INDEX nodes_site_id_idx ON nodes (site_id);
313 -- Nodes at each site
314 CREATE OR REPLACE VIEW site_nodes AS
316 array_accum(node_id) AS node_ids
318 WHERE deleted IS false
321 --------------------------------------------------------------------------------
323 --------------------------------------------------------------------------------
324 CREATE TABLE tag_types (
326 tag_type_id serial PRIMARY KEY, -- ID
327 tagname text UNIQUE NOT NULL, -- Tag Name
328 description text, -- Optional Description
329 min_role_id integer REFERENCES roles DEFAULT 10, -- set minimal role required
330 category text NOT NULL DEFAULT 'general' -- Free text for grouping tags together
333 CREATE TABLE node_tag (
334 node_tag_id serial PRIMARY KEY, -- ID
335 node_id integer REFERENCES nodes NOT NULL, -- node id
336 tag_type_id integer REFERENCES tag_types, -- tag type id
337 value text -- value attached
340 --------------------------------------------------------------------------------
341 -- (network) interfaces
342 --------------------------------------------------------------------------------
344 -- Valid network addressing schemes
345 CREATE TABLE network_types (
346 type text PRIMARY KEY -- Addressing scheme
348 INSERT INTO network_types (type) VALUES ('ipv4');
350 -- Valid network configuration methods
351 CREATE TABLE network_methods (
352 method text PRIMARY KEY -- Configuration method
355 INSERT INTO network_methods (method) VALUES ('static');
356 INSERT INTO network_methods (method) VALUES ('dhcp');
357 INSERT INTO network_methods (method) VALUES ('proxy');
358 INSERT INTO network_methods (method) VALUES ('tap');
359 INSERT INTO network_methods (method) VALUES ('ipmi');
360 INSERT INTO network_methods (method) VALUES ('unknown');
362 -- Network interfaces
363 CREATE TABLE interfaces (
365 interface_id serial PRIMARY KEY, -- Network interface identifier
366 node_id integer REFERENCES nodes NOT NULL, -- Which node
367 is_primary boolean NOT NULL DEFAULT false, -- Is the primary interface for this node
368 type text REFERENCES network_types NOT NULL, -- Addressing scheme
369 method text REFERENCES network_methods NOT NULL, -- Configuration method
371 -- Optional, depending on type and method
372 ip text, -- IP address
373 mac text, -- MAC address
374 gateway text, -- Default gateway address
375 network text, -- Network address
376 broadcast text, -- Network broadcast address
377 netmask text, -- Network mask
378 dns1 text, -- Primary DNS server
379 dns2 text, -- Secondary DNS server
380 bwlimit integer, -- Bandwidth limit in bps
381 hostname text -- Hostname of this interface
383 CREATE INDEX interfaces_node_id_idx ON interfaces (node_id);
385 -- Ordered by primary interface first
386 CREATE OR REPLACE VIEW interfaces_ordered AS
387 SELECT node_id, interface_id
389 ORDER BY is_primary DESC;
391 -- Network interfaces on each node
392 CREATE OR REPLACE VIEW node_interfaces AS
394 array_accum(interface_id) AS interface_ids
395 FROM interfaces_ordered
398 --------------------------------------------------------------------------------
399 -- Interface tags (formerly known as interface settings)
400 --------------------------------------------------------------------------------
402 CREATE TABLE interface_tag (
403 interface_tag_id serial PRIMARY KEY, -- Interface Setting Identifier
404 interface_id integer REFERENCES interfaces NOT NULL,-- the interface this applies to
405 tag_type_id integer REFERENCES tag_types NOT NULL, -- the setting type
406 value text -- value attached
409 CREATE OR REPLACE VIEW interface_tags AS
411 array_accum(interface_tag_id) AS interface_tag_ids
413 GROUP BY interface_id;
415 CREATE OR REPLACE VIEW view_interface_tags AS
417 interface_tag.interface_tag_id,
418 interface_tag.interface_id,
420 tag_types.tag_type_id,
422 tag_types.description,
424 tag_types.min_role_id,
427 INNER JOIN tag_types USING (tag_type_id)
428 INNER JOIN interfaces USING (interface_id);
430 CREATE OR REPLACE VIEW view_interfaces AS
432 interfaces.interface_id,
434 interfaces.is_primary,
441 interfaces.broadcast,
447 COALESCE((SELECT interface_tag_ids FROM interface_tags WHERE interface_tags.interface_id = interfaces.interface_id), '{}') AS interface_tag_ids
450 --------------------------------------------------------------------------------
451 -- ilinks : links between interfaces
452 --------------------------------------------------------------------------------
454 ilink_id serial PRIMARY KEY, -- id
455 tag_type_id integer REFERENCES tag_types, -- id of the tag type
456 src_interface_id integer REFERENCES interfaces not NULL, -- id of src interface
457 dst_interface_id integer REFERENCES interfaces NOT NULL, -- id of dst interface
458 value text -- optional value on the link
461 CREATE OR REPLACE VIEW view_ilinks AS
462 SELECT * FROM tag_types
463 INNER JOIN ilink USING (tag_type_id);
465 -- xxx TODO : expose to view_interfaces the set of ilinks a given interface is part of
466 -- this is needed for properly deleting these ilinks when an interface gets deleted
467 -- as this is not done yet, it prevents DeleteInterface, thus DeleteNode, thus DeleteSite
468 -- from working correctly when an iLink is set
470 --------------------------------------------------------------------------------
472 --------------------------------------------------------------------------------
475 CREATE TABLE nodegroups (
476 nodegroup_id serial PRIMARY KEY, -- Group identifier
477 groupname text UNIQUE NOT NULL, -- Group name
478 tag_type_id integer REFERENCES tag_types, -- node is in nodegroup if it has this tag defined
479 -- can be null, make management faster & easier
480 value text -- with this value attached
483 -- xxx - first rough implem. similar to former semantics but might be slow
484 CREATE OR REPLACE VIEW nodegroup_node AS
485 SELECT nodegroup_id, node_id
490 USING (tag_type_id,value);
492 CREATE OR REPLACE VIEW nodegroup_nodes AS
494 array_accum(node_id) AS node_ids
496 GROUP BY nodegroup_id;
498 -- Node groups that each node is a member of
499 CREATE OR REPLACE VIEW node_nodegroups AS
501 array_accum(nodegroup_id) AS nodegroup_ids
505 --------------------------------------------------------------------------------
506 -- Node configuration files
507 --------------------------------------------------------------------------------
509 CREATE TABLE conf_files (
510 conf_file_id serial PRIMARY KEY, -- Configuration file identifier
511 enabled bool NOT NULL DEFAULT true, -- Configuration file is active
512 source text NOT NULL, -- Relative path on the boot server
513 -- where file can be downloaded
514 dest text NOT NULL, -- Absolute path where file should be installed
515 file_permissions text NOT NULL DEFAULT '0644', -- chmod(1) permissions
516 file_owner text NOT NULL DEFAULT 'root', -- chown(1) owner
517 file_group text NOT NULL DEFAULT 'root', -- chgrp(1) owner
518 preinstall_cmd text, -- Shell command to execute prior to installing
519 postinstall_cmd text, -- Shell command to execute after installing
520 error_cmd text, -- Shell command to execute if any error occurs
521 ignore_cmd_errors bool NOT NULL DEFAULT false, -- Install file anyway even if an error occurs
522 always_update bool NOT NULL DEFAULT false -- Always attempt to install file even if unchanged
525 CREATE TABLE conf_file_node (
526 conf_file_id integer REFERENCES conf_files NOT NULL, -- Configuration file identifier
527 node_id integer REFERENCES nodes NOT NULL, -- Node identifier
528 PRIMARY KEY (conf_file_id, node_id)
530 CREATE INDEX conf_file_node_conf_file_id_idx ON conf_file_node (conf_file_id);
531 CREATE INDEX conf_file_node_node_id_idx ON conf_file_node (node_id);
533 -- Nodes linked to each configuration file
534 CREATE OR REPLACE VIEW conf_file_nodes AS
536 array_accum(node_id) AS node_ids
538 GROUP BY conf_file_id;
540 -- Configuration files linked to each node
541 CREATE OR REPLACE VIEW node_conf_files AS
543 array_accum(conf_file_id) AS conf_file_ids
547 CREATE TABLE conf_file_nodegroup (
548 conf_file_id integer REFERENCES conf_files NOT NULL, -- Configuration file identifier
549 nodegroup_id integer REFERENCES nodegroups NOT NULL, -- Node group identifier
550 PRIMARY KEY (conf_file_id, nodegroup_id)
552 CREATE INDEX conf_file_nodegroup_conf_file_id_idx ON conf_file_nodegroup (conf_file_id);
553 CREATE INDEX conf_file_nodegroup_nodegroup_id_idx ON conf_file_nodegroup (nodegroup_id);
555 -- Node groups linked to each configuration file
556 CREATE OR REPLACE VIEW conf_file_nodegroups AS
558 array_accum(nodegroup_id) AS nodegroup_ids
559 FROM conf_file_nodegroup
560 GROUP BY conf_file_id;
562 -- Configuration files linked to each node group
563 CREATE OR REPLACE VIEW nodegroup_conf_files AS
565 array_accum(conf_file_id) AS conf_file_ids
566 FROM conf_file_nodegroup
567 GROUP BY nodegroup_id;
569 --------------------------------------------------------------------------------
570 -- Power control units (PCUs)
571 --------------------------------------------------------------------------------
575 pcu_id serial PRIMARY KEY, -- PCU identifier
576 site_id integer REFERENCES sites NOT NULL, -- Site identifier
577 hostname text, -- Hostname, not necessarily unique
578 -- (multiple logical sites could use the same PCU)
579 ip text NOT NULL, -- IP, not necessarily unique
582 protocol text, -- Protocol, e.g. ssh or https or telnet
583 username text, -- Username, if applicable
584 "password" text, -- Password, if applicable
585 model text, -- Model, e.g. BayTech or iPal
586 notes text -- Random notes
588 CREATE INDEX pcus_site_id_idx ON pcus (site_id);
590 CREATE OR REPLACE VIEW site_pcus AS
592 array_accum(pcu_id) AS pcu_ids
596 CREATE TABLE pcu_node (
597 pcu_id integer REFERENCES pcus NOT NULL, -- PCU identifier
598 node_id integer REFERENCES nodes NOT NULL, -- Node identifier
599 port integer NOT NULL, -- Port number
600 PRIMARY KEY (pcu_id, node_id), -- The same node cannot be controlled by different ports
601 UNIQUE (pcu_id, port) -- The same port cannot control multiple nodes
603 CREATE INDEX pcu_node_pcu_id_idx ON pcu_node (pcu_id);
604 CREATE INDEX pcu_node_node_id_idx ON pcu_node (node_id);
606 CREATE OR REPLACE VIEW node_pcus AS
608 array_accum(pcu_id) AS pcu_ids,
609 array_accum(port) AS ports
613 CREATE OR REPLACE VIEW pcu_nodes AS
615 array_accum(node_id) AS node_ids,
616 array_accum(port) AS ports
620 --------------------------------------------------------------------------------
622 --------------------------------------------------------------------------------
624 CREATE TABLE slice_instantiations (
625 instantiation text PRIMARY KEY
627 INSERT INTO slice_instantiations (instantiation) VALUES ('not-instantiated'); -- Placeholder slice
628 INSERT INTO slice_instantiations (instantiation) VALUES ('plc-instantiated'); -- Instantiated by Node Manager
629 INSERT INTO slice_instantiations (instantiation) VALUES ('delegated'); -- Manually instantiated
630 INSERT INTO slice_instantiations (instantiation) VALUES ('nm-controller'); -- NM Controller
633 CREATE TABLE slices (
634 slice_id serial PRIMARY KEY, -- Slice identifier
635 site_id integer REFERENCES sites NOT NULL, -- Site identifier
637 name text NOT NULL, -- Slice name
638 instantiation text REFERENCES slice_instantiations -- Slice state, e.g. plc-instantiated
639 NOT NULL DEFAULT 'plc-instantiated',
640 url text, -- Project URL
641 description text, -- Project description
643 max_nodes integer NOT NULL DEFAULT 100, -- Maximum number of nodes that can be assigned to this slice
645 creator_person_id integer REFERENCES persons, -- Creator
646 created timestamp without time zone NOT NULL -- Creation date
647 DEFAULT CURRENT_TIMESTAMP,
648 expires timestamp without time zone NOT NULL -- Expiration date
649 DEFAULT CURRENT_TIMESTAMP + '2 weeks',
651 is_deleted boolean NOT NULL DEFAULT false
653 CREATE INDEX slices_site_id_idx ON slices (site_id);
654 CREATE INDEX slices_name_idx ON slices (name);
657 CREATE TABLE slice_node (
658 slice_id integer REFERENCES slices NOT NULL, -- Slice identifier
659 node_id integer REFERENCES nodes NOT NULL, -- Node identifier
660 PRIMARY KEY (slice_id, node_id)
662 CREATE INDEX slice_node_slice_id_idx ON slice_node (slice_id);
663 CREATE INDEX slice_node_node_id_idx ON slice_node (node_id);
665 -- Synonym for slice_node
666 CREATE OR REPLACE VIEW slivers AS
667 SELECT * FROM slice_node;
669 -- Nodes in each slice
670 CREATE OR REPLACE VIEW slice_nodes AS
672 array_accum(node_id) AS node_ids
676 -- Slices on each node
677 CREATE OR REPLACE VIEW node_slices AS
679 array_accum(slice_id) AS slice_ids
683 -- Slices at each site
684 CREATE OR REPLACE VIEW site_slices AS
686 array_accum(slice_id) AS slice_ids
688 WHERE is_deleted is false
692 CREATE TABLE slice_person (
693 slice_id integer REFERENCES slices NOT NULL, -- Slice identifier
694 person_id integer REFERENCES persons NOT NULL, -- Account identifier
695 PRIMARY KEY (slice_id, person_id)
697 CREATE INDEX slice_person_slice_id_idx ON slice_person (slice_id);
698 CREATE INDEX slice_person_person_id_idx ON slice_person (person_id);
700 -- Members of the slice
701 CREATE OR REPLACE VIEW slice_persons AS
703 array_accum(person_id) AS person_ids
707 -- Slices of which each person is a member
708 CREATE OR REPLACE VIEW person_slices AS
710 array_accum(slice_id) AS slice_ids
714 --------------------------------------------------------------------------------
716 --------------------------------------------------------------------------------
717 -- slice whitelist on nodes
718 CREATE TABLE node_slice_whitelist (
719 node_id integer REFERENCES nodes NOT NULL, -- Node id of whitelist
720 slice_id integer REFERENCES slices NOT NULL, -- Slice id thats allowd on this node
721 PRIMARY KEY (node_id, slice_id)
723 CREATE INDEX node_slice_whitelist_node_id_idx ON node_slice_whitelist (node_id);
724 CREATE INDEX node_slice_whitelist_slice_id_idx ON node_slice_whitelist (slice_id);
726 -- Slices on each node
727 CREATE OR REPLACE VIEW node_slices_whitelist AS
729 array_accum(slice_id) AS slice_ids_whitelist
730 FROM node_slice_whitelist
733 --------------------------------------------------------------------------------
734 -- Slice tags (formerly known as slice attributes)
735 --------------------------------------------------------------------------------
737 -- Slice/sliver attributes
738 CREATE TABLE slice_tag (
739 slice_tag_id serial PRIMARY KEY, -- Slice attribute identifier
740 slice_id integer REFERENCES slices NOT NULL, -- Slice identifier
741 node_id integer REFERENCES nodes, -- Sliver attribute if set
742 nodegroup_id integer REFERENCES nodegroups, -- Node group attribute if set
743 tag_type_id integer REFERENCES tag_types NOT NULL, -- Attribute type identifier
746 CREATE INDEX slice_tag_slice_id_idx ON slice_tag (slice_id);
747 CREATE INDEX slice_tag_node_id_idx ON slice_tag (node_id);
748 CREATE INDEX slice_tag_nodegroup_id_idx ON slice_tag (nodegroup_id);
750 --------------------------------------------------------------------------------
752 --------------------------------------------------------------------------------
755 CREATE TABLE initscripts (
756 initscript_id serial PRIMARY KEY, -- Initscript identifier
757 name text NOT NULL, -- Initscript name
758 enabled bool NOT NULL DEFAULT true, -- Initscript is active
759 script text NOT NULL, -- Initscript body
762 CREATE INDEX initscripts_name_idx ON initscripts (name);
765 --------------------------------------------------------------------------------
767 --------------------------------------------------------------------------------
771 peer_id serial PRIMARY KEY, -- Peer identifier
772 peername text UNIQUE NOT NULL, -- Peer name
773 peer_url text NOT NULL, -- (HTTPS) URL of the peer PLCAPI interface
774 cacert text, -- (SSL) Public certificate of peer API server
775 key text, -- (GPG) Public key used for authentication
776 shortname text, -- abbreviated name for displaying foreign objects
777 hrn_root text, -- root for this peer domain
778 deleted boolean NOT NULL DEFAULT false
780 CREATE INDEX peers_peername_idx ON peers (peername) WHERE deleted IS false;
781 CREATE INDEX peers_shortname_idx ON peers (shortname) WHERE deleted IS false;
783 -- Objects at each peer
784 CREATE TABLE peer_site (
785 site_id integer REFERENCES sites PRIMARY KEY, -- Local site identifier
786 peer_id integer REFERENCES peers NOT NULL, -- Peer identifier
787 peer_site_id integer NOT NULL, -- Foreign site identifier at peer
788 UNIQUE (peer_id, peer_site_id) -- The same foreign site should not be cached twice
790 CREATE INDEX peer_site_peer_id_idx ON peers (peer_id);
792 CREATE OR REPLACE VIEW peer_sites AS
794 array_accum(site_id) AS site_ids,
795 array_accum(peer_site_id) AS peer_site_ids
799 CREATE TABLE peer_person (
800 person_id integer REFERENCES persons PRIMARY KEY, -- Local user identifier
801 peer_id integer REFERENCES peers NOT NULL, -- Peer identifier
802 peer_person_id integer NOT NULL, -- Foreign user identifier at peer
803 UNIQUE (peer_id, peer_person_id) -- The same foreign user should not be cached twice
805 CREATE INDEX peer_person_peer_id_idx ON peer_person (peer_id);
807 CREATE OR REPLACE VIEW peer_persons AS
809 array_accum(person_id) AS person_ids,
810 array_accum(peer_person_id) AS peer_person_ids
814 CREATE TABLE peer_key (
815 key_id integer REFERENCES keys PRIMARY KEY, -- Local key identifier
816 peer_id integer REFERENCES peers NOT NULL, -- Peer identifier
817 peer_key_id integer NOT NULL, -- Foreign key identifier at peer
818 UNIQUE (peer_id, peer_key_id) -- The same foreign key should not be cached twice
820 CREATE INDEX peer_key_peer_id_idx ON peer_key (peer_id);
822 CREATE OR REPLACE VIEW peer_keys AS
824 array_accum(key_id) AS key_ids,
825 array_accum(peer_key_id) AS peer_key_ids
829 CREATE TABLE peer_node (
830 node_id integer REFERENCES nodes PRIMARY KEY, -- Local node identifier
831 peer_id integer REFERENCES peers NOT NULL, -- Peer identifier
832 peer_node_id integer NOT NULL, -- Foreign node identifier
833 UNIQUE (peer_id, peer_node_id) -- The same foreign node should not be cached twice
835 CREATE INDEX peer_node_peer_id_idx ON peer_node (peer_id);
837 CREATE OR REPLACE VIEW peer_nodes AS
839 array_accum(node_id) AS node_ids,
840 array_accum(peer_node_id) AS peer_node_ids
844 CREATE TABLE peer_slice (
845 slice_id integer REFERENCES slices PRIMARY KEY, -- Local slice identifier
846 peer_id integer REFERENCES peers NOT NULL, -- Peer identifier
847 peer_slice_id integer NOT NULL, -- Slice identifier at peer
848 UNIQUE (peer_id, peer_slice_id) -- The same foreign slice should not be cached twice
850 CREATE INDEX peer_slice_peer_id_idx ON peer_slice (peer_id);
852 CREATE OR REPLACE VIEW peer_slices AS
854 array_accum(slice_id) AS slice_ids,
855 array_accum(peer_slice_id) AS peer_slice_ids
859 --------------------------------------------------------------------------------
860 -- Authenticated sessions
861 --------------------------------------------------------------------------------
863 -- Authenticated sessions
864 CREATE TABLE sessions (
865 session_id text PRIMARY KEY, -- Session identifier
866 expires timestamp without time zone
869 -- People can have multiple sessions
870 CREATE TABLE person_session (
871 person_id integer REFERENCES persons NOT NULL, -- Account identifier
872 session_id text REFERENCES sessions NOT NULL, -- Session identifier
873 PRIMARY KEY (person_id, session_id),
874 UNIQUE (session_id) -- Sessions are unique
876 CREATE INDEX person_session_person_id_idx ON person_session (person_id);
878 -- Nodes can have only one session
879 CREATE TABLE node_session (
880 node_id integer REFERENCES nodes NOT NULL, -- Node identifier
881 session_id text REFERENCES sessions NOT NULL, -- Session identifier
882 UNIQUE (node_id), -- Nodes can have only one session
883 UNIQUE (session_id) -- Sessions are unique
886 -------------------------------------------------------------------------------
888 ------------------------------------------------------------------------------
889 CREATE TABLE pcu_types (
890 pcu_type_id serial PRIMARY KEY,
891 model text NOT NULL , -- PCU model name
892 name text -- Full PCU model name
894 CREATE INDEX pcu_types_model_idx ON pcu_types (model);
896 CREATE TABLE pcu_protocol_type (
897 pcu_protocol_type_id serial PRIMARY KEY,
898 pcu_type_id integer REFERENCES pcu_types NOT NULL, -- PCU type identifier
899 port integer NOT NULL, -- PCU port
900 protocol text NOT NULL, -- Protocol
901 supported boolean NOT NULL DEFAULT True -- Does PLC support
903 CREATE INDEX pcu_protocol_type_pcu_type_id ON pcu_protocol_type (pcu_type_id);
906 CREATE OR REPLACE VIEW pcu_protocol_types AS
908 array_accum(pcu_protocol_type_id) as pcu_protocol_type_ids
909 FROM pcu_protocol_type
910 GROUP BY pcu_type_id;
912 --------------------------------------------------------------------------------
914 --------------------------------------------------------------------------------
916 CREATE TABLE messages (
917 message_id text PRIMARY KEY, -- Message name
918 subject text, -- Message summary
919 template text, -- Message template
920 enabled bool NOT NULL DEFAULT true -- Whether message is enabled
923 --------------------------------------------------------------------------------
925 --------------------------------------------------------------------------------
928 CREATE TABLE events (
929 event_id serial PRIMARY KEY, -- Event identifier
930 person_id integer REFERENCES persons, -- Person responsible for event, if any
931 node_id integer REFERENCES nodes, -- Node responsible for event, if any
932 auth_type text, -- Type of auth used. i.e. AuthMethod
933 fault_code integer NOT NULL DEFAULT 0, -- Did this event result in error
934 call_name text NOT NULL, -- Call responsible for this event
935 call text NOT NULL, -- Call responsible for this event, including parameters
936 message text, -- High level description of this event
937 runtime float DEFAULT 0, -- Event run time
938 time timestamp without time zone NOT NULL -- Event timestamp
939 DEFAULT CURRENT_TIMESTAMP
942 -- Database object(s) that may have been affected by a particular event
943 CREATE TABLE event_object (
944 event_id integer REFERENCES events NOT NULL, -- Event identifier
945 object_id integer NOT NULL, -- Object identifier
946 object_type text NOT NULL Default 'Unknown' -- What type of object is this event affecting
948 CREATE INDEX event_object_event_id_idx ON event_object (event_id);
949 CREATE INDEX event_object_object_id_idx ON event_object (object_id);
950 CREATE INDEX event_object_object_type_idx ON event_object (object_type);
952 CREATE OR REPLACE VIEW event_objects AS
954 array_accum(object_id) AS object_ids,
955 array_accum(object_type) AS object_types
959 --------------------------------------------------------------------------------
961 --------------------------------------------------------------------------------
962 CREATE OR REPLACE VIEW view_pcu_types AS
964 pcu_types.pcu_type_id,
967 COALESCE((SELECT pcu_protocol_type_ids FROM pcu_protocol_types
968 WHERE pcu_protocol_types.pcu_type_id = pcu_types.pcu_type_id), '{}')
969 AS pcu_protocol_type_ids
972 --------------------------------------------------------------------------------
973 CREATE OR REPLACE VIEW view_events AS
984 CAST(date_part('epoch', events.time) AS bigint) AS time,
985 COALESCE((SELECT object_ids FROM event_objects WHERE event_objects.event_id = events.event_id), '{}') AS object_ids,
986 COALESCE((SELECT object_types FROM event_objects WHERE event_objects.event_id = events.event_id), '{}') AS object_types
989 CREATE OR REPLACE VIEW view_event_objects AS
999 CAST(date_part('epoch', events.time) AS bigint) AS time,
1000 event_object.object_id,
1001 event_object.object_type
1002 FROM events LEFT JOIN event_object USING (event_id);
1004 --------------------------------------------------------------------------------
1005 CREATE OR REPLACE VIEW view_persons AS
1014 persons.verification_key,
1015 CAST(date_part('epoch', persons.verification_expires) AS bigint) AS verification_expires,
1020 CAST(date_part('epoch', persons.date_created) AS bigint) AS date_created,
1021 CAST(date_part('epoch', persons.last_updated) AS bigint) AS last_updated,
1022 peer_person.peer_id,
1023 peer_person.peer_person_id,
1024 COALESCE((SELECT role_ids FROM person_roles WHERE person_roles.person_id = persons.person_id), '{}') AS role_ids,
1025 COALESCE((SELECT roles FROM person_roles WHERE person_roles.person_id = persons.person_id), '{}') AS roles,
1026 COALESCE((SELECT site_ids FROM person_sites WHERE person_sites.person_id = persons.person_id), '{}') AS site_ids,
1027 COALESCE((SELECT key_ids FROM person_keys WHERE person_keys.person_id = persons.person_id), '{}') AS key_ids,
1028 COALESCE((SELECT slice_ids FROM person_slices WHERE person_slices.person_id = persons.person_id), '{}') AS slice_ids
1030 LEFT JOIN peer_person USING (person_id);
1032 --------------------------------------------------------------------------------
1033 CREATE OR REPLACE VIEW view_peers AS
1036 COALESCE((SELECT site_ids FROM peer_sites WHERE peer_sites.peer_id = peers.peer_id), '{}') AS site_ids,
1037 COALESCE((SELECT peer_site_ids FROM peer_sites WHERE peer_sites.peer_id = peers.peer_id), '{}') AS peer_site_ids,
1038 COALESCE((SELECT person_ids FROM peer_persons WHERE peer_persons.peer_id = peers.peer_id), '{}') AS person_ids,
1039 COALESCE((SELECT peer_person_ids FROM peer_persons WHERE peer_persons.peer_id = peers.peer_id), '{}') AS peer_person_ids,
1040 COALESCE((SELECT key_ids FROM peer_keys WHERE peer_keys.peer_id = peers.peer_id), '{}') AS key_ids,
1041 COALESCE((SELECT peer_key_ids FROM peer_keys WHERE peer_keys.peer_id = peers.peer_id), '{}') AS peer_key_ids,
1042 COALESCE((SELECT node_ids FROM peer_nodes WHERE peer_nodes.peer_id = peers.peer_id), '{}') AS node_ids,
1043 COALESCE((SELECT peer_node_ids FROM peer_nodes WHERE peer_nodes.peer_id = peers.peer_id), '{}') AS peer_node_ids,
1044 COALESCE((SELECT slice_ids FROM peer_slices WHERE peer_slices.peer_id = peers.peer_id), '{}') AS slice_ids,
1045 COALESCE((SELECT peer_slice_ids FROM peer_slices WHERE peer_slices.peer_id = peers.peer_id), '{}') AS peer_slice_ids
1048 --------------------------------------------------------------------------------
1049 CREATE OR REPLACE VIEW node_tags AS
1051 array_accum(node_tag_id) AS node_tag_ids
1055 CREATE OR REPLACE VIEW view_node_tags AS
1057 node_tag.node_tag_id,
1060 tag_types.tag_type_id,
1062 tag_types.description,
1064 tag_types.min_role_id,
1067 INNER JOIN tag_types USING (tag_type_id)
1068 INNER JOIN nodes USING (node_id);
1070 CREATE OR REPLACE VIEW view_nodes AS
1086 CAST(date_part('epoch', nodes.date_created) AS bigint) AS date_created,
1087 CAST(date_part('epoch', nodes.last_updated) AS bigint) AS last_updated,
1088 CAST(date_part('epoch', nodes.last_contact) AS bigint) AS last_contact,
1090 peer_node.peer_node_id,
1091 COALESCE((SELECT interface_ids FROM node_interfaces
1092 WHERE node_interfaces.node_id = nodes.node_id), '{}')
1094 COALESCE((SELECT nodegroup_ids FROM node_nodegroups
1095 WHERE node_nodegroups.node_id = nodes.node_id), '{}')
1097 COALESCE((SELECT slice_ids FROM node_slices
1098 WHERE node_slices.node_id = nodes.node_id), '{}')
1100 COALESCE((SELECT slice_ids_whitelist FROM node_slices_whitelist
1101 WHERE node_slices_whitelist.node_id = nodes.node_id), '{}')
1102 AS slice_ids_whitelist,
1103 COALESCE((SELECT pcu_ids FROM node_pcus
1104 WHERE node_pcus.node_id = nodes.node_id), '{}')
1106 COALESCE((SELECT ports FROM node_pcus
1107 WHERE node_pcus.node_id = nodes.node_id), '{}')
1109 COALESCE((SELECT conf_file_ids FROM node_conf_files
1110 WHERE node_conf_files.node_id = nodes.node_id), '{}')
1112 COALESCE((SELECT node_tag_ids FROM node_tags
1113 WHERE node_tags.node_id = nodes.node_id), '{}')
1115 node_session.session_id AS session
1117 LEFT JOIN peer_node USING (node_id)
1118 LEFT JOIN node_session USING (node_id);
1120 --------------------------------------------------------------------------------
1121 CREATE OR REPLACE VIEW view_nodegroups AS
1125 COALESCE((SELECT conf_file_ids FROM nodegroup_conf_files
1126 WHERE nodegroup_conf_files.nodegroup_id = nodegroups.nodegroup_id), '{}')
1128 COALESCE((SELECT node_ids FROM nodegroup_nodes
1129 WHERE nodegroup_nodes.nodegroup_id = nodegroups.nodegroup_id), '{}')
1131 FROM nodegroups INNER JOIN tag_types USING (tag_type_id);
1133 --------------------------------------------------------------------------------
1134 CREATE OR REPLACE VIEW view_conf_files AS
1137 COALESCE((SELECT node_ids FROM conf_file_nodes
1138 WHERE conf_file_nodes.conf_file_id = conf_files.conf_file_id), '{}')
1140 COALESCE((SELECT nodegroup_ids FROM conf_file_nodegroups
1141 WHERE conf_file_nodegroups.conf_file_id = conf_files.conf_file_id), '{}')
1145 --------------------------------------------------------------------------------
1146 CREATE OR REPLACE VIEW view_pcus AS
1149 COALESCE((SELECT node_ids FROM pcu_nodes WHERE pcu_nodes.pcu_id = pcus.pcu_id), '{}') AS node_ids,
1150 COALESCE((SELECT ports FROM pcu_nodes WHERE pcu_nodes.pcu_id = pcus.pcu_id), '{}') AS ports
1153 --------------------------------------------------------------------------------
1154 CREATE OR REPLACE VIEW view_sites AS
1159 sites.abbreviated_name,
1168 sites.ext_consortium_id,
1169 CAST(date_part('epoch', sites.date_created) AS bigint) AS date_created,
1170 CAST(date_part('epoch', sites.last_updated) AS bigint) AS last_updated,
1172 peer_site.peer_site_id,
1173 COALESCE((SELECT person_ids FROM site_persons WHERE site_persons.site_id = sites.site_id), '{}') AS person_ids,
1174 COALESCE((SELECT node_ids FROM site_nodes WHERE site_nodes.site_id = sites.site_id), '{}') AS node_ids,
1175 COALESCE((SELECT address_ids FROM site_addresses WHERE site_addresses.site_id = sites.site_id), '{}') AS address_ids,
1176 COALESCE((SELECT slice_ids FROM site_slices WHERE site_slices.site_id = sites.site_id), '{}') AS slice_ids,
1177 COALESCE((SELECT pcu_ids FROM site_pcus WHERE site_pcus.site_id = sites.site_id), '{}') AS pcu_ids
1179 LEFT JOIN peer_site USING (site_id);
1181 --------------------------------------------------------------------------------
1182 CREATE OR REPLACE VIEW view_addresses AS
1185 COALESCE((SELECT address_type_ids FROM address_address_types WHERE address_address_types.address_id = addresses.address_id), '{}') AS address_type_ids,
1186 COALESCE((SELECT address_types FROM address_address_types WHERE address_address_types.address_id = addresses.address_id), '{}') AS address_types
1189 --------------------------------------------------------------------------------
1190 CREATE OR REPLACE VIEW view_keys AS
1193 person_key.person_id,
1195 peer_key.peer_key_id
1197 LEFT JOIN person_key USING (key_id)
1198 LEFT JOIN peer_key USING (key_id);
1200 --------------------------------------------------------------------------------
1201 CREATE OR REPLACE VIEW slice_tags AS
1203 array_accum(slice_tag_id) AS slice_tag_ids
1207 CREATE OR REPLACE VIEW view_slices AS
1212 slices.instantiation,
1216 slices.creator_person_id,
1218 CAST(date_part('epoch', slices.created) AS bigint) AS created,
1219 CAST(date_part('epoch', slices.expires) AS bigint) AS expires,
1221 peer_slice.peer_slice_id,
1222 COALESCE((SELECT node_ids FROM slice_nodes WHERE slice_nodes.slice_id = slices.slice_id), '{}') AS node_ids,
1223 COALESCE((SELECT person_ids FROM slice_persons WHERE slice_persons.slice_id = slices.slice_id), '{}') AS person_ids,
1224 COALESCE((SELECT slice_tag_ids FROM slice_tags WHERE slice_tags.slice_id = slices.slice_id), '{}') AS slice_tag_ids
1226 LEFT JOIN peer_slice USING (slice_id);
1228 CREATE OR REPLACE VIEW view_slice_tags AS
1230 slice_tag.slice_tag_id,
1233 slice_tag.nodegroup_id,
1234 tag_types.tag_type_id,
1236 tag_types.description,
1238 tag_types.min_role_id,
1242 INNER JOIN tag_types USING (tag_type_id)
1243 INNER JOIN slices USING (slice_id);
1245 --------------------------------------------------------------------------------
1246 CREATE OR REPLACE VIEW view_sessions AS
1248 sessions.session_id,
1249 CAST(date_part('epoch', sessions.expires) AS bigint) AS expires,
1250 person_session.person_id,
1251 node_session.node_id
1253 LEFT JOIN person_session USING (session_id)
1254 LEFT JOIN node_session USING (session_id);
1256 --------------------------------------------------------------------------------
1257 -- Built-in maintenance account and default site
1258 --------------------------------------------------------------------------------
1260 INSERT INTO persons (first_name, last_name, email, password, enabled)
1261 VALUES ('Maintenance', 'Account', 'maint@localhost.localdomain', 'nopass', true);
1263 INSERT INTO person_role (person_id, role_id) VALUES (1, 10);
1264 INSERT INTO person_role (person_id, role_id) VALUES (1, 20);
1265 INSERT INTO person_role (person_id, role_id) VALUES (1, 30);
1266 INSERT INTO person_role (person_id, role_id) VALUES (1, 40);
1268 INSERT INTO sites (login_base, name, abbreviated_name, max_slices)
1269 VALUES ('pl', 'PlanetLab Central', 'PLC', 100);