Began work on doc for migrating from v1 to v2, new features in v2 overview guide, #1571

conf/sample.ini

@@ -33,11 +33,38 @@ ssl_mode = disable
 ; For "sqlite3" only
 path = /opt/grafana/data/grafana.db
 
+[security]
+; default admin user, created on startup
+admin_user = admin
+; default admin password, can be changed before first start of grafana,  or in profile settings
+admin_password = admin
+; used for signing
+secret_key = SW2YcwTIb9zpOOhoPsMm
+; Auto-login remember days
+login_remember_days = 7
+cookie_username = grafana_user
+cookie_remember_name = grafana_remember
+
+[users]
+; disable user signup / registration
+allow_sign_up = true
+; Allow non admin users to create organizations
+allow_org_create = true
+# Set to true to automatically assign new users to the default organization (id 1)
+auto_assign_org = true
+; Default role new users will be automatically assigned (if disabled above is set to true)
+auto_assign_org_role = Viewer
+
+[auth.anonymous]
+; enable anonymous access
+enabled = false
+; specify organization name that should be used for unauthenticated users
+org_name = Main org.
+; specify role for unauthenticated users
+org_role = Viewer
+
 [log]
 level = Trace
 mode = console, file
 root_path = /var/log/grafana
 
-
-
-

docs/mkdocs.yml

@@ -31,8 +31,10 @@ pages:
 - ['installation/provisioning.md', 'Installation', 'Provisioning']
 - ['installation/performance.md', 'Installation', 'Performance tips']
 - ['installation/troubleshooting.md', 'Installation', 'Troubleshooting']
+- ['installation/migrating_to2.md', 'Installation', 'Migrating from v1.x to v2.x']
 
 - ['guides/gettingstarted.md', 'User Guides', 'Getting started']
+- ['guides/changes_in_v2.md', 'User Guides', 'Changes and New Features in v2.0']
 - ['guides/screencasts.md', 'User Guides', 'Screencasts']
 
 - ['reference/graph.md', 'Reference', 'Graph options']

docs/sources/guides/changes_in_v2.md

@@ -0,0 +1,120 @@
+---
+page_title: Changes and new features in Grafana v2.0
+page_description: Changes and new features in Grafana v2.0
+page_keywords: grafana, changes, features, documentation
+---
+
+# Changes and new features in v2.0
+
+This is a guide that descriptes some of changes and new features that can be found in Grafana v2.0.
+
+
+## New dashboard top header
+
+<img class="no-shadow" src="/img/v2/v2_top_nav_annotated.png">
+
+1. Side menu toggle
+2. Dashboard search (also includes access to New dashboard, Import & Playlist)
+3. Dashboard title
+4. Star/unstar current dashboard
+5. Share current dashboard (Make sure the dashboard is saved before)
+6. Save current dashboard
+7. Settings dropdown
+  - Dashboard settings
+  - Annotations
+  - Templating
+  - Export (exports current dashboard to json file)
+  - View JSON (view current dashboard json model)
+  - Save As... (Copy & Save current dashboard under a new name)
+  - Delete dashboard
+
+> **Note** In Grafana v2.0 when you change the title of a dashboard and then save it it will no
+> longer create a new dashboard. It will just change the name for the current dashboard.
+> To change name and create a new dashboard use the `Save As...` menu option
+
+## Panel time overrides & timeshift
+
+In Grafana v2.x you can now override the relative time range for individual panels. You can also add a
+time shift to individual panels. This allows you to show metrics from different time periods or days
+at the same time.
+
+![](/img/v2/panel_time_override.jpg)
+
+You control these overrides in panel editor mode and the new tab `Time Range`.
+
+![](/img/v2/time_range_tab.jpg)
+
+Currently you can only override the dashboard time with relative time ranges, not absolute time ranges. When
+you zoom or change the dashboard time to a custom absolute time range the panel overrides will be disabled. The
+panel relative time override is only active when the dashboard time is also relative. The panel timeshift override
+however is always active, even when the dashboard time is absolute.
+
+The `Hide time override info` option allows you to hide the the override info text that is by default shown in the
+upper right of a panel when overriden time range options.
+
+## New search view & starring dashboards
+
+![](/img/v2/dashboard_search.jpg)
+
+The dashboard search view has received a big UI update and polish. You can now see and filter by which dashboard
+you have personally starred.
+
+## Dashlist panel
+
+![](/img/v2/dashlist_starred.png)
+
+There is one new panel in Grafana v2.0 and that is the `dashlist` panel that allows you to show your personal
+starred dashboards as well as do custom searches based on search strings or tags.
+
+## Data Source proxy & admin views
+
+Data sources in Grafana v2.0 are NOT defined in a config file but added through the UI. The backend can also
+handle proxying data source metric requests which meens that it is a lot easier to get started using Grafana with
+Graphite or OpenTSDB without having to spend time with nginx CORS (Cross origin resource sharing) work arounds.
+
+> **Note** For InfluxDB users: The data source proxy feature will
+> hide database user & password details from the frontend / browser.
+
+## Relative time now delay
+
+A problem that has plagued many is the fact that graphs tend to dip to zero by the end because metrics for
+the last interval has yet to be received by the time series database. You can now work around this by adding
+a now delay in `Dashboard Settings` > `Time Picker` tab.
+
+![](/img/v2/timepicker_now_delay.jpg)
+
+## Overwrite protection
+
+Grafana v2.0 will protect you and your other Grafana users from accidentally overwriting each others changes
+to the same dashboard. The same protection also applies if you try to create a new dashboard with a
+name that already exists.
+
+![](/img/v2/overwrite_protection.jpg)
+
+## User preferences
+
+If you open side menu (by clicking on the Grafana icon in the top header) you can access your profile page.
+Here you can update your user details, UI Theme and change password.
+
+## PNG rendering
+
+In the panel share dialog you now have access to a link that will render the panel to a PNG image.
+The panel is rendered on the backend via phantomjs (headless browser). This requires that you metric
+data source is accessable from your Grafana server host machine.
+
+![](/img/v2/share_dialog_image_highlight.jpg)
+
+## User & Organization permissions
+
+All dashboards and data sources are linked to an organization (not to a user). Users are linked to
+Organizations via a role. That role can be:
+
+- `Viewer`: Can only view dashboards, not save / create them.
+- `Editor`: Can view, update and create dashboards.
+- `Admin`: Everything an Editor can plus edit and add data sources and organization users.
+
+> **Note** A `Viewer` can still view all metrics exposed through a data source, not only
+> the metrics used in already existing dashboards. That is because there are not
+> per series permissions in Graphite, InfluxDB or OpenTSDB.
+
+There are currently no permissions on individual dashboards.

