{"type":"doc","content":[{"type":"layoutSection","marks":[{"type":"breakout","attrs":{"mode":"wide","width":760}}],"content":[{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"paragraph","content":[{"text":"The Perfion Web Client is a browser-based tool that enables users to manage Perfion items in a browser as an alternative to the Windows client.","type":"text"}]},{"type":"paragraph","content":[{"text":"This document explains how to install and configure the web client.","type":"text"}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":80.0},"content":[{"type":"media","attrs":{"width":828,"id":"03c32a8a-e407-4bcb-bb36-634d4ff3e61f","collection":"contentId-243466669","type":"file","height":542}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Prerequisites","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"System requirements","type":"text"}]},{"type":"paragraph","content":[{"text":"For details on system requirements for installing the Perfion Web Client application, please refer to ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://perfion.atlassian.net/wiki/spaces/PIM/pages/243466287"}},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Enable the Internet Information Server on Windows","type":"text"}]},{"type":"paragraph","content":[{"text":"Before installing the Perfion Web Client, you must enable Internet Information Server (IIS) on the Windows operating system.","type":"text"},{"type":"hardBreak"},{"text":"Please refer to the following guide on how to install ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://www.howtogeek.com/112455/how-to-install-iis-8-on-windows-8/"}},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Install Windows features for IIS","type":"text"}]},{"type":"paragraph","content":[{"text":"Open Windows features by following these steps:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open ","type":"text"},{"text":"Control Panel","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"Programs and Features","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"Turn Windows features on or off","type":"text","marks":[{"type":"strong"}]},{"text":" located on the left side of the window","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make sure to check the highlighted options:","type":"text"}]}]}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":441,"id":"bb70da26-a5a5-4ab3-bf4f-65344ee5df56","collection":"contentId-243466669","type":"file","height":466}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Installation","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Installer","type":"text"}]},{"type":"paragraph","content":[{"text":"The installer sets up all required APIs and the web client","type":"text"}]},{"type":"paragraph","content":[{"text":"You can either install a new site or upgrade an existing one. When upgrading, you can select any of your IIS sites. However, the process will fail unless the site is a Perfion Web Client installed using this installer.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":30.0},"content":[{"type":"media","attrs":{"width":496,"id":"feab80a4-6846-43cc-ac46-6850ce375efe","collection":"contentId-243466669","type":"file","height":393}}]},{"type":"mediaSingle","attrs":{"layout":"center","width":30.0},"content":[{"type":"media","attrs":{"width":497,"id":"b05768ef-85c8-4bb0-9325-6600ec951455","collection":"contentId-243466669","type":"file","height":394}}]},{"type":"paragraph","content":[{"text":"When installing a new site, you can select a different folder for the installation.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":30.0},"content":[{"type":"media","attrs":{"width":497,"id":"158c28ee-50fc-4448-8356-c13e37336ca9","collection":"contentId-243466669","type":"file","height":394}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Installation settings","type":"text"}]},{"type":"paragraph","content":[{"text":"HTTPS:","type":"text","marks":[{"type":"strong"}]},{"text":" Enable or disable HTTPS","type":"text"}]},{"type":"paragraph","content":[{"text":"HTTP(S) Port:","type":"text","marks":[{"type":"strong"}]},{"text":" The port you want the application to run on","type":"text"}]},{"type":"paragraph","content":[{"text":"Certificate:","type":"text","marks":[{"type":"strong"}]},{"text":" Certificate for HTTPS","type":"text"}]},{"type":"paragraph","content":[{"text":"Hostname:","type":"text","marks":[{"type":"strong"}]},{"text":" Hostname you want the application to run on. Leave empty for localhost","type":"text"}]},{"type":"paragraph","content":[{"text":"Secure API: ","type":"text","marks":[{"type":"strong"}]},{"text":"Enable or disable secure API","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":30.0},"content":[{"type":"media","attrs":{"width":494,"id":"11437683-bbba-4afb-8849-9c89064ace9e","collection":"contentId-243466669","type":"file","height":392}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"SQL Server:","type":"text","marks":[{"type":"strong"}]},{"text":" SQL server name (leave empty to use local data source)","type":"text"}]},{"type":"paragraph","content":[{"text":"Database name:","type":"text","marks":[{"type":"strong"}]},{"text":" Name of Perfion database (selectable from a list of databases in the connection by clicking the three-dot button and opening the dropdown menu)","type":"text"}]},{"type":"paragraph","content":[{"text":"Username:","type":"text","marks":[{"type":"strong"}]},{"text":" Username for Perfion database connection","type":"text"}]},{"type":"paragraph","content":[{"text":"Password:","type":"text","marks":[{"type":"strong"}]},{"text":" Password for Perfion database connection","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":30.0},"content":[{"type":"media","attrs":{"width":229,"id":"b6a76afb-6b8e-4e70-bde2-04b1d5ca5d05","collection":"contentId-243466669","type":"file","height":182}}]},{"type":"paragraph","content":[{"text":"Perfion User:","type":"text","marks":[{"type":"strong"}]},{"text":" Admin user for Perfion","type":"text"}]},{"type":"paragraph","content":[{"text":"Perfion Password:","type":"text","marks":[{"type":"strong"}]},{"text":" Password for user","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":30.0},"content":[{"type":"media","attrs":{"width":229,"id":"1b80e79f-72cf-4551-87bd-69e1a069be22","collection":"contentId-243466669","type":"file","height":182}}]},{"type":"mediaSingle","attrs":{"layout":"center","width":30.0},"content":[{"type":"media","attrs":{"width":229,"id":"6f37ae14-3781-433f-a431-8fad83c827cf","collection":"contentId-243466669","type":"file","height":182}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Manual installation","type":"text"}]},{"type":"paragraph","content":[{"text":"Follow these steps to install the Perfion Web Client manually:","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Download the installation zip file","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download the installation zip file from the Perfion Knowledge Base","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"MAKE SURE","type":"text","marks":[{"type":"strong"}]},{"text":" to right-click the downloaded zip file, choose Properties, and ","type":"text"},{"text":"Unblock","type":"text","marks":[{"type":"strong"}]},{"text":" it before extracting all files","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":30.0},"content":[{"type":"media","attrs":{"width":190,"id":"e9a565ea-b240-4036-806e-659b489bb92e","collection":"contentId-243466669","type":"file","height":62}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Unpack the installation zip file","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Unpack the files from the installation .zip file which contains three folders: ","type":"text"},{"text":"PerfionWebClient, PerfionAPIService, and PerfionClientAPI","type":"text","marks":[{"type":"strong"}]},{"text":". Copy these folders into the ","type":"text"},{"text":"C:\\inetpub","type":"text","marks":[{"type":"strong"}]},{"text":" directory (it may be helpful to organize them into a folder called ","type":"text"},{"text":"Perfion","type":"text","marks":[{"type":"strong"}]},{"text":").","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Create a new IIS website","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open ","type":"text"},{"text":"IIS Manager","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Right-click on ","type":"text"},{"text":"Sites","type":"text","marks":[{"type":"strong"}]},{"text":" in the ","type":"text"},{"text":"Connections","type":"text","marks":[{"type":"strong"}]},{"text":" panel and select ","type":"text"},{"text":"Add Website","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Make the following settings:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the ","type":"text"},{"text":"Site name","type":"text","marks":[{"type":"strong"}]},{"text":" to ","type":"text"},{"text":"PerfionWebClient","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the ","type":"text"},{"text":"Physical path","type":"text","marks":[{"type":"strong"}]},{"text":" to the directory where the folder ","type":"text"},{"text":"PerfionWebClient ","type":"text","marks":[{"type":"strong"}]},{"text":"is located,","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"for example: ","type":"text"},{"text":"C:\\inetpub\\Perfion\\PerfionWebClient","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set ","type":"text"},{"text":"IP address","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"Port,","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"Hostname","type":"text","marks":[{"type":"strong"}]},{"text":" to the relevant local settings","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"OK","type":"text","marks":[{"type":"strong"}]},{"text":" to create the website","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":80.0},"content":[{"type":"media","attrs":{"width":1918,"id":"fb1322d8-e453-4158-b1cf-98ed9199ea69","collection":"contentId-243466669","type":"file","height":967}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Add PerfionAPIService to the site","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":517,"id":"fb22a8b6-be99-41af-840a-8f850b6f6c07","collection":"contentId-243466669","type":"file","height":386}}]},{"type":"paragraph"},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Expand ","type":"text"},{"text":"Sites,","type":"text","marks":[{"type":"strong"}]},{"text":" right-click ","type":"text"},{"text":"PerfionWebClient,","type":"text","marks":[{"type":"strong"}]},{"text":" and chose to ","type":"text"},{"text":"Add Application","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the ","type":"text"},{"text":"Physical path","type":"text","marks":[{"type":"strong"}]},{"text":" to the directory where the folder ","type":"text"},{"text":"PerfionAPIService ","type":"text","marks":[{"type":"strong"}]},{"text":"is located,","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"for example: ","type":"text"},{"text":"C:\\inetpub\\Perfion\\PerfionAPIService","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"OK","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Add PerfionClientAPI to the site","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Expand ","type":"text"},{"text":"Sites,","type":"text","marks":[{"type":"strong"}]},{"text":" right-click ","type":"text"},{"text":"PerfionWebClient,","type":"text","marks":[{"type":"strong"}]},{"text":" and select ","type":"text"},{"text":"Add Application","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the ","type":"text"},{"text":"Physical path","type":"text","marks":[{"type":"strong"}]},{"text":" to the directory where the folder ","type":"text"},{"text":"PerfionClientAPI ","type":"text","marks":[{"type":"strong"}]},{"text":"is located,","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"for example: ","type":"text"},{"text":"C:\\inetpub\\Perfion\\PerfionClientAPI","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click ","type":"text"},{"text":"OK","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"paragraph","content":[{"text":"The Perfion Web Client has been successfully installed, and the result should now appear as follows:","type":"text"}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":211,"id":"018771c0-2756-458f-9851-61c5db67a875","collection":"contentId-243466669","type":"file","height":90}}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Create Cache folder for images and files","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to folder ","type":"text"},{"text":"C:\\inetpub","type":"text","marks":[{"type":"strong"}]},{"text":"\\","type":"text"},{"text":"PerfionWebClient\\Perfion","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a folder called ","type":"text"},{"text":"Cache","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Right-click on ","type":"text"},{"text":"Cache","type":"text","marks":[{"type":"strong"}]},{"text":" folder, and choose ","type":"text"},{"text":"Properties","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add the AppPool Group User ","type":"text"},{"text":"PerfionWebClient","type":"text","marks":[{"type":"strong"}]},{"text":" and grant full control over the folder:","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1197,"id":"b522c414-31e8-496d-b8fb-f9b547565925","collection":"contentId-243466669","type":"file","height":747}}]},{"type":"paragraph","content":[{"text":"Next, proceed to configure the Perfion Web Client.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"Follow these steps to configure the Perfion Web Client:","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"PerfionAPIService - configure database connection","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Start Windows Explorer and go to ","type":"text"},{"text":"C:\\inetpub\\Perfion\\PerfionAPIService ","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a copy - in the same folder - of ","type":"text"},{"text":"Web.config.example","type":"text","marks":[{"type":"strong"}]},{"text":" and name the copy ","type":"text"},{"text":"Web.config","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open ","type":"text"},{"text":"Web.config","type":"text","marks":[{"type":"strong"}]},{"text":" with a text editor","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Edit ","type":"text"},{"text":"PerfionConn ","type":"text","marks":[{"type":"strong"}]},{"text":"to match your Perfion database setup. Example:","type":"text"}]}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"5. Save and close the file","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"PerfionAPIService - configure authentication (SecureAPIService)","type":"text"}]},{"type":"paragraph","content":[{"text":"The Perfion API supports both authenticated and unauthenticated requests. When authentication is enabled, the API executes queries in the context of the authenticated user. If authentication is disabled, the API operates under the user account specified in the ‘PerfionConn’ connection string (see above).","type":"text"}]},{"type":"paragraph","content":[{"text":"If authentication is enabled, and the API request does not include authentication, the API will reject the request with an error. For more information about how to authenticate, please refer to ","type":"text"},{"text":"Authentication - Perfion Knowledge Base - Perfion Knowledge Base (atlassian.net)","type":"text","marks":[{"type":"link","attrs":{"href":"https://perfion.atlassian.net/wiki/spaces/PIM/pages/244330998"}}]},{"text":".","type":"text"}]},{"type":"panel","attrs":{"panelType":"warning"},"content":[{"type":"paragraph","content":[{"text":"It is strongly recommended that authentication is always enabled (‘","type":"text"},{"text":"SecureAPIService","type":"text","marks":[{"type":"em"}]},{"text":"’ set to true)","type":"text"}]}]},{"type":"paragraph","content":[{"text":"To enable authentication, set ","type":"text"},{"text":"Perfion.SecureApiService","type":"text","marks":[{"type":"em"}]},{"text":" to true in the PerfionAPIService web.config file","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\t\n \n\t\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"PerfionClientAPI - configure database connection","type":"text"}]},{"type":"paragraph","content":[{"text":"6. Now go to ","type":"text"},{"text":"C:\\inetpub\\Perfion\\PerfionClientAPI ","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"7. Create a copy - in the same folder - of ","type":"text"},{"text":"Web.config.example","type":"text","marks":[{"type":"strong"}]},{"text":" and name the copy ","type":"text"},{"text":"Web.config","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"8. Open ","type":"text"},{"text":"Web.config","type":"text","marks":[{"type":"strong"}]},{"text":" with a text editor","type":"text"}]},{"type":"paragraph","content":[{"text":"9. Edit the ","type":"text"},{"text":"ConnectionString ","type":"text","marks":[{"type":"strong"}]},{"text":"to match your Perfion database setup. Example:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n","type":"text"}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":807,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":807,"alt":"image-20240320-113030.png","id":"0110fc76-d5d9-4809-af80-cf214f850486","collection":"contentId-243466669","type":"file","height":107}}]},{"type":"orderedList","attrs":{"order":10},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Save and close the file","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"PerfionClientAPI - configure runtime settings","type":"text"}]},{"type":"paragraph","content":[{"text":"The web.config file contains certain settings that configure the IIS runtime, including the maximum allowed size of requests the server will process. If a request exceeds this size, the server will deny it and return an error. ","type":"text"}]},{"type":"paragraph","content":[{"text":"To configure the maximum request size for the PerfionClientAPI, you need to adjust two settings in the web.config file.","type":"text"},{"type":"hardBreak"},{"text":"Per default, Perfion is configured to allow a maximum request size of approximately 50MB.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"MaxRequestLength (","type":"text","marks":[{"type":"em"}]},{"text":"HttpRuntimeSection.MaxRequestLength Property (System.Web.Configuration) | Microsoft Learn","type":"text","marks":[{"type":"em"},{"type":"link","attrs":{"href":"https://learn.microsoft.com/en-us/dotnet/api/system.web.configuration.httpruntimesection.maxrequestlength?view=netframework-4.8"}}]},{"text":")","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"},{"text":"This setting configures the maximum request size supported by ASP.NET.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"MaxAllowedContentLength","type":"text","marks":[{"type":"em"}]},{"text":" (","type":"text"},{"text":"Request Limits | Microsoft Learn","type":"text","marks":[{"type":"link","attrs":{"href":"https://learn.microsoft.com/en-us/iis/configuration/system.webserver/security/requestfiltering/requestlimits/"}}]},{"text":")","type":"text"},{"type":"hardBreak"},{"text":"This setting configures the maximum request size supported by IIS.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example - MaxRequestLength","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"maxRequestLength","type":"text","marks":[{"type":"em"}]},{"text":" is set on the ","type":"text"},{"text":"httpRuntime","type":"text","marks":[{"type":"em"}]},{"text":" element within ","type":"text"},{"text":"system.web","type":"text","marks":[{"type":"em"}]},{"text":". ","type":"text"},{"type":"hardBreak"},{"text":"Please note that the value is specified in kilobytes.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":" \n \n \n \n ","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example - MaxAllowedContentLength","type":"text"}]},{"type":"paragraph","content":[{"text":"The m","type":"text"},{"text":"axAllowedContentLength","type":"text","marks":[{"type":"em"}]},{"text":" is set on the requestLimits element within ","type":"text"},{"text":"system.webServer","type":"text","marks":[{"type":"em"}]},{"text":" - ","type":"text"},{"text":"security","type":"text","marks":[{"type":"em"}]},{"text":" - ","type":"text"},{"text":"requestFiltering","type":"text","marks":[{"type":"em"}]},{"text":". ","type":"text"},{"type":"hardBreak"},{"text":"Please note that the value is specified in bytes.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":" \n \n \n \n \n \n \n ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"PerfionWebClient - update config.json","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to the ","type":"text"},{"text":"C:\\inetpub\\Perfion\\PerfionWebClient","type":"text","marks":[{"type":"strong"}]},{"text":" folder","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a copy - in the same folder - of ","type":"text"},{"text":"config.json.example","type":"text","marks":[{"type":"strong"}]},{"text":" and name the copy ","type":"text"},{"text":"config.json","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open ","type":"text"},{"text":"config.json","type":"text","marks":[{"type":"strong"}]},{"text":" with a text editor. The file looks like this:","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"{\n \"ServicesBaseUrl\" : \"/PerfionClientApi/\",\n\t\"ImageServerUrl\": \"/PerfionAPIService/Perfion/Image.aspx\",\n\t\"FileServerUrl\": \"/PerfionAPIService/Perfion/File.aspx\",\n\t\"ReportServerUrl\": \"/PerfionAPIService/Perfion/Report.ashx\"\n \"customerDefinedLogo\": \"\"\n}","type":"text"}]},{"type":"paragraph","content":[{"text":"4. The settings ","type":"text"},{"text":"ImageServerUrl","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"FileServerUrl,","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"ReportServerUrl","type":"text","marks":[{"type":"strong"}]},{"text":" point to the Perfion API installed with the Web Client. If you want the Web Client to retrieve images and files via another Perfion API, you can adjust these settings.","type":"text"}]},{"type":"paragraph","content":[{"text":"5. The setting ","type":"text"},{"text":"customerDefinedLogo","type":"text","marks":[{"type":"strong"}]},{"text":" allows you to load your company’s logo and show it in the Web Client. Copy the logo file to ","type":"text"},{"text":"C:\\inetpub\\Perfion\\PerfionWebClient\\Perfion","type":"text","marks":[{"type":"strong"}]},{"text":" and reference the file like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\"customerDefinedLogo\": \"/Perfion/filename.jpg\"","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Restart IIS website","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go back to ","type":"text"},{"text":"IIS Manager","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Click on the first item in the ","type":"text"},{"text":"Connections","type":"text","marks":[{"type":"strong"}]},{"text":" panel and in the ","type":"text"},{"text":"Actions","type":"text","marks":[{"type":"strong"}]},{"text":" panel click ","type":"text"},{"text":"Restart","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":65.0},"content":[{"type":"media","attrs":{"width":468,"id":"165f8648-40c0-4ac1-ac9f-7eb73f048ef3","collection":"contentId-243466669","type":"file","height":245}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Start the web client","type":"text"}]},{"type":"paragraph","content":[{"text":"You are now ready to start the web client.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Start your favorite browser","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to the start page:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Local installation: Go to ","type":"text"},{"text":"http://localhost:port","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"http://localhost:port/"}}]},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"(use the port which you have set up in IIS)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Server installation: Go to ","type":"text"},{"text":"http://ip-address:port","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"http://ip-address:port/PerfionWebClient"}}]},{"text":" (use the IP/domain and port which you have set up in IIS)","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Enter a valid Perfion username and password and click ","type":"text"},{"text":"login","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1188,"id":"faa9f9dd-154a-47dc-93c7-a94f57b3e5b4","collection":"contentId-243466669","type":"file","height":705}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Upgrading the Web Client","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Installer upgrade","type":"text"}]},{"type":"paragraph","content":[{"text":"Follow the ","type":"text"},{"text":"Installer","type":"text","marks":[{"type":"link","attrs":{"href":"https://perfion.atlassian.net/wiki/spaces/PIM/pages/243466669/Web+Client+-+Installation+Guide#Installer"}}]},{"text":" guide and select the instance you want to upgrade. Only instances installed using the installer can be upgraded. ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Manual upgrade","type":"text"}]},{"type":"paragraph","content":[{"text":"Upgrading the Perfion Web Client requires the following steps:","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Prepare upgrade","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download a new .zip installation file","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Unpack all files","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Stop the website in your IIS manager","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Delete old files","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"C:\\inetpub","type":"text","marks":[{"type":"strong"}]},{"text":"\\","type":"text"},{"text":"Perfion\\PerfionWebClient","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Delete all files - except config.json - in the folder ","type":"text"},{"text":"C:\\inetpub","type":"text","marks":[{"type":"strong"}]},{"text":"\\","type":"text"},{"text":"Perfion\\PerfionWebClient","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go up one level to ","type":"text"},{"text":"C:\\inetpub\\Perfion\\PerfionAPIService ","type":"text","marks":[{"type":"strong"}]},{"text":"and","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"delete the ","type":"text"},{"text":"bin","type":"text","marks":[{"type":"strong"}]},{"text":" folder with all its content","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"C:\\inetpub\\Perfion\\PerfionClientAPI ","type":"text","marks":[{"type":"strong"}]},{"text":"and delete the ","type":"text"},{"text":"bin","type":"text","marks":[{"type":"strong"}]},{"text":" folder with all its content","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Add new files","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to folder ","type":"text"},{"text":"PerfionWebClient","type":"text","marks":[{"type":"strong"}]},{"text":" in the unpacked files","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy ALL files and subfolders","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"C:\\inetpub","type":"text","marks":[{"type":"strong"}]},{"text":"\\","type":"text"},{"text":"Perfion\\PerfionWebClient\\","type":"text","marks":[{"type":"strong"}]},{"text":" and paste all copied files","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to folder ","type":"text"},{"text":"PerfionAPIService ","type":"text","marks":[{"type":"strong"}]},{"text":"in the unpacked files","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy ALL files and subfolders","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"C:\\inetpub","type":"text","marks":[{"type":"strong"}]},{"text":"\\","type":"text"},{"text":"Perfion\\PerfionAPIService\\","type":"text","marks":[{"type":"strong"}]},{"text":" and paste all copied files","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to folder ","type":"text"},{"text":"PerfionClientAPI ","type":"text","marks":[{"type":"strong"}]},{"text":"in the unpacked files","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy ALL files and subfolders","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Go to ","type":"text"},{"text":"C:\\inetpub","type":"text","marks":[{"type":"strong"}]},{"text":"\\","type":"text"},{"text":"Perfion\\PerfionClientAPI\\","type":"text","marks":[{"type":"strong"}]},{"text":" and paste all copied files","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Say YES to overwriting all existing files","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Don’t worry – your existing config files will be saved as only example-config files are included in the installation package.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"NOTICE","type":"text","marks":[{"type":"strong"}]},{"text":": With a new web client version, changes to config files might be necessary. It is therefore essential to verify whether the two ","type":"text"},{"text":"web.config.example","type":"text","marks":[{"type":"strong"}]},{"text":" files and the ","type":"text"},{"text":"config.json.example","type":"text","marks":[{"type":"strong"}]},{"text":" file contain updates compared to the currently installed configuration files.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"If in doubt, create new config files by following the instructions in the ","type":"text"},{"text":"Configuration","type":"text","marks":[{"type":"link","attrs":{"href":"https://perfion.atlassian.net/wiki/spaces/PIM/pages/243466669/Web+Client+-+Installation+Guide#Configuration"}}]},{"text":" chapter of this guide.","type":"text"}]}]}]}]}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":50.0},"content":[{"type":"media","attrs":{"width":998,"id":"ed52b969-aced-419f-b22b-c5052222ccfb","collection":"contentId-243466669","type":"file","height":612}}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Start website","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Now go to IIS Manager and start the ","type":"text"},{"text":"Perfion Web Client","type":"text","marks":[{"type":"strong"}]},{"text":" site.","type":"text"}]}]}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":65.0},"content":[{"type":"media","attrs":{"width":1918,"id":"eac3c82f-bada-4b75-8887-5545eb30e661","collection":"contentId-243466669","type":"file","height":968}}]},{"type":"paragraph","content":[{"text":"Your upgrade is complete.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"NOTE","type":"text","marks":[{"type":"strong"}]},{"text":": Ask all users to log out of the web client, reload the web client login page (CTRL+F5 in most browsers) and then log in again. This ensures that no old version is cached in their browser.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Azure Installation","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Introduction","type":"text"}]},{"type":"paragraph","content":[{"text":"This section describes how to set up Perfion services in Azure. These services include the following products.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Perfion SOAP API","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Perfion Client API","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Perfion JSON API","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Perfion Web Client","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"This “how-to” requires that you have the necessary user right in Azure to create new resources, and a valid subscription to pay for the services.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Creating resources in the Azure portal","type":"text"}]},{"type":"paragraph","content":[{"text":"In Azure, resources are fundamental components that encompass a wide array of entities. This guide will focus on the following resource types:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Resource group","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"App Service Plan","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"API App","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Web App","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Resource group","type":"text"}]},{"type":"paragraph","content":[{"text":"A resource group serves as a container for organizing related components. For instance, when setting up a Perfion Web Client, a dedicated resource group would encompass all the necessary app services required for its operation.","type":"text"}]},{"type":"paragraph","content":[{"text":"Creating a resource group is done by finding it in “create a resource” and filling in the necessary information’s. These are as follows.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Subscription: ","type":"text","marks":[{"type":"strong"}]},{"text":"Choose the appropriate payment subscription","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Resource group:","type":"text","marks":[{"type":"strong"}]},{"text":" Assign a clear and meaningful name","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Region:","type":"text","marks":[{"type":"strong"}]},{"text":" Select the region where the resource group will be created. Ensuring that all related resources are in the same region minimizes latency and improves performance.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"When everything is filled out, click “Review + Create” to create the resource.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"App Service Plan","type":"text"}]},{"type":"paragraph","content":[{"text":"The App Service Plan acts as the “hardware” of the setup, defining the SKU and size on which your app services will run.","type":"text"}]},{"type":"paragraph","content":[{"text":"Important","type":"text","marks":[{"type":"em"}]},{"text":":","type":"text","marks":[{"type":"strong"}]},{"text":" An App Service Plan is required for the app services running the APIs and website.","type":"text"}]},{"type":"paragraph","content":[{"text":"Creating an App Service Plan can be done by navigating to ","type":"text"},{"text":"\"","type":"text","marks":[{"type":"strong"}]},{"text":"Create a resource","type":"text"},{"text":"\"","type":"text","marks":[{"type":"strong"}]},{"text":" and providing the necessary details:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Subscription:","type":"text","marks":[{"type":"strong"}]},{"text":" Select the payment subscription for cost allocation.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Resource Group:","type":"text","marks":[{"type":"strong"}]},{"text":" Choose where the App Service Plan should be stored.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Name:","type":"text","marks":[{"type":"strong"}]},{"text":" Assign a clear and meaningful name.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Operating System:","type":"text","marks":[{"type":"strong"}]},{"text":" For Perfion products, only ","type":"text"},{"text":"Windows","type":"text","marks":[{"type":"strong"}]},{"text":" is supported.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Region:","type":"text","marks":[{"type":"strong"}]},{"text":" Select the same region for all related resources to minimize latency.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Pricing Tier:","type":"text","marks":[{"type":"strong"}]},{"text":" Choose the SKU and size, balancing performance and cost.","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":50.0},"content":[{"type":"media","attrs":{"width":415,"id":"4836429c-320c-4259-b823-fc55aebfc027","collection":"contentId-243466669","type":"file","height":406}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"App Service (API app)","type":"text"}]},{"type":"paragraph","content":[{"text":"This resource type is designed for hosting APIs, such as the ","type":"text"},{"text":"Perfion SOAP API","type":"text","marks":[{"type":"strong"}]},{"text":" or the ","type":"text"},{"text":"Perfion Client API","type":"text","marks":[{"type":"strong"}]},{"text":". To create one, simply search for ","type":"text"},{"text":"“API App”","type":"text","marks":[{"type":"strong"}]},{"text":" and initiate the setup.","type":"text"}]},{"type":"paragraph","content":[{"text":"When creating an API App, the following information must be provided:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"App Name:","type":"text","marks":[{"type":"strong"}]},{"text":" The unique name for the API, also used as its access URL","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Subscription:","type":"text","marks":[{"type":"strong"}]},{"text":" Select the subscription for billing purposes","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Resource Group:","type":"text","marks":[{"type":"strong"}]},{"text":" Specify where the App Service should be stored","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"App Service Plan:","type":"text","marks":[{"type":"strong"}]},{"text":" Choose the appropriate App Service Plan under which the API will run","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CORS Policy:","type":"text","marks":[{"type":"strong"}]},{"text":" Configure cross-origin access settings","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"CORS policy","type":"text"}]},{"type":"paragraph","content":[{"text":"After creation, the ","type":"text"},{"text":"CORS policy","type":"text","marks":[{"type":"strong"}]},{"text":" must be modified to ensure the API is accessible from the ","type":"text"},{"text":"Perfion Web Client","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"To do this:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Open the App Service in the Azure Portal","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Scroll down the left menu and locate API / CORS","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add a wildcard","type":"text"},{"text":" (","type":"text","marks":[{"type":"strong"}]},{"text":"*","type":"text","marks":[{"type":"code"}]},{"text":")","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"}]}]}]},{"type":"paragraph"},{"type":"mediaSingle","attrs":{"layout":"center","width":50.0},"content":[{"type":"media","attrs":{"width":328,"id":"1d805fc3-d3e1-4491-8eb0-e352c8262e78","collection":"contentId-243466669","type":"file","height":211}}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Adding APIs to the App service","type":"text"}]},{"type":"paragraph","content":[{"text":"API data can be integrated into the App Service through various methods, with ","type":"text"},{"text":"\"Zip Deploy\"","type":"text","marks":[{"type":"strong"}]},{"text":" being the most efficient and recommended approach. For further details, refer to the documentation. ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://docs.microsoft.com/en-us/azure/app-service/deploy-zip"}},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Perfion Soap/Client API","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Web.config file","type":"text"}]},{"type":"paragraph","content":[{"text":"The web.config file is required as usual and can be modified in two ways:","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Before Upload:","type":"text","marks":[{"type":"strong"}]},{"text":" Add it to the .zip file before deployment.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"After Upload:","type":"text","marks":[{"type":"strong"}]},{"text":" Edit it directly in Azure once the","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":".zip deployment is complete. This can be done by clicking the small ","type":"text"},{"text":"\"","type":"text","marks":[{"type":"strong"}]},{"text":"pen","type":"text"},{"text":"\"","type":"text","marks":[{"type":"strong"}]},{"text":" icon next to the web.config file in the Azure portal.","type":"text"}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To update the web.config file, insert the following snippet just below in the section:","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center","width":50.0},"content":[{"type":"media","attrs":{"width":432,"id":"fc9f1d6c-4af0-44e6-b102-2620fafeb7c9","collection":"contentId-243466669","type":"file","height":51}}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"In Azure -> Configuration > Path Mapping add a Virtual Path ( PerfionWebApi ) ","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":451,"id":"19d5f844-be47-4e42-8d31-f3c1e078de76","collection":"contentId-243466669","type":"file","height":67}}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":470,"id":"3f7c0ceb-7e0d-4e17-9497-c496a3a4b454","collection":"contentId-243466669","type":"file","height":139}}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":470,"id":"b3186937-5dbd-44b5-8e27-125a3712c006","collection":"contentId-243466669","type":"file","height":124}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"App service (Web app)","type":"text"}]},{"type":"paragraph","content":[{"text":"This resource type is used to host websites, such as the Perfion Web Client. To create one, simply search for “Web AppTo create one, simply search for ","type":"text"},{"text":"“Web App”","type":"text","marks":[{"type":"strong"}]},{"text":" and initiate the setup process.","type":"text"}]},{"type":"paragraph","content":[{"text":"When setting up the Web App, you will need to provide the following details:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Subscription:","type":"text","marks":[{"type":"strong"}]},{"text":" Choose the subscription that will be used for billing","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Resource Group:","type":"text","marks":[{"type":"strong"}]},{"text":" Select the resource group where the App Service will be stored","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"App Name:","type":"text","marks":[{"type":"strong"}]},{"text":" Enter a name for the website, which will also serve as the URL to access it","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Publish:","type":"text","marks":[{"type":"strong"}]},{"text":" Select ","type":"text"},{"text":"“Code”","type":"text","marks":[{"type":"strong"}]},{"text":" as the deployment method","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Runtime Stack:","type":"text","marks":[{"type":"strong"}]},{"text":" Choose ","type":"text"},{"text":"“","type":"text","marks":[{"type":"strong"}]},{"type":"inlineCard","attrs":{"url":"http://ASP.NET"}},{"text":" ","type":"text"},{"text":" v4.7”","type":"text","marks":[{"type":"strong"}]},{"text":" for the runtime","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Operating System:","type":"text","marks":[{"type":"strong"}]},{"text":" Select ","type":"text"},{"text":"“Windows”","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Region:","type":"text","marks":[{"type":"strong"}]},{"text":" Pick the region where the web app should be hosted. Ensure it aligns with the regions selected for the backend APIs to minimize latency","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"App Service Plan:","type":"text","marks":[{"type":"strong"}]},{"text":" Choose the appropriate App Service Plan under which the web app will run","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":397,"id":"a65d3e97-160d-4eb4-bb2d-1bee3d939e4e","collection":"contentId-243466669","type":"file","height":413}}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Perfion Web Client","type":"text"}]},{"type":"paragraph","content":[{"text":"Once the Web app has been created in Azure you can begin uploading the Perfion web client files to the Web app’s FTP server . ","type":"text"}]},{"type":"paragraph","content":[{"text":"The information for the FTP server can be found here: ","type":"text"},{"text":"Deployment > Deployment Center > FTPS credentials","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"From this page copy the FTPS endpoint url and the FTPS username & password. After obtaining these details, open a FTP file client and paste the information to connect to the file directory.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":50.0},"content":[{"type":"media","attrs":{"width":1077,"id":"8e37479c-39bc-4c50-bca0-c5da767bcc90","collection":"contentId-243466669","type":"file","height":752}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Once connected to the FTP file directory, navigate to the Perfion web client installation on the machine from which you will uploaded them: ","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":50.0},"content":[{"type":"media","attrs":{"width":1187,"id":"86946d39-5871-4fc4-9bf7-289b9f499f4e","collection":"contentId-243466669","type":"file","height":860}}]},{"type":"paragraph","content":[{"text":"Select upload on the web client folder which contains the following three sub-folders:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PerfionWebClient","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PerfionClientAPI","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PerfionAPIService. ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"NOTE: ","type":"text","marks":[{"type":"strong"}]},{"text":"For convenience, it is recommended to edit all example files in the installation folder beforehand, but they can also be modified after uploading. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Additionally create a “web.config” which contains the following lines: ","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n\n \n \n \n \n \n ","type":"text"}]},{"type":"paragraph","content":[{"text":"Save it and upload it into the “PerfionWebClient” folder:","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":65.0},"content":[{"type":"media","attrs":{"width":1174,"id":"862a99e2-d715-45b6-a77a-6c80f2d200fc","collection":"contentId-243466669","type":"file","height":833}}]},{"type":"paragraph","content":[{"text":"After completing these step, go back to the Azure Web app and continue configuring the application. ","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Azure virtual application configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"In Azure, navigate to ","type":"text"},{"text":"Settings > Configuration","type":"text","marks":[{"type":"strong"}]},{"text":" for the Web App you created, then go to ","type":"text"},{"text":"“Path Mappings”","type":"text","marks":[{"type":"strong"}]},{"text":" within the configuration settings.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":80.0},"content":[{"type":"media","attrs":{"width":1675,"id":"53d4dff9-c2b9-4134-a2e5-7fdccdc7c3ae","collection":"contentId-243466669","type":"file","height":628}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Start by creating a root directory for the uploaded web client, as shown in the screenshot. Follow the previous steps, which will be identical for your installation.","type":"text"}]},{"type":"paragraph","content":[{"text":"Next, create two additional application directories: one for ","type":"text"},{"text":"PerfionClientAPI","type":"text","marks":[{"type":"strong"}]},{"text":" and one for ","type":"text"},{"text":"PerfionAPIService","type":"text","marks":[{"type":"strong"}]},{"text":". When pasting the physical path for the application, remember to:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Replace the forward slash (/) with a backslash ()","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Uncheck the ","type":"text"},{"text":"“Directory”","type":"text","marks":[{"type":"strong"}]},{"text":" button","type":"text"}]}]}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":494,"id":"4d6ca78c-e0c6-473f-9c0c-79f74980a900","collection":"contentId-243466669","type":"file","height":333}}]},{"type":"paragraph","content":[{"text":"Once the applications have been created, click “Save”.","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"Then, return to the “Overview” page and click “Browse”. The web client will open in a new tab.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Config.json file","type":"text"}]},{"type":"paragraph","content":[{"text":"The config.json file is rquired as usual. It can be modified either before uploading by adding it to the .zip file or by editing it directly in Azure. To edit it in Azure, simply click the little “pen” icon next to the config.json file after the .zip deployment has finished.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":470,"id":"c82c15ad-6609-42c7-872d-fbf377ed92c2","collection":"contentId-243466669","type":"file","height":171}}]},{"type":"paragraph","content":[{"type":"hardBreak"}]},{"type":"paragraph"}]},{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"1"},"maxLevel":{"value":"3"},"outline":{"value":"false"},"type":{"value":"list"},"printable":{"value":"false"}},"macroMetadata":{"macroId":{"value":"7c2fcfec-c28e-4e69-8070-54df4fde523d"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"09a5b17e-ff6b-4324-9a90-96266a36a418"}},{"type":"paragraph","content":[{"text":"-","type":"text"}]}]}]},{"type":"paragraph"}],"version":1}

Browser not supported