Ett skript för att underlätta arbetet med uppgradering av Visma´s produkt Personec P HRM. Skriptet har funktioner som underlättar och sparar tid samt gör att uppgraderingsstegen oavsett konsult blir standardiserade.

Det finns två sätt att plocka ner skriptet beroende på hur kunden tillåter internetåtkomst.

• Nedladdning via powershell

Invoke-WebRequest 'https://github.com/Dambergc/Vismascript/releases/latest/download/CygateScript.ps1' -OutFile D:\Visma\Install\Backup\CygateScript.ps1 -Verbose

• Gå till Github till adressen https://github.com/dambergc/vismascript och går till Releases och ladda ner filen CygateScript.ps1 under senaste Release.

Är det första gången så behöver du skapa BIGRAM och skapa en backupkatalog. Är redan BIGRAM skapat så behöver du bara välja BIGRAM.

För att starta skriptet så starta ett eleverat Powershell fönster och sedan skriv sökvägen till skriptet

D:\visma\install\backup\CygateScript.ps1

Skulle det finnas kund som har sin installation på annan enhet en den som är default (D:) så hanteras det av skriptet och då är sökvägen självklart samma som ovan men med ändring av enhetsbokstaven som du får ändra manuellt.

• DarkMode/LightMode - För de som vill så finns nu alternativet för Dark- och Lightmode i menyn under DisplayMode. När man väljer läge så sparas inställningen i registret så när du startar upp det eller någon annan konsult kör mot kund så visas programmet i senast valda läge.
• Avsluta programmet, nu så när man antingen väljer att trycka "close" eller bara trycka på "krysset i högra hörnet" så får man valet att kryptera backupen/backuperna.
• Versionsnummer för resp produkt, HRM och FDN plockas nu från vad som är nedladdat via VPBS. Har det inte laddats ner något så får man inte rätt värden i t.ex. kontroll av databas eller skapande av sql-script.
• Gått ifrån knappar på huvudsidan till att ha menyer istället.
• Flyttat inställningarna som behövs för att ladda ner och packa upp VPBS till under Tools menyn.
• Ändrat versionsnumret till följande struktur "ÅR.Mån.löpnummer" ex. 25.09.001
• Under inventeringen så plockas också ut värden för Bindings samt att en nosso-länk skapas som är klickbar i fönstret på huvudsidan.
• Åtgärdat lite småfel i t.ex. skapande av queries för QRread.

För att få köra skriptet så är det samma krav som på Public Installer, du måste vara medlem i den lokala gruppen ”Visma Services Trusted Users” Hur du lägger till dig i gruppen går att göra det manuellt via Computer Management eller via powershell som du hittar i vårt uppgraderingsdokument.

För att komma åt funktionerna i skriptet så krävs att du väljer BIGRAM och BACKUKFOLDER under den knappen ”Bigram And BackupFolder”. Efter att du valt det så är övriga knappar öppna så att du kan komma åt underliggande funktioner.

Det BIGRAM AND BACKUPFOLDER du väljer kommer följa med dig under hela tiden så länge du har skriptet igång. Skulle det stängas ner av misstag så måste du åter välja det vid uppstart.

Alla val man gör i skriptet skrivs i en logfil som ligger under d:\visma\install\backup. Logfilen används innan man valt BackupFolder och måste därför ligga under Visma\Backup och dessa logfiler får vid behov rensas manuellt. Det skapas en logfil för varje dag man kör skriptet.

De funktioner i skriptet är framtagna för att standardisera och effektivisera arbetet för konsult vid uppgradering och felsökning av Personec P installation hos kund.

Filbackup är ett krav och MÅSTE köras inför varje uppgradering oavsett Major eller Minor och har man fler BIGRAM så räcker det att köra backupen en gång.

Det som kopieras undan är allt under wwwroot och programs med undantag av *.log filer som exkluderas pga storleken.

Man ska INTE avkryptera miljön innan backup då vid behov så har vi en funktion där vi kan avkryptera backup för att komma åt värden. Detta är av säkerhet då okrypterade backuper innehåller känslig info om konton och lösenord i kundens miljö.

Backupen körs med hjälp av RoboCopy och loggarna för backupen sparas under BackupFolder-mappen.

Inventering av systemet där följande saker inventeras:

• Vad som är installerat och vilka versioner som är kopplade till Visma
• Vilka applikationspooler som är igång och med vilka konton som dom körs med – Om det är en webserver.
• Vilka tjänster som är igång och hur dom är konfigurerade. Ibland så kör kunden t.ex. Batchtjänsten med ett AD-konto vilket kunden behöver information om att återställa efter uppgraderingen.

