TelligentLocalInstance.ps1
|
Set-StrictMode -Version 2 function Get-Configuration { $base = $env:TelligentInstanceManager if (!$base) { Write-Error 'TelligentInstanceManager environmental variable not defined' } $data = @{ #SQL Server to use. SqlServer = if($env:TelligentDatabaseServerInstance) { $env:TelligentDatabaseServerInstance } else { '(local)' } #Default password to use for new communities AdminPassword = 'password' # The directory where licenses can be found. # Licenses in this directory should be named in the format "Community{MajorVersion}.xml" # i.e. Community7.xml for a Community 7.x license LicensesPath = Join-Path $base Licenses | Resolve-Path # The directory where web folders are created for each website WebBase = Join-Path $base Web # The directory where web folders are created for each website JobSchedulerBase = Join-Path $base JobScheduler #Solr Url for solr cores. #{0} gets replaced with 1-4 or 3-6 depending on the solr version needed SolrUrl = "http://${env:COMPUTERNAME}:8080/{0}" # Solr core Directories. # {0} gets replaced in the same way as for SolrUrl SolrCoreBase = Join-Path $base 'Solr\{0}\' } $data } function Get-TelligentInstance { <# .SYNOPSIS Gets TelligentInstance instances .PARAMETER Name The name of the instance to remove .PARAMETER Force Forces removal of the named instance, even if the named instance cannot be found. .EXAMPLE Get-TelligentInstance Gets all TelligentInstance instances .EXAMPLE Get-TelligentInstance test123 Gets the TelligentInstance instance named 'test123' .EXAMPLE Get-TelligentInstance ps* Gets all TelligentInstance instances whose names match the pattern 'ps*' #> param( [Parameter(ValueFromPipeline=$true, ValueFromPipelineByPropertyName=$true)] [string]$Name, [string]$Version ) $data = Get-Configuration $results = Get-ChildItem $data.WebBase | select -ExpandProperty FullName | Get-TelligentCommunity -EA SilentlyContinue if ($Name) { $results = $results |? Name -like $Name } if ($Version) { $versionPattern = "$($Version.TrimEnd('*'))*" $results = $results | ? {$_.PlatformVersion.ToString() -like $versionPattern } | select } $results } function Install-TelligentInstance { <# .Synopsis Sets up a new Telligent Community for development purposes. .Description The Install-TelligentInstance cmdlet automates the process of creating a new Telligent Community instance. It takes the installation package, and from it deploys the website to IIS and a creates a new database using the scripts from the package. It also sets permissions automatically. This scripts install the new community as follows (where NAME is the value of the name paramater). .Parameter Name The name of the community to create. This is used when creating the locations used by the community. * Web Files - %TelligentInstanceManager%\Web\NAME\ * Database Server - (local) * Database name NAME * Solr Url - http://localhost:8080/3-6/NAME/ (or 1-4 for versions using solr 1.4) * Solr Core - %TelligentInstanceManager%\Solr\3-6\NAME\ (or 1-4 for versions using solr 1.4) * Url - http://NAME.local/ (entry automatically added to hosts file) * Jobs run in web process * Custom Errors disabled .Parameter Version The community version being installed. .Parameter BasePackage The path to the zip package containing the Telligent Community installation files, provided by Telligent Support. .Parameter HotfixPackage If specified applys the hotfix from the referenced zip file to the community. .Parameter WindowsAuth Specify this switch to use Windows Authentication for the community. .Parameter NoDatabase Specify this switch to not set up a new database. .Parameter DatabaseServerInstance Specify the SQL DB Instance name to install the site. .Parameter ApiKey If specified, a REST Api Key is created for the admin user with the given value. This is useful for automation scenarios where you want to go and automate creation of content after installation. .Example Get-TelligentVersion 7.6 | Install-TelligentInstance TestSite Output can be piped from Get-TelligentVersion to automatically fill in the version, basePackage and hotfixPackage paramaters #> [CmdletBinding()] param( [Parameter(Mandatory=$true)] [ValidateNotNullOrEmpty()] [ValidatePattern('^[a-z0-9\-\._]+$')] [ValidateScript({if(Get-TelligentInstance $_){ throw "Telligent Instance '$_' already exists" } else { $true }})] [string] $Name, [Parameter(Mandatory=$true, ValueFromPipelineByPropertyName=$true)] [ValidateNotNullOrEmpty()] [version] $Version, [Parameter(Mandatory=$true, ValueFromPipelineByPropertyName=$true)] [ValidateNotNullOrEmpty()] [ValidateScript({Test-Zip $_ })] [string] $BasePackage, [Parameter(ValueFromPipelineByPropertyName=$true)] [ValidateScript({!$_ -or (Test-Zip $_) })] [string] $HotfixPackage, [switch] $WindowsAuth, [switch] $NoDatabase, [string] $DatabaseServerInstance, [ValidatePattern('^[a-z0-9\-\._ ]+$')] [string] $ApiKey ) $data = Get-Configuration $name = $name.ToLower() $solrVersion = Get-CommunitySolrVersion $Version $webDir = Join-Path $data.WebBase $Name $jsDir = Join-Path $data.JobSchedulerBase $Name $filestorageDir = Join-Path $webDir filestorage $domain = if($Name.Contains('.')) { $Name } else { "$Name.local"} $DatabaseServerInstance = if($DatabaseServerInstance) { $DatabaseServerInstance } else { $data.SqlServer } $licensePath = join-path $data.LicensesPath "Community$($Version.Major).xml" if(!(Test-Path $licensePath)) { $licensePath = $null } # To avoid ambiguity between the enviornment specificl Install-TelligentCommunity and # the generic base, the base function is private, so have to pull it out via a bit # of module hackery $module = Get-Module TelligentInstall $installCommunityFunc = $module.Invoke({Get-Command Install-TelligentCommunity}) $info = & $installCommunityFunc ` -Name $Name ` -Package $BasePackage ` -Hotfix $HotfixPackage ` -WebsitePath $webDir ` -JobSchedulerPath $jsDir ` -FilestoragePath $filestorageDir ` -WebDomain $domain ` -License $licensePath ` -SolrCore ` -SolrBaseUrl ($data.SolrUrl -f $solrVersion).TrimEnd('/') ` -SolrCoreDir ($data.SolrCoreBase -f $solrVersion) ` -AdminPassword $data.AdminPassword ` -NoDatabase:$NoDatabase ` -DatabaseServer $DatabaseServerInstance ` -ApiKey $ApiKey if ($info) { Disable-CustomErrors $webDir $dbUsername = Get-IISAppPoolIdentity $Name Invoke-TelligentSqlCmd -WebsitePath $webDir -Query "EXEC sp_addrolemember N'db_owner', N'$dbUsername'" if($info.PlatformVersion -ge 5.6 -and $info.PlatformVersion.Major -lt 8){ Register-TelligentTasksInWebProcess $webDir $basePackage } if ($WindowsAuth) { Enable-TelligentWindowsAuth $webDir -EmailDomain '@tempuri.org' -ProfileRefreshInterval 0 } #Add site to hosts files Add-Content -value "`r`n127.0.0.1 $domain" -Path (join-path $env:SystemRoot system32\drivers\etc\hosts) $info | Add-Member Url "http://$domain/" -PassThru if([Environment]::UserInteractive) { Start-Process $info.Url } } } function Get-CommunitySolrVersion { <# .SYNOPSIS Gets the Solr version for a given community version numeber .PARAMETER Version The community version .EXAMPLE Get-CommunitySolrVersion 9.0 #> [CmdletBinding()] param( [Parameter(Mandatory=$true, ValueFromPipeline=$true, ValueFromPipelineByPropertyName=$true)] [ValidateNotNullOrEmpty()] [Version]$Version ) if($Version.Major -ge 9) { '4-10-3' } elseif($Version.Major -ge 8) { '4-5-1' } else { '3-6' } } function Remove-TelligentInstance { <# .SYNOPSIS Removes a TelligentInstance Instance .PARAMETER Name The name of the instance to remove .PARAMETER Force Forces removal of the named instance, even if the named instance cannot be found. .EXAMPLE Remove-TelligentInstance test1, test2 Removes the 'test1' and 'test2' TelligentInstance Instances .EXAMPLE Get-TelligentInstance | Remove-TelligentInstance Removes all TelligentInstance instances .EXAMPLE Remove-TelligentInstance FailedInstall -Force Removes the 'FailedInstall' TelligentInstance instance if it's corrupted to the point it's not dete #> [CmdletBinding(SupportsShouldProcess=$true, ConfirmImpact='High')] param( [Parameter(Mandatory=$true, ValueFromPipeline=$true, ValueFromPipelineByPropertyName=$true)] [ValidatePattern('^[a-z0-9\-\._]+$')] [ValidateNotNullOrEmpty()] [string]$Name, [switch]$Force ) process { $data = Get-Configuration $webDir = Join-Path $data.WebBase $Name $info = Get-TelligentCommunity $webDir -ErrorAction SilentlyContinue if(!($info -or $Force)) { return } if($Force -or $PSCmdlet.ShouldProcess($Name)) { $domain = if($Name.Contains('.')) { $Name } else { "$Name.local"} #Delete the JS Write-Progress 'Uninstalling Telligent Community' $Name -CurrentOperation 'Removing Job Scheduler' $jsDir = Join-Path $data.JobschedulerBase $Name if (Test-Path $jsDir -PathType Container) { Get-Process |? Path -like "$jsDir*" | Stop-Process Remove-Item $jsDir -Recurse -Force } #Delete the site in IIS Write-Progress 'Uninstalling Telligent Community' $Name -CurrentOperation 'Removing Website from IIS' if(Get-Website -Name $Name -ErrorAction SilentlyContinue) { Remove-Website -Name $Name } if((Join-Path IIS:\AppPools\ $Name| Test-Path)){ Remove-WebAppPool -Name $Name } #Delete the DB Write-Progress 'Uninstalling Telligent Community' $Name -CurrentOperation 'Removing Database' Remove-Database -Database $info.DatabaseName -Server $info.DatabaseServer #Delete the files Write-Progress 'Uninstalling Telligent Community' $Name -CurrentOperation 'Removing Website Files' if(Test-Path $webDir) { Remove-Item -Path $webDir -Recurse -Force } #Remove site from hosts files Write-Progress 'Uninstalling Telligent Community' $Name -CurrentOperation 'Removing Hosts entry' $hostsPath = join-path $env:SystemRoot system32\drivers\etc\hosts (Get-Content $hostsPath) | Where-Object {$_ -ne "127.0.0.1 $domain"} | Set-Content $hostsPath #Remove the solr core Write-Progress 'Uninstalling Telligent Community' $Name -CurrentOperation 'Removing Solr Core' if($info) { $solrVersion = Get-CommunitySolrVersion $info.PlatformVersion $solrUrl = ($data.SolrUrl -f $solrVersion).TrimEnd('/') + '/admin/cores' Remove-SolrCore -Name $Name -CoreBaseDir ($data.SolrCoreBase -f $solrVersion) -CoreAdmin $solrUrl -EA SilentlyContinue } else { Write-Warning "Unable to determine Solr version" } Write-Host "Deleted website at http://$domain/" } } } function Test-Zip { <# .Synopsis Tests whether a file exists and is a valid zip file. .Parameter Path The path to the file to test .Example Test-Zip c:\sample.zip Description ----------- This command checks if the file c:\sample.zip exists #> [CmdletBinding()] param( [parameter(Mandatory=$true, Position=0, ValueFromPipeline=$true)] [ValidateNotNullOrEmpty()] [string]$Path ) Test-Path $Path -PathType Leaf if((Get-Item $Path).Extension -ne '.zip') { throw "$Path is not a zip file" } } |