Merge pull request #3 from alexandrov-nikita/master

.

Author: evshvarov

README.md

@@ -1,4 +1,63 @@
 deepsee-sysmon-dashboard
 ==============
 
-A small set od DeepSee dashboards for selected system monitor metrics - data collected by %SYSMONMGR utility
+A small set od DeepSee dashboards for selected system monitor metrics - data collected by %SYSMONMGR utility.
+
+
+Installation
+------------
+
+
+1. Download Installer.cls.xml (from cls/kutac/monitor/utils folder in repository or releases page) into Caché manager directory.
+2. Run in terminal (any namespace) under user with %All role: 
+
+        do ##class(%Installer.Installer).InstallFromCommandLine(##class(%File).ManagerDirectory()_"Installer.cls.xml","Namespace={Namespace}")
+        
+    where:
+  
+        {Namespace} is a namespace you want to install to. If it does not exist it would be created automatically. If it does exist only kutac package would be overwritten. If {Namespace} is not defined, then SYSMON namespace will be created. 
+    On this step installer would create (if needed) Namespace and corresponding database, download source code from GitHub and compile it, create required web application (named /cls/{Namespace}) if one does not exist (skipping web application creation process if one does exist), and map kutac package to %All namespace (which will be created if it does not exist).
+        
+        
+Installation without fs access to server
+-----------
+1. Download Installer.cls.xml (from MDX2JSON folder in repository or releases page) into Caché Studio (any namespace)
+2. Run in terminal (any namespace) under user with %All role: 
+
+        set pVars("Namespace")="{Namespace}"
+        do ##class(MDX2JSON.Installer).setup(.pVars)
+
+    where: 
+    
+        {Namespace} is a namespace you want to install to. If it does not exist it would be created automatically. If it does exist only kutac package would be overwritten. If {Namespace} is not defined, then SYSMON namespace will be created. 
+    On this step installer would create (if needed) Namespace and corresponding database, download source code from GitHub and compile it, create required web application (named /cls/{Namespace}) if one does not exist (skipping web application creation process if one does exist), and map kutac package to %All namespace (which will be created if it does not exist).
+    
+Offline Installation
+-----------------
+
+1. Download zip and unpack it.
+2. Run in terminal (any namespace) under user with %All role:
+
+        do ##class(%Installer.Installer).InstallFromCommandLine("{SourceDir}cls\kutac\monitor\utils\Installer.cls.xml","Namespace={Namespace},SourceDir={SourceDir}")
+
+On this step installer would create (if needed) Namespace and corresponding database, import source code and compile it, create required web application (named /cls/{Namespace}) if one does not exist (skipping web application creation process if one does exist), and map kutac package to %All namespace (which will be created if it does not exist).
+
+Default Settings
+----------------
+
+After mapping kutac package to %All namespace, namespaces %SYS and {Namespace} will be defined as startup namespaces for monitor. Then, the installer activates in the namespace %SYS" following monitor classes:
+
+* %Monitor.System.HistoryPerf
+* %Monitor.System.Diskspace
+* %Monitor.System.License
+* %Monitor.System.Processes
+* %Monitor.System.HistorySys
+* %Monitor.System.Freespace
+* %Monitor.System.LockTable
+* %Monitor.System.Routines
+
+The next step is starting monitor. Your namespace will appear in the list of accessible namespaces for DeepSee and you can see different dashboards there. However, if you open User Portal in the DeepSee immediately after installing, you will notice that all dashboards will be empty. You need to wait a little time, because the installer runs the task for rebuilding cubes in 1 minute after installing. This task will run every 3 hours for updating information for monitor dashboards.
+
+
+
+

cls/kutac/monitor/utils/Installer.cls.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<Export generator="Cache" version="25" zv="Cache for Windows (x86-32) 2015.1 (Build 429U)" ts="2015-07-23 18:15:29">
+<Export generator="Cache" version="25" zv="Cache for Windows (x86-32) 2015.1 (Build 429U)" ts="2015-07-24 13:06:58">
 <Class name="cls.kutac.monitor.utils.Installer">
-<TimeChanged>63756,59616.718811</TimeChanged>
+<TimeChanged>63757,47200.76574</TimeChanged>
 <TimeCreated>63732,50627.865496</TimeCreated>
 
 <XData name="Install">
@@ -114,7 +114,6 @@ do ##class(kutac.monitor.utils.Installer).setup(.pVars)</Description>
 <Implementation><![CDATA[
 	Set namespace = $Namespace
  	Set SSLConfig = "GitHub"
- 	
  	Zn "%SYS"
  	Do:'##class(Security.SSLConfigs).Exists(SSLConfig) ##class(Security.SSLConfigs).Create(SSLConfig)
 
@@ -227,10 +226,12 @@ do ##class(kutac.monitor.utils.Installer).setup(.pVars)</Description>
 	write !, "Starting Monitor"
 	set st3 = ..RunningMonitor()
 	write !, "Creating Task"
+	Do tInstaller.PopNS()
+	Do tInstaller.PushNS(Namespace)
 	set st4 = ..CreateTask()
+	Do tInstaller.PopNS()
 	set st = $$$ADDSC(st4, $$$ADDSC(st1, $$$ADDSC(st2, st3)))
 	if $$$ISERR(st) Throw ##class(%Installer.Exception).CreateFromStatus(st)
-	Do tInstaller.PopNS()
     quit $$$OK
 ]]></Implementation>
 </Method>
@@ -312,9 +313,11 @@ do ##class(kutac.monitor.utils.Installer).setup(.pVars)</Description>
 
 <Method name="CreateTask">
 <ClassMethod>1</ClassMethod>
-<FormalSpec>min:%Integer=180</FormalSpec>
+<FormalSpec>hrs:%Integer=3</FormalSpec>
 <ReturnType>%Status</ReturnType>
-<Implementation><![CDATA[	q ##class(%DeepSee.CubeManager.Task.Synch).Schedule(0, 1, 1, min, $p($H,",",2) + 60, 0)
+<Implementation><![CDATA[
+	
+	q ##class(%DeepSee.CubeManager.Task.Synch).Schedule(0, 1, 1, hrs, ($p($H, ",", 2) + 60) # 10800, 0)
 ]]></Implementation>
 </Method>
 </Class>