User manual

ManualsBrandsYork ManualsAir ConditionerDCPM

User Manual

Understanding the full capabilities of DCPM

Summary of content (160 pages)

PAGE 1
User Manual Understanding the full capabilities of DCPM
PAGE 2
Revision Date Name Comment DCPM Version 11/10/2012 Kris De Peuter Create manual basics 1.3.3 15/06/2013 Lesley Zonnekein Review manual and add installation information 1.3.3 08/07/2013 Lesley Zonnekein Add information on settings Formulas, add new features of 1.3.4 1.3.4 11/10/2013 Lesley Zonnekein Add information on maps 1.3.4 28/01/2014 Lesley Zonnekein 23/04/2014 Lesley Zonnekein Add information on version 1.3.5 & 1.3.
PAGE 3
Index Revision ................................................................................................................................................... 2 Index ........................................................................................................................................................ 3 Welcome ............................................................................................................................................... 15 About this document............
PAGE 4
Main window ..................................................................................................................................... 37 Interface ............................................................................................................................................ 38 Spaces ............................................................................................................................................ 38 Pages.....................................................
PAGE 5
Administration - User Management.......................................................................................... 54 Add a user .......................................................................................................................... 54 Changing User Passwords.................................................................................................. 54 Removing a User.............................................................................................................
PAGE 6
Rack ............................................................................................................................................... 67 Graphs presented in the structure ................................................................................................ 69 Feed ............................................................................................................................................... 70 Edit Feed ................................................................
PAGE 7
Information Sources .................................................................................................................. 89 SNMP ..................................................................................................................................... 89 Scope ................................................................................................................................. 89 Source ......................................................................................
PAGE 8
Co2 report for datacenter ........................................................................................................... 102 Feeds report for datacenter ........................................................................................................ 103 Energy per customer report ........................................................................................................ 103 Energy per device report ............................................................................
PAGE 9
Sample ............................................................................................................................. 113 Button Macro ...................................................................................................................... 114 Parameters ...................................................................................................................... 114 Example .................................................................................................
PAGE 10
Parameters ...................................................................................................................... 120 Example ........................................................................................................................... 120 Sample ............................................................................................................................. 120 Energy per Application Report Macro .....................................................................
PAGE 11
Grid Macro........................................................................................................................... 126 Parameters ...................................................................................................................... 126 Example ........................................................................................................................... 127 Sample .................................................................................................
PAGE 12
Sample ............................................................................................................................. 136 Multi Line Graph Macro ...................................................................................................... 136 Parameters ...................................................................................................................... 136 Example .......................................................................................................
PAGE 13
Parameters ...................................................................................................................... 143 Example ........................................................................................................................... 143 Sample ............................................................................................................................. 143 Protovis Macro ..........................................................................................
PAGE 14
Example ........................................................................................................................... 150 Sample ............................................................................................................................. 151 Table Macro ......................................................................................................................... 151 Parameters ..........................................................................................
PAGE 15
Welcome About this document Thank you for choosing the Racktivity Data Center Performance Manager solution. This document explains the basic structure, components and work flow of the DCPM platform and will guide you through a basic configuration. We advise to carefully read this guide before using the software. About DCPM The Data Center Performance Manager platform is a browser based application that monitors and manages power and other environmental parameters in data centers or other facilities.
PAGE 16
Installation Hardware requirements Application server (without db): - Server: Can be a virtual server - Operating System: According to supported OS list - Memory: 4 GB RAM per 100 devices - Processor: 35% of standardized 1.7GHz CPU per 100 points. For configuration of devices (servers) the user can create 3 devices for one point. - Storage: 10GB minimum, more if logging scheme is extended (logs are kept for 3 days only by default) Database server: - PostgreSQL (tested with 8.
PAGE 17
   o UDP ports 161 162 11211 DCPM should have access to following ports on hardware: o TCP ports 80/443 (HTTP/S) o UDP ports 161 and 162 (SNMP) o TCP port 502 (ModBusTCP) o UDP port 16388 (firmware upgrade) hardware should have access to following ports on DCPM: o UDP ports 161 and 162 (SNMP) DCPM is downloadable from http://downloads.test.racktivity.com/dcpm/1.5.1/installationpackage.tgz port 88 should be open on the firewall if applicable.
PAGE 18
  Ubuntu Server 14.04 (Linux-64bit) Windows The operating system can be installed on a virtual machine or server using the following specs: - Storage: 5 GB per 100 devices/month (for raw data). - Note: DCPM implements data retention, that limits detailed data storage. Please consult your desired retention scheme to define storage required. - Memory: 4GB - dual core CPU Install the Database postgresql Postgresql is free downloadable software .
PAGE 19
Install DCPM Database Type the following command as root using the command line in the terminal: su- postgres (Debian) sudo su postgres (Ubuntu) Type now psql Above commands take you in the psql (command line) to create your database. Create 2 different databases - Type the following command to create your main database CREATE DATABASE dcpmdb; With the above command you create the main database called “dcpmdb”. You can use any desired name for this.
PAGE 20
- Type the following command to alter your created database to your created user. This action needs to be performed for both databases. ALTER DATABASE dcpmdb OWNER TO dcpm; Again here “dcpmdb” is the name of your created database, “dcpm” is the name of your created user. Now the same needs to be done for your second created database. So in our example type: ALTER DATABASE dcpmmon OWNER TO dcpm; Again here “dcpmmon” is the name of your created database, “dcpm” is the name of your created user.
PAGE 21
To Get access via SSH to the server you need to download a SSH client Apt-get install openssh-server Set up static IP on umbuntu server http://www.youtube.com/watch?v=cjQu_1HhTro Installing DCPM If you are in using a windows based platform you could download Virtual box to create your own virtual linux machine. Network settings should be set as “network bridged adaptor” You have 2 options for installing DCPM. 1. Using an internal database (65GB of disk space required) 2. Using an external database.
PAGE 22
1. Open the Linux terminal 2. Login as root: Go to root by the following command: sudo su or (depending on your installed OS) su You will be asked for a password which the system admin should be able to provide. 3. Download the DCPM installation package on your machine by adding the following command in the Terminal page: wget http://downloads.test.racktivity.com/dcpm/1.5.1/installationpackage.tgz press Enter © 2011 Racktivity NV Antwerpsesteenweg 19 - 9080 Lochristi - Belgium - www.racktivity.
PAGE 23
The installation starts When the installation is completed you should have the following screen 4. Unpack the installer by entering the following command: tar –xzf installationpackage.tgz © 2011 Racktivity NV Antwerpsesteenweg 19 - 9080 Lochristi - Belgium - www.racktivity.com 23/160 v 2014.5.
PAGE 24
Type the following command cd installationpackage/ press enter 5. Type the following command ./debootstrap-installer.sh © 2011 Racktivity NV Antwerpsesteenweg 19 - 9080 Lochristi - Belgium - www.racktivity.com 24/160 v 2014.5.
PAGE 25
6. You will be asked to use an external database or the default internal database a. External database: This database will be used for production, (database is stored on an external machine). Postgresql or oracle. (press 0) b.
PAGE 26
7. Prompt is displayed asking if you want to install a read only setup. A read only set up is used when you want to install a blank DCPM system that will be used for uploading back up files into the read only systems. No monitoring is performed when installing DCPM as read only. Replications could be done to a read only system from a live system using its backup files. All changes done in the read only setup will not be replicated to the active system where you have downloaded the backup files from. 8.
PAGE 27
10. Browse to the above ip address in your internet browser. Supported internet browser are:  Mozilla Firefox  Google Chrome 11. You will be directed to the install page of DCPM © 2011 Racktivity NV Antwerpsesteenweg 19 - 9080 Lochristi - Belgium - www.racktivity.com 27/160 v 2014.5.
PAGE 28
Update from version 1.3.4 to version 1.3.5 In this section of the document we have added the procedure for upgrading the DCPM software from version 1.3.4 to version 1.3.5. If an older version of DCPM is installed you need to make sure that you perform the upgrades per version, so from 1.3.2 to 1.3.3 to 1.3.4 to 1.3.5. 1. 2. 3. 4. Log in on the machine where DCPM is installed and go to the terminal. Log in as root. Type “mkdir 1.3.5” to make a new directory Type “cd 1.3.5” 5.
PAGE 29
Update from version 1.4.0 to version 1.5.0 In this section of the document we have added the procedure for upgrading the DCPM software from version 1.4.0 to version 1.5.0 If an older version of DCPM is installed you need to make sure that you perform the upgrades per version, so from 1.3.2 to 1.3.3 to 1.3.4 to 1.3.5 to 1.4.0 and from 1.4.0 to version 1.5.0 1. 2. 3. 4. Log in on the machine where DCPM is installed and go to the terminal. Log in as root. Type “mkdir 1.5” to make a new directory Type “cd 1.
PAGE 30
Uninstall DCPM older versions Uninstalling DCPM is only applicable on the following software versions using an internal database: - 1.1 1.2 1.3 1.3.1 1.3.2 1.3.3 1.3.4 1.3.5 1.4.0 1. 2. 3. 4. Log in on the machine where DCPM is installed and go to the terminal. Log in as root. Type ”/etc/init.d/dcpm stop” to Stop DCPM Type ”rm –rf /srv/chroot/dcpm” (or the installation path that you provided) to remove DCPM files 5. Type ”rm –f /etc/init.d/dcpm” to remove the startup script.
PAGE 31
Configure a HTTPS access on DCPM To generate a HTTPS access on DCPM below instructions need to be added in the root on the server terminal. Make sure you are in the installation package folder of DCPM. cp scripts/nginx-https-setup.py /srv/chroot/dcpm press enter now type the following chroot /srv/chroot/dcpm press enter next is the following command: python nginx-https-setup.py country=US state=Arizona city=Atlanta organization=Org unit=Unit domain=dcpm.
PAGE 32
First set up 1. When the DCPM installation is done you can browse to the IP address with your internet browser. Supported internet browsers are: a. Mozilla Firefox b. Google Chrome DCPM states that it is the first time you run the software, you will be asked if you would like to set up some data. The initial set up is done in five steps 1. Company Name: here you need to add your Company Name as requested: 2.
PAGE 33
4. Set up SNMP (v2) information 5. General set up A detailed explanation of the preferences can be found in section “Administration Settings” in the DCPM user manual © 2011 Racktivity NV Antwerpsesteenweg 19 - 9080 Lochristi - Belgium - www.racktivity.com 33/160 v 2014.5.
PAGE 34
In case of an error in the set up data, the system will highlight the error when trying to submit the changes: Correct the errors and finalize the set up data. Should you not have a proper license key, the system can be configured and will be organized in evaluation mode. The evaluation mode allows a connection of maximum 2 devices. All other functionalities will be available. 6.
PAGE 35
At least the following Components need to be defined before DCPM can be populated with devices (pictured in blue in the picture above):  Enterprise: Every DCPM instance has 1 Enterprise that defines your organization. It cannot be deleted.  Location: Geographical location or region of the Components below.  Datacenter: Datacenter in which the Components below are located.  Rack: The rack in which the devices are mounted.
PAGE 36
 Energy consumer The energy consumer is available on rack level and monitors output in the rack. It behaves like an EnergySwitch. See section Energy Consumer for detailed information on set up and usage. Notes:  The maximum number of possible levels is 8.  A parent can house many children (i.e.: multiple floors in 1 datacenter), but the children cannot be of a different type. Example: When you have created a floor in a datacenter, you can’t create a room as child under that same datacenter.
PAGE 37
DCPM Navigation The DCPM main navigation is based on breadcrumbs. A breadcrumb navigation (or “breadcrumb trail”) is a type of secondary navigation scheme that reveals the user’s location in an application. We use this type of navigation to support the hierarchical structures of the datacenters. Main window Most screens within DCPM are based on the same layout, as described below: 1. Search box Search the entire system for a specific string. Click Advanced Search for more options. 2.
PAGE 38
Interface Spaces A Space is a logical group of pages and can be found on the left side of the navigation bar. Hold your cursor over the “View” icon in the navigation pane to see the full list. Click the space to see the content. By default the following spaces are available to the user:        View Shows the structure of your organization with all monitoring data. Alarms Shows all data related to alarms (operator panel, history…) Reports Displays reports for your infrastructure.
PAGE 39
http://daringfireball.net/projects/markdown/ Remark: newly created pages cannot be visualized if they are not linked to the parent home in the user space. Bookmarks Upon set up of DCPM, 3 bookmarks are available  Discovered  Settings  Alarms The bookmarks can be adapted via the settings page in the Admin space.
PAGE 40
Search function in DCPM Simple Search In the Simple mode DCPM returns all the pages that contain the searched words in the title, labels or their content. Advanced Search In the Advanced mode DCPM gives you three possibilities to look up information. You have these three search fields at your disposal:  Title By entering data in the Title box, DCPM looks up for matching page titles or object names in its database. Matching pages are displayed as you type, which make it very user-friendly.
PAGE 41
Admin Space: Administration - Settings The page Settings contains the administration data. The page is bookmarked The page is divided in sections with specific information or administration options Settings SMTP settings     SMTP server settings SMTP login credentials Global receiver: address that will receive messages and information out of DCPM Global sender: address from which information out of DCPM is sent.
PAGE 42
     This is the period in minutes (default 30) to identify the period when a new alarm should not be raised after that a previous alarm had been acknowledged by a user. Anti-flood protection delay This is the delay in seconds (default 30) set to prevent continuous alarms on state changes. Autodiscovery interval This is the period in minutes (default 30) between discovery cycles. Automatic hardware change detection Activate this option to look for potential hardware configuration changes.
PAGE 43
When activation the keep alarm function the wizard will provide the option to change the subject field of the keep alarm message. Contact Information  General contact information UI Settings This section is only available as from DCPM version 1.4.0. The UI information can be used to set up some standard credentials in DCPM when implementing devices or hardware. Pressing the Edit wizard defaults will able the user to configure his standard credentials and SNMP information.
PAGE 44
Pressing the Hide common messages button will show below list of messages that should be disabled when using DCPM. Default all messages will be presented by DCPM when performing actions. Messages that are selected in this box will not appear any more when using DCPM. System maintenance Retention © 2011 Racktivity NV Antwerpsesteenweg 19 - 9080 Lochristi - Belgium - www.racktivity.com 44/160 v 2014.5.
PAGE 45
 Days to keep RAW data Number of days where the data is stored on a five minute interval, this is not an average of the previous five minutes but real time information.  Days to keep daily collapsed data This is the min, max, average data of the days  Months to keep monthly collapsed data This is the min, max, average data of the previous months  Days to keep archived alarms Manage your setup DCPM provides the option to upload and download a datacenter structure.
PAGE 46
Properties need to be identified with corresponding values  Download structure In case a structure is already set up, it is possible to download this structure and adapt before uploading again via previous function. General information This section outlines the DCPM version and license version. In case no license is available, an evaluation version is active. To change the license key, select the option change license and add the license key.
PAGE 47
The buttons are from left to right:  Add image - used to upload a new map image  New - used to create a new map  Edit - change the map name and select a different map image  Save - saves the map properties  Load - load a different map in the editor  Delete image/map Create maps Uploading a new map file To upload a new map file:    Click on 'Add image' mark from the top-right corner of the map editor.
PAGE 48
 Fill in the name of the created component in the 'component' text box. You will notice that a list of objects is displayed beneath the 'Object' text box while you type. After an object is selected, a list of attribute names is displayed in the upper section of the map editor.  (available as from DCPM version 1.4.0) When you have selected the component you will be able to select input, output or formula information.
PAGE 49
 Saving the map configuration To save the map configuration click on the 'Save' mark from the top-right corner of the page. View maps To view a map with detailed information, add the map editor macro on a dedicated page. The map editor macro can be found in DCPM advanced – macros –List of predefined Macros Formula editor This section describes the Formula editor available from Settings page. The purpose of Formula editor is to create calculations on measured values.
PAGE 50
When adding tags you are not allowed to use spaces. Different tags need to be separated by a comma. When selecting the Editor in the settings bookmark you will be directed to the editor: Five Boxes are presented in the editor: 1. 2. 3. 4. 5. Presentation of the tags assigned in DCPM Metrics box to select the metric type on which you would like to create a formula Time range for the data Formula overview box Formula names that where created.
PAGE 51
2. 3. 4. 5. 6. 7. 8. Select your metric in box 2 Select your time range in box 3 Select your operator for the calculation, Allowed operators are + - * / ^ ( ) a number Select again your tag in box 1 Select your metric in box 2 Select your time range in box 3 ….. Now your formula can be saved by clicking the save button in the top right corner.
PAGE 52
Add corresponding object and values: Press the edit button to perform the following actions:  change the Title of the structure box  Assign an object of the selected structure type  Assign a value to present in the scheme Presentation of the scheme in DCPM Presentation of the scheme can be done by creating a page with a macro. The macro to use is described in the macro section. Firmware update/upgrade Use this link to update the firmware of one or multiple connected Racktivity devices. 1.
PAGE 54
Administration - User Management After the initial setup of DCPM, there is only one user available to access the application. With the user management you can add users and define their user rights. To access the user management, go to the settings page. In the General section, click User and permission management. Two tables appear: Users and Groups. Add a user To add a new user, click the button Add. A form appears to fill out the user credentials. Fill out the user data and click Add.
PAGE 55
Enter a new password and click Change. The password is updated. The new password must be applied upon the next login of the user. Removing a User To remove a user, click Remove next to the user. A confirmation window appears. Click Remove to confirm the removal of the user. The user permissions are immediately revoked. If the user has an open session, he is no longer able to perform new actions. Creating a Group To create a new group, click Add Group. A form appears to fill out the group credentials.
PAGE 56
Update the group name and click Rename. The group name is updated. Adding a User to Groups To add a user to a group, click the name of a user. The list of groups, to which the user belongs, appears. Click Add to group. A form appears with the list of available groups. Select to group to which you want to add the user and click Add. The selected group appears in the list of groups. The user must restart his session to apply the changes.
PAGE 57
Assigning Rules for a Group To create a rule for a group, click the name of a group for which you want to create a rule. The details of the group are expanded. Click Assign rule, a form appears with a list of rules. There are two types of rules: general rules and object specific rules. In the general rules section you can permit or deny access to IDE and Administration spaces. Also, permissions for creating, editing and deleting pages can be set in this section.
PAGE 58
Click Add to assign the rule to the group. Repeat this to assign more rules to the group. Revoking a Rule in a Group To revoke a rule in a group click the name of a group for which you want to revoke a rule. The details of the group are expanded. Click Revoke next to the rule that you want to revoke. A confirmation window appears. Click Revoke to confirm the removal of the rule from the group. The rule is immediately revoked and disappears from the list of rules.
PAGE 59
Click Remove to confirm the removal of the group. Bookmarks management Manage the bookmarks section. The user can add a bookmark by pressing the “Add bookmark” button. In the new pop up screen you need to add the URL and the name of your bookmark. Space management Create a Space © 2011 Racktivity NV Antwerpsesteenweg 19 - 9080 Lochristi - Belgium - www.racktivity.com 59/160 v 2014.5.
PAGE 60
To be able to create a new space in DCPM, the Group you are part of needs to have the 'Access Administration' right assigned.    Select the Admin space from the upper left dropdown menu. Click on Space management. Click on Create New Space and a form will appear to create a space.  Provide a Name for the space and click Create Space. The new space will appear in the list of spaces. Use this section also to rename spaces or change their order by drag and drop.
PAGE 61
 Provide a new name for the space and click Rename Space. Change page lay out You can edit page templates via the IDE normally the same way as any other files or by clicking "Edit Templates" When the templates are modified, you can regenerate the pages by clicking "Generate Pages". Devices This section describes how to handle Racktivity and third party hardware.
PAGE 62
Selecting this option will give you a list of all racks with available IP addresses. You can select the button Discover to start an immediate auto discovery. This way you are not forced to wait until discovery based on the interval period. Remark: In case the IP address is empty you can use function button edit to configure the autodiscovery. Configure EnergySwitches Select the device in the list and click button Configure.
PAGE 63
List of Energy Switches, Energy Consumers or Feed monitors that are not connected to feeds. Created devices All monitored hardware List of all Energy Switches, Energy consumers and Feed monitors. Created devices List of devices created in DCPM Unconfigured devices This section provides a list of devices that are not configured for monitoring. Alarm definitions This section presents a complete overview of all alarms made in DCPM.
PAGE 64
Contact us Via this section the user can sent an email directly to DCPM support. This can be used for reporting bugs or feature requests. View Space The view space contains all pages with the existing datacenter levels (location-datacenter-roomfloor-rack…). Via the breadcrumb style navigation you can roll out the datacenter structure. Scroll over the navigation pane and select the corresponding page.
PAGE 65
Manual creation of a structure The following Components can be added manually to your DCPM instance. Once created, a Component can be edited by navigating to the applicable Page and selecting Edit in the Actions menu. Enterprise Enterprise is the default Component enabled in DCPM and represents the top of the Component hierarchy.  Use the Action menu to edit and rename to your organization. Give this Component your specific enterprise name.
PAGE 66
    The “Create Datacenter” wizard appears. Fill in the necessary fields on both tabs (including time zone as this will enable correct time information on graphs and reports) and click Submit. Add a feed The system will prompt a message to add a feed Assign a feed in case you want to measure the incoming power distributed over your datacenter. All feed options and possibilities are available in section feed. A feed can bet defined later via the actions menu. A confirmation window appears, click OK.
PAGE 67
Depending on the layout of the datacenter, a floor can be one big room by itself, or it can be divided in multiple rooms. Note: A room can be added to a datacenter or a floor (but not both). To add a room:  Navigate to the parent Page using the navigation pane.  Move the cursor over the Actions menu in the navigation pane and select “Add Room”.  The “Create Room” wizard appears. Fill in the necessary fields and click Submit.  A confirmation window appears, click OK.
PAGE 68
 Move the cursor over the Actions menu in the navigation pane and select “Add Rack”. The “Create Rack” wizard appears. Fill in the necessary fields (optionally set the automatic discovery options (IP addresses or ranges) on the Auto Discovery tab) and click Submit. When the rack is created the user has the option of performing following actions directly in the rack: Edit Rack: Change the Rack name, rack type, rack position, add some description for the rack, add a tag and/or Label.
PAGE 69
Graphs presented in the structure When creating an datacenter, floor, room, pod, rack DCPM will present graphs in the standard template. Values on those graphs are output values measured by configured energy consumers. When the user installs a feed monitor graphs will present input power for the feed monitor. Graphs will always present the aggregated data of its direct children. At the lowest part of the configured structure you will find the data gathered by the energy consumer in detail.
PAGE 70
Feed A feed is the representation of the incoming power. We identify the feeds on datacenter level. To create a feed:  Navigate datacenter page and add feed via actions menu  Identify the feed name and capacity (A)  Submit When a feed is created, it becomes available on datacenter level.
PAGE 71
Cost calculation In the tab cost calculation the user is able to enter the power cost of the energy used. There are several possibilities for entering the following cost:   Monthly subscription Fee Cost (per kWh) The user has the possibility to select:  Flat Fee: Cost is used as is, no variables are set in the cost.  Hourly changes (per kWh): User can set different costs per hour.  Daily changes: Cost is changing per full day this is settable by the user per day.
PAGE 72
 Select edit feed  Select the appropriate component level (always below datacenter level as this level is represented by the main feed) Submit  The result is a feed structure as shown in example below: Feed information The info of the feeds is centralized on location level. The power usage is coming from the EnergySwitches connected to the feeds. The total capacity is coming from the feed itself.
PAGE 73
Delete components Components of the structure can be deleted. As a result all information of the lower levels will be erased. Deleting part of the structure can be done through the action button. The enterprise level cannot be deleted! Access device WebGUI DCPM provides the user with two options to access configured device web GUI’s.
PAGE 74
A new wizard will pop up for configuration of the tunnel. To create a tunnel you should select the option to connect through http:// or through https://. REMARK: Standard Racktivity products are connecting over https:// so you should connect to port 443 When submitting the tunnel you can paste the presented URL in the web browser for direct connection to the device.
PAGE 75
Reconfigure EnergySwitches Whenever new modules like Energy sensor have been added to the EnergySwitch, these modules can be integrated in the DCPM via a reconfiguration of the ES. This way you are not losing any historical data. Vice versa, in case an Energy sensor is disconnected from the EnergySwitch, a reconfiguration will delete the data from DCP. To reconfigure the energy switch you need to go to the energy switch in DCPM and press the Reconfigure Energy Switch under the action button.
PAGE 76
Additional monitoring This section describes the possibilities of using devices and monitoring modules within DCPM. Feed monitor A feed monitor can be various types of feed monitoring systems whereby we measure the incoming power or feed usage accurately for better capacity planning. The feed monitor can be added to all levels including and below component Datacenter. Create Feed monitor  Select the option from the actions menu.
PAGE 77
In order to add the feed monitor to your DCPM application, you have to enter the following values in the ‘create feed monitor’ wizard: Name: Define a name for your feed monitor. Sync Option: Synchronization of names from DCPM to device or visa versa (available as from version 1.4.0) Product Type: Select the product type of the feed monitor you would like to add.
PAGE 78
Module ID: Enter the internal Modbus slave ID from the device. Should always be a unique numeric value. IP address: Enter the IP address of your device API Port: Enter the API port of your device. By default you should use ‘443’. Complete the wizard by entering the device login IDs and corresponding passwords. When adding a DC²Sensor to your DCPM module, you will need to complete the additional permission data requested in order to connect your device to DCPM.
PAGE 79
An Energy consumer in DCPM is a device that will monitor the output of a connected load. It behaves as a normal EnergySwitch, will be part of the total aggregated measurement data and can be of any type.
PAGE 80
Submit to go to wizard page (2/2)  Attach the consumer to the correct feed (like an EnergySwitch) The feed information of the energy consumer is used to calculate the feed capacity. As a result, the power information can be read and is used to calculate capacity of the assigned feed. HINT! In case the feed is not using data from the energy consumer, review whether you have selected the correct type of current (AC or DC) when identifying the feed.
PAGE 81
Devices A device can be any type of system, server or workstation with Windows or Linux platform. DCPM is able to monitor and manage devices in 2 ways: Either the devices are connected to the EnergySwitches or the devices can be accessed through a separately installed Racktivity agent. Different parameters like CPU usage, number of processes and the top applications can be monitored for each device. To add a new device in DCPM:  Navigate to the rack space of your DC structure.
PAGE 82
Management options:  Reboot - reboots the device by sending the reboot command to its operating system (via the agent)  Shutdown - shuts down a device by sending the shutdown command to its operating system (via the agent).
PAGE 83
Select the device to access in edit mode and adapt the network data. Outlet grouping In case configured EnergySwitches are available, it is an option to link outlets from the connected EnergySwitches (only on rack level) via the device. There is a maximum of 8 outlets per device. The linking can happen in 2 ways: via the creation process wizard or via the change device option in the actions menu.
PAGE 84
Racktivity agent Installation Agents are installed on physical and/or virtual machines. They are used to monitor the machine itself and to allow us to cleanly shut down the machine if needed. The monitored items are monitored at a 30 second interval and collapsed each 5 minutes. This collapsed data can then be retrieved from the agent or let the agent push it to DCPM. With this info we can then later on provide very specific and accurate power usage up to application level.
PAGE 85
Configuration The configuration can be done by changing the agent.ini file in a text file editor. The agent.ini file can be found on:   Linux: /etc/racktivity/agent.ini Windows: c:\Program Files\Racktivity\agent.ini or c:\Program Files (x86)\Racktivity\agent.ini agent.ini [main] host=0.0.0.0 port=1666 workers=4 allowed=192.168.14.214,127.0.0.1,192.168.14.219 debug=0 [shutdown] url=http://192.168.14.214/agent.cgi?ADDR=P1&INDEX=8&CMD=0 [reboot] url=http://www.google.
PAGE 86
If the value is "disabled" then nothing is done when calling the shutdown command. Default: disabled reboot  url: A url to the webpage that will be called when the reboot command is sent. If the value is empty then the machine where the agent is running is rebooted. If the value is "disabled" then nothing is done when calling the reboot command. Default: disabled monitor    interval: The interval (in milliseconds) at which we monitor the status of the machine.
PAGE 87
An alarm is most commonly triggered when the value for an attribute is outside the predefined limits. The following actions can be executed when an alarm is triggered:  Add to Alarm Panel  SMTP notification (e-mail)  SNMP trap notification  Raise an internal event (for advanced users) © 2011 Racktivity NV Antwerpsesteenweg 19 - 9080 Lochristi - Belgium - www.racktivity.com 87/160 v 2014.5.
PAGE 88
Creating Alarms By default, all Component Pages (except Enterprise) will display the User Defined Alarms widget. This widget can be deleted by editing the Template for that Page. The Alarm Wizard 1. Open the Component Page for which you would like to create an Alarm 2. Navigate to the User Defined Alarms widget 3. Press the Create Alarm button 4. The first screen of the wizard enables you to select the information source, severity level and one or more actions to be executed. a.
PAGE 89
Information Sources SNMP SNMP Alarms are SNMP traps sent by connected devices to DCPM that will trigger an Alarm. The SNMP Alarm data source is only available on single device Component Pages (discovered and configured EnergySwitch, Monitoring Module, other devices etc.) and not on aggregated Component Pages (Rack, Room, Datacenter, etc.). Scope Use to set the scope of the selected Alarm. For a device this can be the whole device, a specific outlet or even an externally connected sensor.
PAGE 90
  Value: The current value of the selected parameter will be compared to the value set in the Alarm. Absolute values are used. Change: The latest value retrieved will be compared to the previous value. This comparison is performed in percentage rather than an absolute value. Condition This option describes the conditions that the Source must comply with for the Alarm to be triggered. The available options in the Condition are dependent on the selected Scope and Type.
PAGE 91
Formula Creating an alarm on formulas is only available as from DCPM version 1.4.0. Selecting the Formula will able the user to set an threshold on a calculated formula. Alarm definitions for formulas can be generated on every layer of your structure. Actions For each Alarm, one or more actions can be enabled on the first screen of the Alarm Wizard.
PAGE 92
Alarm Message (required) The Alarm Message describes the Alarm.
PAGE 93
When required, the SNMP Trap Action can be sent to up to 3 SNMP trap receivers by entering a second and/or third SNMP Host. E-mail The E-mail Action will require you to enter one or more recipient e-mail addresses. Multiple addresses can be separated by using a comma (“,”) between each address. Internal Event This option is for system integrators or when expanding the DCPM system only and requires additional code to be written manually. Contact Racktivity Support for more details.
PAGE 94
2. Scroll to the User Defined Alarms section. 3. Click the Delete button next to the desired Alarm. Note: When deleting an Alarm that was duplicated for all Components of the same type you will be prompted to delete only this Alarm or all Alarms for the same Component. Reporting As from DCPM version 1.3.5 the user is able to create his own reports. Reports can be generated through the action menu on the right side of the menu bar.
PAGE 95
Formulas on reporting can only be done for the period of the selected daily retention scheme in the settings menu. Reporting on enterprise level To create a report on enterprise level the user needs to go to the action menu on enterprise level and press “create report under the action menu. A new window will pop up asking the user to select (this is the case for versions < 1.4.
PAGE 96
When the desired items are selected the user can select the “submit” button. DCPM allows the user to select multiple items in these boxes A new window will pop up asking how to present the report and asking for a valid email address to send the report to. When entering a valid email address DCPM will sent the desired report to this email address. Sending the report to the user can take a few minutes depending on the report size.
PAGE 97
“Export to CSV” will generate a csv file with the output RAW data collected by DCPM on a five minute interval basis. Pressing “create report” provides the user again the possibility to select the following:     Data from Location or its children Metrics Time interval Report as .csv or .pdf file Pressing the submit button a new window will pop up asking how to present the report and asking for a valid email address to send the report to.
PAGE 98
Following RAW data will be presented in csv format on a five minute interval basis for the selected period:                 AC Energy (kWh) Apparent Energy (kVAh) Apparent Power (VA) Charging Energy (kWh) CO2 (g) AC current (A) DC current (A) DC Power (W) DC Energy (kWh) DC Voltage (V) Frequency (Hz) Humidity (%) AC Power (W) Power factor Temperature (C) AC Voltage (V) Reporting on datacenter Level Reporting on a datacenter level can be done by drilling down up to the datacenter level.
PAGE 99
Pressing “create report” provides the user the possibility to select the following:     Data from Location or its children Metrics Time interval Report as .csv or .pdf file Pressing the submit button a new window will pop up asking how to present the report and asking for a valid email address to send the report to. When entering a valid email address DCPM will send the desired report to this email address. Sending the report to the user can take a few minutes depending on the report size.
PAGE 100
      Frequency (Hz) Humidity (%) AC Power (W) Power factor Temperature (C) AC Voltage (V) Reporting on formulas Reporting on Formulas can be done in every layer of the structure. The formula name will be presented by DCPM when the user wants to create a report. When pressing the action button the user will have two options for creating a report.  Create Report  Export to csv. Creating a report will generate minimum, maximum and average data for the selected time frame per day.
PAGE 101
Select one of the active Alarms to see the details on the right side of the screen. The detailed information contains the following information:      Severity of the Alarm with the Alarm Message as configured in the Alarm Wizard. Location: the location where the Alarm was triggered. This can be any Component (except Enterprise). System Time: The time at which the Alarm occurred. Action Hints: The additional information configured in the Alarm Wizard. Detailed log: Request Racktivity detailed log.
PAGE 102
Alarm History The Alarm History can be accessed through the link at the bottom of the detailed information section of the Alarm Panel and contains all acknowledged Alarms. The Acknowledged alarms do have the following information  Date created: Date when the alarm did occur  Date acknowledged: Date when the alarm is acknowledged  Message: This indicated what the alarm was about.
PAGE 103
Feeds report for datacenter This is a pre-defined report containing the capacity and usage of every defined feed in the datacenter. Pressing the more button on the page will direct the user to a more detailed report. On this detailed report the user can view capacity on all main and subfeeds. This detailed report is presenting input or output data. Input data: Data collected by feed monitor Output data: Data collected by the energy consumers or energy switches.
PAGE 104
This reports presents the total energy of every defined device in DCPM. DCPM will calculate the cost if the device is connected to a pre-defined feed. Power per customer report In the power per customer report the user can present an overview on the amount of energy used by each customer. The report is using the tag customer:x to present values.
PAGE 105
Select the option edit page from the actions menu to edit the page and put information that is relevant for the user By editing the page the user can customize a full page by entering data in markup format. If a page is created the user can use html5 code to add some graphs or other available data. Free text can be added by using Markup.
PAGE 106
Add widget to a dashboard Dashboards can be extended with predefined widgets. Select the plus sign to open the widget store: Example: camera widget © 2011 Racktivity NV Antwerpsesteenweg 19 - 9080 Lochristi - Belgium - www.racktivity.com 106/160 v 2014.5.
PAGE 107
Doc space In the documentation space the user is able to get the manual of DCPM and consult this. IDE Space The IDE space is the Integrated Development Environment of DCPM. In this section the user can edit his projects or can even change the look and feel of DCPM by adding or removing data from pre-defined templates. The user needs to know html5 code in order to perform changes in DCPM. DCPM Macros DCPM is highly customizable; this is due to the fact that you can develop your own macros.
PAGE 108
JavaScript Macros JavaScript Macros, on the other hand, have to do with editing the page. These macros can have a wide range of usage, from highlighting code and showing a Google map, to adding a Wizard. The macro files themselves (JavaScript files) are stored in /opt/qbase5/www/lfw/js/macros and must have unique names. In this section you can find an overview of the available macros and how you can create your own macro.
PAGE 109
To make a REST call in a macro use the following structure: [[name_of_macro: call=appserver/rest/link/to/appserver/service]][[/name_of_macro]] for example: [[note: call=appserver/rest/ui/portal/listSpaces]][[/note]] results in: [ "View", "Admin", "Alarms", "Reports", "User", "Doc", "IDE" ] Overview of Existing Macros List of Predefined Macros                              Actions Macro Aggregated Data Macro Area Chart Macro Bar Chart Macro Button Macro CO2 Footprint Detailed
PAGE 110
                         Monitormodule Live Data Macro Multi Bar Chart Macro Multi Line Graph Macro Notification Macro Oscilloscope Macro Page Tree Macro Page Validator Macro Pdu Live Data Macro Pie Chart Macro Port Data Macro Power per Customer Detailed Report Macro Power per Customer Report Macro Protovis Macro RGraph Macro Racktivity Tree Macro Redirect Macro Schematics Macro Script Macro Sensor Data Macro Stacked Area Chart Macro Style Macro Table Macro Widget Macro Wizard Macr
PAGE 111
]} params['result'] = l def match(q, i, params, tags): return True When defining a button in a tasklet, as shown in the code above, it should contain the following parameters:      name: is the name that will appear on the button. description: is the help text that will be displayed when you hover on the button. uri: the action call; for example: "http://www.google.com" or "javascript:print();". target: specifies where to open the linked document. icon: is the icon that will be given to the button.
PAGE 112
Area Chart Macro The Area Chart Macro allows you to view certain data for a particular object (location, datacenter, pdu etc.) For instance a graph with one of the following types of data can be shown:     Voltage Power Active energy Frequency etc. Parameters This macro accepts the following parameters:       type: the type of data to be shown (power, active energy, voltage etc.) guid: object global unique identifier timespan: show data for a particular time interval.
PAGE 113
Bar Chart Macro The Bar Chart Macro allows you to view certain data for a particular object (location, datacenter, pdu etc.) For instance a bar chart with one of the following types of data can be shown:     Voltage Power Active energy Frequency etc. Parameters This macro accepts the following parameters:       type: the type of data to be shown (power, active energy, voltage etc.) guid: object global unique identifier timespan: show data for a particular time interval.
PAGE 114
Button Macro The Button macro allows you to add a button to your page which executes some javascript code.
PAGE 115
To make the icon available, you have to add a class to theme.css of your application. This file is located in /opt/qbase5/www/lfw/css. To add class add the following line, provided that the icon, emoticon_smile.png is stored in /opt/qbase5/www/lfw/img/icons: .ui-state-default . {background-image: url("")} where:   : class name that you can use for the icon parameter of your button : link to the name of the icon, relative from /opt/qbase5/www/lfw/css For example: .
PAGE 116
CO2 Footprint Report Macro This macro displays a report of CO2 emissions for one or all datacenters in relation with the reference values for the existing energy feeds. Parameters  datacenter: the datacenter global unique identifier for which the report should be generated. This is an optional parameter. If it's not specified, then the report will contain all datacenters.
PAGE 117
CPU vs. Power macro This macro displays a graph with CPU usage and power consumption for a device. Parameters CPU vs. Power macro accepts the following parameter:  deviceguid - the global unique identifier of the device for which the graph should be displayed. Example [[cpuvspower:deviceguid=dd3d4536-7fdc-4503-958f-1100a9818c88/]] Sample Camera Macro Camera Macro allows you to connect and see images from an ip camera.
PAGE 118
This macro accepts the following parameters:     ip: the IP address of the camera camtype: camera type. It can be either 'apexisptz' or 'dlink2121'. user: the username used to connect to the camera password: the password used to connect to the camera Example [[camera: ip=10.25.25.1, camtype=dlink2121, user=joe, password=pass123]][[/camera]] Sample Children Macro The children macro creates a tree-view of a certain page and all its child pages.
PAGE 119
root:Macros_Home [[/children]] Dashboard Macro The dashboard macro allows you to create a page to which you can add widgets. This way you can create a custom page with your favorite widgets. Parameters  config: the name of the config parameter can be freely chosen, but a name is mandatory.. Example [[dashboard:config=example_dasboard_config]][[/dashboard]] Sample Device Management Macro Device Management Macro allows you to manage devices as described in Creating and Configuring Devices section.
PAGE 120
     displayEnergy (true/false) - display the energy consumption for each application (optional). If not specified then true is assumed. displayCost (true/false) - display the cost for each application (optional). If not specified then true is assumed.
