Reorganize Password Reset KB into 7 categorized folders and add sidebar

docs/kb/passwordreset/_category_.json

@@ -1,6 +1,10 @@
 {
-  "label": "Troubleshooting Articles",
+  "label": "Knowledge Base",
   "position": 999,
   "collapsed": true,
-  "collapsible": true
+  "collapsible": true,
+  "link": {
+    "type": "doc",
+    "id": "index"
+  }
 }

docs/kb/passwordreset/configuration-and-customization/customization-of-logon-prompt-extension.md

@@ -0,0 +1,102 @@
+---
+description: >-
+  Shows how to customize the Logon Prompt Extension for Netwrix Password Reset
+  by setting registry values. Lists registry keys, string and DWORD values, and
+  supported language codes.
+keywords:
+  - Logon Prompt Extension
+  - Password Manager
+  - Netwrix Password Reset
+  - registry
+  - PRM_Server
+  - PRM_CurrentUserLanguage
+  - LPE
+  - Enrollment wizard
+products:
+  - general
+sidebar_label: Customization of Logon Prompt Extension
+tags: []
+title: "Customization of Logon Prompt Extension"
+knowledge_article_id: kA00g000000H9cFCAS
+---
+
+# Customization of Logon Prompt Extension
+
+## Overview
+
+Customization of the Netwrix Logon Prompt Extension for Netwrix Password Reset is done via registry values in the following keys:
+
+- `HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node]\NetwrixPassword Manager Self-service Client`
+- `HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node]\Policies\NetwrixPasswordManager`
+
+Most of these values are not created by the default installation. You can set values manually or by using any deployment software that can apply `.reg` files (SCCM, self-written scripts, etc.). The `Policies` key can also be configured via Group Policy by using the `Netwrixprm.adm` administrative template, which is located in the Netwrix Password Reset installation directory — it is described in the Administrator's guide.
+
+The full list of values follows.
+
+---
+
+## At `HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node]\NetwrixPassword Manager Self-service Client`
+
+All values are string values (`REG_SZ`):
+
+- `CompanyBrand` — this value replaces "Netwrix" in all text of the Logon Prompt Extension
+- `HelpDeskPhone` — this value is added at the end of all message boxes in the Logon Prompt Extension and Enrollment wizard
+- `LogonCaption` — this value replaces the header of the Logon Prompt Extension password reset wizard
+- `MainCaption` — this value replaces the header of the Enrollment wizard
+
+![User-added image](../0-images/ka04u00000116Nm_0EM700000004xhy.png)
+
+![User-added image](../0-images/ka04u00000116Nm_0EM700000004xi3.png)
+
+---
+
+## At `HKEY_LOCAL_MACHINE\SOFTWARE\[Wow6432Node]\Policies\NetwrixPasswordManager`
+
+String values (`REG_SZ`):
+
+- `PRM_Server` — URL to your Password Manager web site
+- `PRM_LogonWindowText` — replaces text of the LPE invite on WinXP/2003 logon screen
+- `PRM_LogonWindowButtonText` — replaces text which is shown when you point to the button of the Logon Prompt Extension on the WinXP/2003 logon screen
+- `PRM_LogonWindowIconPath` — contains path to an `.ico` file, with which the default icon of the Logon Prompt Extension will be replaced
+- `PRM_CredProvLogonWindowText` — replaces text of the Logon Prompt Extension invite on WinVista/7/2008 logon screen
+- `PRM_CurrentUserLanguage` — this value toggles the language of the Logon Prompt Extension and Enrollment wizard. Possible values are specified in the table below.
+- `PRM_CredentialDialogText` — replaces the text in the credential prompt window of the Enrollment wizard
+- `PRM_CredentialDialogCaption` — replaces the header in the credential prompt window of the Enrollment wizard
+- `LPE_AccountRemark` — replaces the example text under the field used to enter the account name
+- `Predefine_Domain` — this value sets a predefined domain name that will be used
+
+![User-added image](../0-images/ka04u00000116Nm_0EM700000004xiD.png)
+
+![User-added image](../0-images/ka04u00000116Nm_0EM700000004xiI.png)
+
+### DWORD values
+
+DWORD values can be turned on (`1`) or off (`0`):
+
+- `PRM_ResetCredentialsCache` — allows the client to reset password in the local cache in disconnected mode.
+- `PRM_SuppressEnrollmentErrors` — this option disables error messages
+- `PRM_SuppressLaterEnrollment` — this option makes the user unable to close the Enrollment wizard without completing the enroll procedure
+
+---
+
+## Language values
+
+Set `PRM_CurrentUserLanguage` to one of the following values:
+
+| Value | Language             |
+|-------:|---------------------|
+| cn    | Chinese              |
+| de    | German               |
+| en    | English              |
+| es    | Spanish              |
+| fr    | French               |
+| he    | Hebrew               |
+| it    | Italian              |
+| jp    | Japanese             |
+| ko    | Korean               |
+| pt    | Portuguese           |
+| ru    | Russian              |
+| sk    | Slovak               |
+| zh    | Traditional Chinese  |
+
+![User-added image](../0-images/ka04u00000116Nm_0EM700000004xhe.png)

