Publishing to ADVIZOR Server
Last updated
Last updated
Deploying via ADVIZOR Server requires ADVIZOR Analyst for authoring and the separate ADVIZOR Server product as the server for other users. ADVIZOR Server is a Microsoft .Net application which requires a server running Microsoft Internet Information Services (IIS) as the web server and Microsoft .Net as the software platform.
An ADVIZOR project accessed via the web is often called a "dashboard".
A dashboard supported by ADVIZOR Server is accessed via the URL "http://<YourServername/>adv", where "YourServername" is your web server.
ADVIZOR Server is installed typically on a separate server; by default it installs in "c:\Program Files\ADVIZOR Server AE". The subdirectories here are:
AsiScripts: Contains style sheets and ".htc" files that provide the mouse interaction at the browser. You may define your own style sheets to customize the look of your published project.
Bin: Contains the server application executable.
Images: Images used for toolbar buttons in the web dashboard.
Integration: you may write a Microsoft .Net .aspx page that provides custom actions; this is included here.
Projects: Dashboards are stored here, named "project file + .aspx". You can organize these into subfolders and specify access rights at the dashboard, subfolder, and/or portal level.
Templates: HTML files for defining custom templates to publish dashboards into. These provide a custom frame for your dashboard that includes your logo and other identifying graphics.
Your ADVIZOR project file (".adv" or ".advm") is the source for your dashboards. Tabs in your project become pages in your dashboard. These pages can be combined in various ways to create a number of dashboards, for example targeted to different Business Units or people with different roles. So a single project may be used to publish multiple dashboards by choosing which pages/tabs are included in each. Pages will appear in your dashboard in the same order that the tabs appear in your project.
Steps for publishing a dashboard are:
Use the "Publish Dashboard" item in the Task View or the "Files" menu bar item. This launches the "Publish Dashboard" dialog.
"Server Address" is the URL for your server; Note that this must include the "adv" subdirectory!
In the "Pages" pane, check the pages from the project to include in the dashboard.
Give the dashboard a name in "Dashboard Name".
Choose options:
"Allow Project Export": check to allow the end user to download the project file to their PC for offline analysis. This feature requires the user to install ADVIZOR Desktop Navigator locally.
"Allow Data Export": check to allow the end user to export data to their client machine.
"Embed Data": Check if you want the current snapshot of your data embedded in the project, so that this will be shown to users of the dashboard. Otherwise, the data source will be accessed when the dashboard is accessed.
"Advanced Options": these options let you provide advanced features, but also require you to add files to your server installation supporting these actions.
"Publish using server template": Check to then pick a custom template to publish into.
"Data Integration": Check to include a button on the dashboard which you will program the response to. This is typically used to pass data to another server or tool.
Choose "Next>" to go to the next step in the wizard, which lets you choose the subfolder in the ADVIZOR Server installation directory to publish into. You must previously create any subdirectories on the server for them to appear here.
If "security policies" are defined, you will be prompted for possible use of a security policy with this dashboard; see for details:
Press "Finish" to complete publishing.
A dialog will appear giving the URL that the dashboard was published to. Use this URL to access the dashboard in the future.
A template is an HTML file that "surrounds" your dashboard. This HTML file lets you give your own look and feel to the dashboards that you publish. A template will be used if you check the "Publish using server template" check box on the "Publish Dashboard" wizard. During the publishing process, this will lead you to this wizard page which gives the list of templates available on your server; these are files stored in the "Templates" subdirectory in your server installation.
You must have previously placed these template files there!
The default template is available in the "Templates" subdirectory, and looks like this:
The dashboard contents is substituted into this page at the "BEGIN" and "END" HTML comments.
You can modify the color of the tabs in the ADVIZOR dashboard by modifying the style sheet "style2.css" and changing the template to access the modified style sheet, for example:
<link rel="stylesheet" type+"text/css" href="../../ASIScripts/MyVersionOfStyle2.css"/>
ADVIZOR Server is a Microsoft .Net application, and so requires a Microsoft Windows server, the Microsoft .Net platform, and Microsoft Internet Information Server (IIS).
The Internet is optimized for short, stateless operations. ADVIZOR Server maintains a large amount of state for a session so that you can continually interact with your data. ADVIZOR Server loads all of your data into the memory of the web server when you start a project. This memory must remain in memory until that session terminates.
For a large volume of data, the time to load it into memory can be substantial. This will be seen by the user as a delay when accessing the dashboard initially. The web server also imposes limit on how long a handler can take to respond to a web request. The initial data load time for large datasets may exceed this limit. In this case, increase the timeout so that the web server does not prematurely terminate the ADVIZOR Server.
Hint: To increase the timeout for ADVIZOR Server, add a line to "ADVIZOR Server AE\web.config", somewhere within the <system.web> node:
<httpRuntime executionTimeout="1200" maxRequestLength="4096" useFullyQualifiedRedirectUrl="false" minFreeThreads="8" minLocalRequestFreeThreads="4" appRequestQueueLimit="100" />
This would change the data load timeout to 20 minutes instead of the default 30 seconds.
To try to minimize the memory impact from multiple sessions, ADVIZOR Server will share this loaded data between multiple web sessions that are accessing the same Data Source. Each session will have a small amount of memory to maintain its own state (e.g., coloring, selection, font selections, etc.), but the static loaded memory is saved. So even for a large volume of data, the first session will incur the cost of loading the data, but subsequent sessions will start very quickly as they find the data already loaded into memory.
Sessions remain in server memory until they are terminated by the web server. This happens by default after the session is inactive for 20 minutes; this timeout interval can be set via the web server. If multiple sessions share the same data, only the data specific to them is released when that session expires. The large bulk of data will not be released until the last session expries.