PAGE 121
Energy per Application Report Macro This macro allows you to view the energy consumed by applications running on one or more devices. Parameters This macro accepts the following parameter:  guid (optional) - the GUID of the device for which to make the report. If not specified then all devices will be included.
PAGE 122
Sample Energy per Customer Report Macro This macro displays a report of energy consumption for customers.
PAGE 123
Example [[reportenergyperdevicedetails/]] Sample Energy per Device Report Macro This macro displays a report of energy consumption for devices.
PAGE 124
Sample Feeds Report Macro This macro displays a report of current consumption for each feed within a particular datacenter. Parameters  guid: the datacenter global unique identifier for which the report should be generated. Example [[reportfeeds:guid=266d9653-9c8a-4496-ad3e-2f193e4a5794]][[/reportfeeds]] Sample © 2011 Racktivity NV Antwerpsesteenweg 19 - 9080 Lochristi - Belgium - www.racktivity.com 124/160 v 2014.5.
PAGE 125
Formula macro The Formula macro provides the value of the formula created under the settings menu in the formula editor. Parameters None Example [[formula:guid=$object.guid, formula=Formula name/]] Generic Macro The generic macro which renders content based on the PyLabs tags defined in the body of the macro and the context of the page. The content that this macro renders is a result of the execution of certain tasklets.
PAGE 126
Parameters  The body of the macro should be a list of space separated tags and labels as defined by the Pylabs Tag format. Example 1 The tasklet test1.py lists all the tags and labels in a page. As we have mentioned in explaining how the search functions, all the pages are created with default tags that are:   space:space_name page:page_name Where space_name is the name of the space and page_name is the name of the page.
PAGE 127
based on the options specified in "formatoptions" section. For this type of formatting there are 3 possible options:    link: specifies the key name from "data" section that contains the link for this table cell. prefix: contains a string that will be prepended for each link. suffix: contains a string that will be appended to each link. The second column has a different formatting called "wizard".
PAGE 128
"type":"button", "callback":"refresh" } } ], "columns": ["Doc Page", "Wizard Example"], "height": 235 } [[/grid]] Sample Heat Map Detailed Report Macro This displays a detailed heat map report for a particular object (i.e. room or floor).
PAGE 129
  name: Name of the page you which to include space: optional, name of the space where the page to include resides, if omitted, the current space is default. Example Assuming we want to include the page SubPage at the end of this page, we would add: [[include:name=SubPage]][[/include]] [[include:space=anotherSpace, name=SubPageOfAnotherSpace]][[/include]] JqPlot Macro The jqplot is a jQuery plugin to generate pure client-side JavaScript charts in your web pages.