docs/sources/installation/migrating_to2.md

@@ -0,0 +1,42 @@
+---
+page_title: Migrating from v1.x to 2.x
+page_description: Migration guide for Grafana v1.x to v2.x
+page_keywords: grafana, installation, migration, documentation
+---
+
+# Migrating from v1.x to v2.x
+
+Grafana 2.x is pretty different from v1.x in that Grafana 2.x has its own backend and its own
+database to store dashboards and users in.
+
+## Import dashboards
+
+### From Elasticsearch
+Start by going to the `Data Sources` view and add your elasticsearch datasource. Specify the elasticsearch
+index name where your Grafana v1.x dashboards are stored, default is `grafana-dash`.
+
+![](/img/v2/datasource_edit_elastic.jpg)
+
+
+### From InfluxDB
+
+Start by going to the `Data Sources` view and add your influxdb datasource. Specify the database
+name where your Grafana v1.x dashboards are stored, default is `grafana`.
+
+
+### Go to Import dashboards view
+
+Go to the `Dashboards` view and click on the dashboards search dropdown. At the bottom of the search dropdown
+you find the `Import` button.
+
+![](/img/v2/dashboard_import.jpg)
+
+
+### Import view
+
+In the Import view you find the section `Migrate dashboards`. Pick the datasource you added (Elasticsearch or InfluxDB)
+and click the `Import` button.
+
+![](/img/v2/migrate_dashboards.jpg)
+
+

src/app/features/org/partials/datasourceEdit.html

@@ -42,6 +42,7 @@
 				<div class="clearfix"></div>
 			</div>
 
+			<br>
 			<h5>Http settings</h5>
 			<div class="tight-form">
 				<ul class="tight-form-list">
@@ -60,7 +61,7 @@
 				</ul>
 				<div class="clearfix"></div>
 			</div>
-			<div class="tight-form">
+			<div class="tight-form last">
 				<ul class="tight-form-list">
 					<li class="tight-form-item" style="width: 80px">
 						Basic Auth
@@ -86,6 +87,7 @@
 				<div class="clearfix"></div>
 			</div>
 
+			<br>
 			<div ng-include="datasourceMeta.partials.config" ng-if="datasourceMeta.partials.config"></div>
 			<br>
 			<div class="pull-right">