docs/kb/passwordreset/configuration-and-customization/how-to-change-a-domain-name-for-all-enrolled-users.md

@@ -0,0 +1,53 @@
+---
+description: >-
+  Instructions to bulk re-enroll users after an email domain change by updating
+  the DomainName field in the Password Reset SQL database. Includes SqlCeCmd40
+  examples for SQL Server Compact and guidance for SQL Server.
+keywords:
+  - domain change
+  - bulk re-enroll
+  - SqlCeCmd40
+  - SQL Server Compact
+  - Password Reset
+  - apr.sdf
+  - DomainName
+  - UPDATE query
+products:
+  - password-reset
+sidebar_label: How To Change a Domain Name for All Enrolled Users
+tags: []
+title: "How To Change a Domain Name for All Enrolled Users?"
+knowledge_article_id: kA0Qk0000000LkPKAU
+---
+
+# How To Change a Domain Name for All Enrolled Users?
+
+## Question
+
+How to to bulk re-enroll users that have had their email domain changed?
+
+## Answer
+
+A domain name is stored in the SQL database. To change a domain name for the enrolled users, you need to update the database with a SQL query.
+
+> **IMPORTANT:** Always backup the database with the Data Console closed and the Netwrix Password Reset service stopped before modifying the database.
+
+If you are using **SQL Server Compact**, you can use the open source [SqlCeCmd40](https://github.com/ErikEJ/SqlCeCmd/releases) tool.
+
+The queries below can be used for SQL Server, but with a different tool. Ask your Database Administrator for more information.
+
+- Use this query to set the domain name for all users:
+
+```text
+SqlCeCmd40.exe -d "Data Source=apr.sdf" -q "UPDATE Usr SET DomainName = 'NewDomain'"
+```
+
+where `NewDomain` is the name of your new domain.
+
+- If you only want to update one user, for example, for testing purposes, then use the following query:
+
+```text
+SqlCeCmd40.exe -d "Data Source=apr.sdf" -q "UPDATE Usr SET DomainName = 'NewDomain' where (LogonName = 'Test') AND (DomainName = 'OldDomain')"
+```
+
+where `NewDomain` is the name of your new domain and `OldDomain` is the old name arrordingly.

docs/kb/passwordreset/configuration-and-customization/how-to-change-default-language-of-the-self-service-portal.md

@@ -0,0 +1,50 @@
+---
+description: >-
+  Shows how to configure the Netwrix Password Reset Self-service portal to use a
+  different default language by editing the locale.asp file and restarting IIS.
+keywords:
+  - language
+  - self-service
+  - password reset
+  - locale.asp
+  - iisreset
+  - Netwrix Password Reset
+  - localization
+  - langcode
+products:
+  - general
+sidebar_label: How to change default language of the Self-service
+tags: []
+title: "How to change default language of the Self-service portal"
+knowledge_article_id: kA00g000000H9VVCA0
+---
+
+# How to change default language of the Self-service portal
+
+How to configure the Netwrix Password Reset Self-service portal to use a different language other than English by default
+
+To change the language used on the portal by default please do the following:
+
+1. Go to the folder Web-SS folder, by default `C:\Program Files (x86)\NetWrix Password Manager\Web_SS`
+2. Edit the **locale.asp** file
+3. Change line 112 to `var langsDict, defLang = "%langcode%"` (substitute `en` with the desired language code)
+
+![User-added image](../0-images/ka04u00000116cJ_0EM70000000ts5W.png)
+
+4. Save the changes and execute an IIS reset in a command prompt with the following command: `iisreset`
+
+| Langcode value | Language             |
+|----------------|----------------------|
+| cn             | Chinese              |
+| de             | German               |
+| en             | English              |
+| es             | Spanish              |
+| fr             | French               |
+| he             | Hebrew               |
+| it             | Italian              |
+| jp             | Japanese             |
+| ko             | Korean               |
+| pt             | Portuguese           |
+| ru             | Russian              |
+| sk             | Slovak               |
+| zh             | Traditional Chinese  |

docs/kb/passwordreset/configuration-and-customization/how-to-configure-website-accessibility-using-server-hostname-only.md

@@ -0,0 +1,38 @@
+---
+description: >-
+  Follow these steps to configure Netwrix Password Reset in IIS so that
+  accessing the site by hostname or IP address loads the Netwrix Password Reset
+  site as the default page.
+keywords:
+  - password reset
+  - IIS
+  - hostname
+  - Default Document
+  - Application Pool
+  - ISAPI-dll
+  - DefaultAppPool
+  - pwreset
+  - redirect
+products:
+  - password-reset
+sidebar_label: How to Configure Website Accessibility Using Serve
+tags: []
+title: "How to Configure Website Accessibility Using Server Hostname Only"
+knowledge_article_id: kA0Qk0000000YrJKAU
+---
+
+# How to Configure Website Accessibility Using Server Hostname Only
+
+## Question
+
+How can you get Netwrix Password Reset to redirect a site to its hostname?
+
+## Answer
+
+Follow the steps below to configure Netwrix Password Reset to redirect a site to its hostname:
+
+1. Open **IIS Manager**.
+
+2. Select **Default web site** and click **Advanced Settings...** in the right pane.
+
+   ![User-added image](../0-images/ka0Qk0000002mmv_0EMQk000003xxC1.png)

docs/kb/passwordreset/configuration-and-customization/how-to-localize-password-manager.md

@@ -0,0 +1,49 @@
+---
+description: >-
+  Learn how to add a new language to the Self-Service portal by creating and
+  editing a localization file in the Web_SSLocals folder.
+keywords:
+  - localization
+  - language
+  - Self-Service portal
+  - Web_SSLocals
+  - en.asp
+  - iisreset
+  - localization file
+products:
+  - general
+sidebar_label: How to localize Netwrix Password Reset
+tags: []
+title: "How to localize Netwrix Password Reset"
+knowledge_article_id: kA00g000000H9W7CAK
+---
+
+# How to localize Netwrix Password Reset
+
+There is an option to select the language of the **Self-Service portal**, but there is no language you need in the list. How can you add the language you need to the list?
+
+Each language has a separate localization file.
+
+## Location of localization files
+
+Localization files are stored in the **Web_SSLocals** folder in the program installation directory (by default - `C:\Program Files (x86)\Netwrix Password Manager\Web_SSLocals`)
+
+![User-added image](../0-images/ka04u00000116S9_0EM700000005OBk.png)
+
+To add a language, create a copy of `en.asp`, then rename it to `%language code%.asp` and edit.
+
+### Required settings in the new file
+
+1. Open the new `%language code%.asp` file.
+2. First of all set:
+   - `strLangID=`%language code%`  (NOTE: Must correspond with the asp file name)`
+   - `strLangDispName=`%language name%``
+
+![User-added image](../0-images/ka04u00000116S9_0EM700000005OBp.png)
+
+3. Then substitute all English phrases with their equivalents in the desired language.
+4. After you finish, save changes and execute `iisreset` from the command line.
+
+The language will be added to the list automatically.
+
+Also take a look at https://kb.netwrix.com/659 for more details about localization files.

docs/kb/passwordreset/deployment-and-infrastructure/load-balancing-cluster-for-password-manager.md

@@ -0,0 +1,65 @@
+---
+description: >-
+  This article describes how to set up a load-balancing cluster (frontend only)
+  for Netwrix Password Reset using Windows Server Network Load Balancing. It
+  includes step-by-step instructions and configuration notes.
+keywords:
+  - network load balancing
+  - load balancing
+  - cluster
+  - Netwrix Password Reset
+  - Windows Server
+  - multicast
+  - cluster IP
+  - port rules
+  - web applications
+products:
+  - general
+sidebar_label: Load-balancing cluster for Netwrix Password Reset
+tags: []
+title: "Load-balancing cluster for Netwrix Password Reset"
+knowledge_article_id: kA00g000000H9WbCAK
+---
+
+# Load-balancing cluster for Netwrix Password Reset
+
+How to setup a load balancing cluster for Netwrix Password Reset
+
+**Note:** Load-balancing can be used for the frontend only. It is impossible to load-balance a single-server installation, because in this case there will be several copies of the Password Manager service running at the same time and you will not be able to share the internal database of Password Manager between them.
+
+**Note:** A load-balanced cluster can be built both with domain or non-domain members; however the best practice is to use domain members as cluster nodes. The instruction below refers to creating a load-balancing cluster with domain members.
+
+1. Enable the **Network Load Balancing** feature (only available in Windows 2008 R2 Datacenter and Enterprise)
+   1. Run **Server Manager**
+   2. In the left pane right-click **Features**, select **Add feature**. A wizard opens.
+   3. Enable the checkbox in front of **Network Load Balancing**, click **Next**, then click **Install**.
+
+2. On any server that has the Network Load Balancing feature installed, run **Control Panel → Administrative Tools → Network Load Balancing Manager**
+   1. From the menu select **Cluster → New**
+   2. In the **Host** field specify a name of a machine that is to be part of the new cluster, click **Connect**
+   3. Select the network Interface that will be used to build a cluster, click **Next**
+
+![User-added image](../0-images/ka04u00000116bU_0EM70000000554p.png)
+
+4. In the **New Cluster: Cluster IP addresses** window click **Add** and specify the IP address and subnet mask that will be used to access the cluster. Click **OK**, then **Next**.
+
+![User-added image](../0-images/ka04u00000116bU_0EM70000000554u.png)
+
+5. In the **New cluster: Cluster Parameters** window verify cluster IP, specify cluster internet name and cluster operational mode. Click **Next.**
+
+   **Note:** For servers with only one network interface set **Multicast.**
+
+![User-added image](../0-images/ka04u00000116bU_0EM70000000554z.png)
+
+6. In the **New cluster: Port rules** window click **Finish**.
+
+   **Note:** By default all traffic (on all protocols and ports) is equally divided between all cluster nodes. If you want to load-balance requests on a specific protocol or port, in the **New cluster: Port rules** window highlight the rule and click **Modify**.
+
+![User-added image](../0-images/ka04u00000116bU_0EM700000005554.png)
+
+7. Right-click the newly created cluster in the left pane and select **Add host to cluster** and add more nodes if needed.
+
+8. Repeat steps 4-9 of this procedure for every server that is to be a cluster node.
+
+9. Install Web-Applications on every node per procedure 12 of the Netwrix Password Reset Administrators guide:
+   - https://www.netwrix.com/download/documents/NetWrix_Password_Manager_Administrator_Guide.pdf