PAGE 130
[[jqplot]] {"width" : 400, "height" : 400, "chart_data" : [[[1, 2],[2, 4],[3, 6],[4, 8]]], "renderer" :"$.jqplot.BarRenderer" } [[/jqplot]] Pie Chart1 [[jqplot]] {"width" : 400, "height" : 400, "chart_data" : [[[1, 2],[2, 4],[3, 6],[4, 8]]], "renderer" :"$.jqplot.PieRenderer" } [[/jqplot]] © 2011 Racktivity NV Antwerpsesteenweg 19 - 9080 Lochristi - Belgium - www.racktivity.com 130/160 v 2014.5.
PAGE 131
Block Chart [[jqplot]] {"width" : 400, "height" : 400, "chart_data" : [[[1, 2, "red"],[2, 4, "blue"],[3, 6, "blach"],[4, 8,"green"]]], "renderer" :"$.jqplot.BlockRenderer" } [[/jqplot]] Bubble Chart [[jqplot]] {"width" : 400, "height" : 400, © 2011 Racktivity NV Antwerpsesteenweg 19 - 9080 Lochristi - Belgium - www.racktivity.com 131/160 v 2014.5.
PAGE 132
"chart_data" : [[[0.6, 2.6, 12, "Ford"], [0.5, 3, 16, "GM"], [1.3, 2, 17, "VW"], [1.2, 1.2, 13, "Mini"]]], "renderer" :"$.jqplot.BubbleRenderer" } [[/jqplot]] Line Graph Macro The Linegraph Macro allows you to view certain data for a particular object (location, datacenter, pdu etc.) For instance a graph with one of the following types of data can be shown:     Voltage Power Active energy Frequency etc.
PAGE 133
Sample Map Editor Macro The Map Editor Macro allows you to create and edit maps. Parameters This macro accepts the following parameter:  name: the name of the map to be displayed This parameter is optional. If specified then the map with the given name is displayed in read-only mode, otherwise it will be in edit mode. Example [[valuemap:name=EuropeMap/]] Sample © 2011 Racktivity NV Antwerpsesteenweg 19 - 9080 Lochristi - Belgium - www.racktivity.com 133/160 v 2014.5.
PAGE 134
Map Macro Map macro displays a map on which an object (i.e. datacenter, location or enterprise) is marked. Parameters  guid: global unique identifier for the object to be displayed on the map Example [[map:guid=e0021951-fba3-4454-93d8-10f24ac1a4cb]][[/map]] Sample © 2011 Racktivity NV Antwerpsesteenweg 19 - 9080 Lochristi - Belgium - www.racktivity.com 134/160 v 2014.5.
PAGE 135
Monitormodule Live Data Macro The Monitormodule Live Data Macro allows you to view live data for a particular energy consumer or feed monitor.
PAGE 136
[[multibarchart:timespan=e-1d, guid=1609008f-1006-49f4-b599-e3eeecfdebd2, guids=5ebe9ab1-644c-4410-9cc0-871937eb792d type=activeenergy, refresh=30, label=Active Energy, resolution=900]][[/multibarchart]] Sample Multi Line Graph Macro The Multi Line Graph Macro allows you to view certain data for a particular object (location, datacenter, pdu etc.) and its children objects. For instance a line chart with one of the following types of data can be shown:     Voltage Power Active energy Frequency etc.
PAGE 137
Sample Macro Notification The notification macro is used to show a notification when the page which you are currently looking at is updated.
PAGE 138
Parameters This macro accepts the following parameters:     domain: the type of information to be displayed. It can be either time (for voltage and current sine waves) or frequency (for frequency harmonics amplitudes) pduguid: the PDU global unique identifier or powermoduleguid: the power module global unique identifier port: the port number to be analyzed, in two possible forms: port number or using powermodule id and port number(e.g.: P1.
PAGE 139
Page Tree Macro The pagetree macro shows a flexible hierarchical tree view. It queries the database page schema and then forms a recursive tree of parent-children relation. Parameters The pagetree macro can take the root parameter which indicates the root page from which the page tree must be built.
PAGE 140
The pagevalidator macro creates a table displaying the state of all links and macros (broken/valid) found in a specific pages Parameters    spaces: optional, comma separated list of all spaces that should be validated (spaces:* means all spaces) pages: optional, comma separated list of page names that has to be checked.
PAGE 141
Pie Chart Macro Pie Chart Macro allows you to view certain data for a particular object (location, datacenter, pdu etc.) and its children objects. For instance a pie chart with one of the following types of data can be shown:     Voltage Power Active energy Frequency etc. Parameters This macro accepts the following parameters:        type: the type of data to be shown (power, active energy, voltage etc.
PAGE 142
Port Data Macro The Port Data Macro allows you to view data for a particular energy switch, energy consumer, feed monitor or device with lowest level information.
PAGE 143
Power per Customer Detailed Report Macro This macro displays a detailed report of power consumption for customers. Parameters None Example [[reportPowerPerCustomerDetails]][[/reportPowerPerCustomerDetails]] Sample Power per Customer Report Macro This macro displays a report of power consumption for customers. Parameters None Example [[reportPowerPerCustomer]][[/reportPowerPerCustomer]] Sample © 2011 Racktivity NV Antwerpsesteenweg 19 - 9080 Lochristi - Belgium - www.racktivity.com 143/160 v 2014.5.
PAGE 144
Protovis Macro The protovis macro creates a zoomable line-graph where you provide the Y-values. These are automatically linked to default X-values. The values of your graphic are stored in a list. If you provide a list of lists, then you have a graphic for each list, but now displayed in one graph. This allows you to easily compare two sets of data. Parameters The macro does not use parameters. The body contains the data to generate the chart.
PAGE 145
Example 2 Example for a graphic with two data streams: [[protovis]] { "width": 330, "data" : [[1, 1.2, 1.7, 1.5, 0.7, 0.5, 0.2, -2], [-0.4, 0, 3, 1.47, 2, 0, 6, 4.5]], "protovis_id" : "protovis_div" } [[/protovis]] Sample 2 RGraph Macro The RGraph macro creates an rgraph, which is a powerful graphics visualization. The data of the graph is stored in a JSON data structure. Parameters The macro does not use parameters. The body contains the data to generate the rgraph.
PAGE 146
"name":"Root Node", "depth": 0, "children": [ { "name": "child 1", "depth": 1, "children": [ { "name": "child "depth": 2 }, { "name": "child "depth": 2 } ] }, { "name": "child 2", "depth": 1, "children": [ { "name": "child "depth": 2 }, { "name": "child "depth": 2 } ] } ] 1.1", 1.2", 2.1", 2.2", } } } [[/rgraph]] Sample Enterprise structure Macro This macro displays a tree like representation of structure of the components of the enterprise (datacenters, floors, rooms etc.
PAGE 147
Example [[enterprisestructure]][[/enterprisestructure]] Sample Redirect Macro This macro redirects the current page to another page. Parameters   page: the name of the page where the browser should be redirected space: the space where the page belongs to Overriding macro usage As macro forces page change once you successfully added it to page, you will not be able to edit page again.
PAGE 148
Script Macro The script macro allows you to include javascripts in your text. There are two ways to include javascripts:   as argument of the script macro, the argument refers to a javascript file as body of the script macro, the body is the javascript code itself Parameters  src: the path to the javascript file Instead of referring to a javascript file, you can add the javascript code to the markdown file. See the example below. Example To call the script macro: [[script]] $('#mybutton').
PAGE 149
Sensor Data Macro Sensor Data Macro allows you to show information from a specific sensor module that is connected to a specific Energy Switch.
PAGE 150
Style Macro The style macro allows you to add a specific style to your page. Instead of using the default style of your application, you can choose to apply a custom style per page. Parameters  src: location to stylesheet file Instead of referring to a stylesheet file, you can add css content to the markdown file. See the example below. Example [[style]] p.
PAGE 151
euismod eget convallis tellus sodales. Nulla nisl magna, hendrerit id iaculis vitae, tincidunt et ligula. Duis vitae leo risus, ornare semper enim. Sample This page uses the style of the first example. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Quisque eu metus in mi vulputate convallis in vitae tellus. Mauris congue blandit felis id iaculis. Integer ut sodales ante. Class aptent taciti sociosqu ad litora torquent per conubia nostra, per inceptos himenaeos. Sed vitae tempus tortor.
PAGE 152
The Widget macro allows you to add a widget to your page. In the body of the widget you put the macro that needs to be executed. By using the widget macro, one can allow to hide/show a macro on his page.
PAGE 153
Example Below you can find an example of how you can add wizards into a DCPM page: [[wizard:title=Example Wizard,domain=racktivity,name=example_wizard,type=button,callback=refresh]] [[/wizard]] It is recommended to always fill out the parameter appname and domain, but it is not required. Sample Input / output or both presentation macro DCPM allows the user to present input, output or both measurement in one single box, Following macro code needs to be added for presentation of those values.
PAGE 154
1. using PyLabs tasklets 2. using JavaScript macros Both options are explained in this section. PyLabs Tasklets Creating PyLabs macros is creating a directory in /opt/qbase5/lib/python/sitepackages/alkira/tasklets/pylabsmacro and putting one or more tasklets in it. Once you have created the directory with a tasklet, you can start using the macro by using the directory name. For example, create a directory demo in /opt/qbase5/lib/python/sitepackages/alkira/tasklets/pylabsmacro and create a tasklet in it.
PAGE 155
center: latlng, mapTypeId: google.maps.MapTypeId.ROADMAP }; $.template('plugin.googlemaps.content', '
'); var result = $.tmpl('plugin.googlemaps.content', myOptions); result.appendTo($this); var map = new google.maps.Map(document.getElementById("map_canvas"), myOptions); }; options.
PAGE 156
4. There must be a render function which takes options as a parameter. Options is an object with some parameters that we can use, such as: o o o o o o o o o o o o o o options.space: get space name. options.page: get page name. options.body: get the page contents. options.tags: get the tags of a page. options.params: get the parameters that are passed to the macro tag, for example [[note:param1=value1]]. options.
PAGE 157
7. Create a template using jQuery; jQuery.template(name, template) where: o o name: A string naming the compiled template. template: The HTML markup and/or text to be used as template. Can be a string, or an HTML element (or jQuery object wrapping an element) whose content is to be used as a template. 8. Render the specified HTML content as a template, using the specified data: jQuery.tmpl(name, [ options ]) where: o o name: A string naming the compiled template.
PAGE 158
o redone snmp alarms - speed up, early validation o added more information to user alarm definition list on pages  graphs: o new graphs - auto refresh, new look and feel, synchronization between them o annotations on graphs (alarms) o zooming graphs on y axis  hardware integration: o batteries integration on delta rectifier o battery test reports on delta rectifier o tunneling to hardware o calculated line current on apc ats (for hw that does not give data)  default tags removed from edit wizards  line
PAGE 159
[DEVDCPM-1771] - user should be able to disable scheduled reports. [DEVDCPM-1776] - Created maps cannot be deleted any more, error is generated by DCPM [DEVDCPM-1778] - create an SNMP allarm in DCPM for voltage on AC2 generates an error [DEVDCPM-1780] - Creating AC2 version 3.1.0.52 is not working as energy consumer in DCPM [DEVDCPM-1782] - replace the documentation space by a link to the online manual.... [DEVDCPM-1785] - Fileuploader.
PAGE 160
Release Notes - DCPM Development - Version Release 1.5.