Lösenorden till vissa utpekade konton som vi ibland kan ha behov att ha tillgång till inventeras från den backup som körts. Att detta ska fungera så måste följande vara uppfyllt.

• Backup körd och BackupFolder vald
• Avkryptering av Backupen gjord

Följande inventeras just nu av Settings

• Om värdet useSSO är true eller false
• Om värdet Multitenant är true och false
• Om det finns en license.json i backupen

Om det är mer värden som kan vara nytta för oss tekniker under en uppgradering så är det enkelt att lägga till mer saker att inventera.

Här skapas SQL Queries som underlättar vårt arbete. Här är lite nytt med queries direkt mot databasen för att kolla version och vilka skript som körts. Detta kräver att PIN är igång då skriptet plockar värden från en avkrypterad BIGRAM_applications.XML. Det finns också möjlighet att få ut SQL queries om du behöver köra frågorna manuellt vid behov.

SQL Queries för att uppgradera PPP PUD och PUF.

När man installerar Quick Report för första gången så behöver man sätta upp några konton i SQL.

Vid byte av lösenord hos kund så är det enklare att köra en SQL querie så byts lösenorden på en gång.

Följande konton byts:

• BIGRAM_DashBoardUser
• BIGRAM_MenuUser
• BIGRAM_NeptuneAdmin
• BIGRAM_NeptuneReportUser
• BIGRAM_NeptuneUser
• BIGRAM_QuickReportAdmin
• BIGRAM_QuickReportUser
• Visma_CurrencyUser
• Visma_CommonStorageUser
• Visma_SchedulerUser
• rspdbuser

Sedan så behöver du byta i PIN manuellt.

Då konton stoppas från inloggning så behöver vi ett konto hos kunden i Neptune.

Denna SQL query skapar en användare med de rättigheter som vi behöver för att komma in systemet.

Du svarar på frågorna så skapas sedan SQL Query som skickas till ditt urklipp.

Första gången du loggar på med kontot så använder du lösenordet: Vism@Cyg@te!!

Här stoppar du och startar tjänster och site.

När du stoppar tjänster så skapas en RestorePoint.xml som sparas i den valda Backupkatalogen.

När du sedan väljer att starta tjänsterna så återställer skriptet tjänsterna till hur dom var innan du gjorde uppgraderingen.

Två nya funktioner finns nu i skriptet som är kopplade till tjänsterna.

Här så får du välja att öppna RestorePoint.xml om det ligger en i Backupkatalogen, då får du en enkel överblick hur kundens tjänster hade för status innan uppgradering.

För att kunna jämföra hur det ser ut efter uppgraderingen så kan du få en enkel överblick som du sedan kan jämföra med när du innan valt att ladda in RestorePoint.xml

Denna funktion är helt ny och den går bara att köra om du gjort en avinstallation. Om du inte gjort avinstallation så kommer du inte kunna resna något med koppling till Visma produkter.

De knappar som är öppna är Temp Asp.NET, Inetpub Logs och Install Catalog.

Alla knappar under CleanUp är kopplade till vad i vårt dokument säger vi ska rensa.

Rensar följande kataloger:

• "C:\Windows\Microsoft.NET\Framework\v4.0.30319\Temporary ASP.NET
• "C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Temporary ASP.NET Files"

Rensar följande kataloger:

• C:\inetpub\logs\logfiles

Denna funktion rensar egentligen samma sak som som VPBS där du väljer att ta bort nedladdade versioner av Valda produkter.

Följande kataloger rensas

• Support
• SAP
• Preinstall
• Microsoft
• HRM
• FDN med undantag för PIN

Sista knappen på huvudsidan för vårt skript är en samling av verktyg som vi kan ha behov av under en felsökning eller en uppgradering.

Här under kan du sätta defaulträttigheter som krävs för certifikat för Personec P och få ut Thumbprint för valt certifikat.

Ibland så råkar kund ändra på rättigheter i filstrukturen under WWW för PUD och PPP. Denna funktion återställer till de rättigheter som behövs för att Personec P ska fungera.

Nedladdning av verktygen för att sätta site till Strict.

Laddas ner till d:\visma\install

Nedladdning av nedladdningsverktyget för Visma.

Två knappar för att avkryptera eller kryptera en vald backupkatalog.

Kontrollerar om miljön är satt till Strict och endast accepterar TLS 1.2

Skriptet kollar efter 1.0 och 1.1 och rapporterar tillbaka hur status är.

Skjuter in de två registervärden som behövs för TLS 1.2

Mer info kommer när den funktionen är klar

Utöver nämnda funktioner så finns det några funktioner som kan vara bara att veta om.

Här väljer du vilken logfil du vill läsa och se vad som är gjort och inventerat.

När du vill avsluta programmet så får du upp valet att kryptera backupen.

• @DambergC