Installing the Administrator site using the PowerShell script consists of the following steps:
- Creating an installation configuration file.
- Running the installation script.
Creating an installation configuration file
The installation is configured using an XML file. An example file is located in iCore Administrator\Version\WebInstallConfig.xml, (typically located in “C:\Program Files (x86)"). An annotated XML Schema describing the configuration files can be found in iCore Administrator\Version\WebInstallConfig.xsd.
Create a copy of the configuration file and open it for editing.
Among the example configurations, identify the one that best matches your requirements. For more information, refer to the installation configuration file.
(Optional): Modify the attributes in the configuration file. For example, set Authentication type to Windows/Forms/OpenIdConnect, or set a Binding Port to a desired port number.
Save and close the file.
Running the installation script
Before you run the installation script, create the configuration file as described above.
Start Windows PowerShell (64-bit version), with administrative privileges (right-click and select "Run as administrator").
- You will receive an error message if you attempt to run the installation script in any other version of PowerShell.
- Make sure to use the Windows Powershell console and not another host (for example PowerShell ISE) as it may not support all functionality.
For each Administrator site or application (that you want to install on the local machine), do the following:
- Run the PowerShell script iCore
Administrator\Version\Install-iCoreWebAdmin.ps1 with the
- SiteName – the name of the site configured in the configuration file.
- ApplicationName (only applicable if installing a web application as opposed to a web site) – the name of the application to install, as configured in the configuration file.
- ConfigurationFile – the path to the configuration file created in the previous step.
- Run the PowerShell script iCore Administrator\Version\Install-iCoreWebAdmin.ps1 with the following parameters:
Running the installation script (examples)
Installing the Administrator as a website:
& .\Install-iCoreWebAdmin.ps1 –SiteName "My iCore Site" –ConfigurationFile "WebInstallConfig.xml"
Installing the Administrator as a web application in a default website:
& .\Install-iCoreWebAdmin.ps1 –SiteName "My iCore Site" –ApplicationName "iCore Administrator" –ConfigurationFile "WebInstallConfig.xml"