---
title: Installing on IIS
description: Install a PingAccess agent on an Internet Information Services (IIS) system.
component: pingaccess
version: 9.0
page_id: pingaccess:agents_and_integrations:pa_installing_on_iis
canonical_url: https://docs.pingidentity.com/pingaccess/9.0/agents_and_integrations/pa_installing_on_iis.html
revdate: March 20, 2023
section_ids:
  before-you-begin: Before you begin
  steps: Steps
---

# Installing on IIS

Install a PingAccess agent on an Internet Information Services (IIS) system.

## Before you begin

Shut down any running programs, including the Windows Event Viewer. Running applications might cause the installation to fail.

|   |                                                                                                                                                                                    |
| - | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|   | If the system is running application pools in 32-bit compatibility mode, review the [Troubleshooting](pa_iis_troubleshooting.html) for information about preventing a known issue. |

## Steps

1. Extract the PingAccess agent for IIS `.zip` file.

   |   |                                                                                     |
   | - | ----------------------------------------------------------------------------------- |
   |   | The installer cannot be run from inside the `.zip` file. You must first extract it. |

2. Run the `pingaccess-agent-iis.msi` installer.

   1. Click **Next**.

   2. **Optional:** Specify a new destination folder, and then click **Next**.

   3. Click **Install**.

   4. Click **Finish**.

3. In the PingAccess console, go to **Applications > Agents**.

4. Edit a configured agent.

   If the agent has not yet been created, follow the procedure in the [PingAccess User Interface Reference Guide](../pingaccess_user_interface_reference_guide/pa_adding_agents.html).

5. In the shared secret, click the **Download** icon to download the configuration.

   The configuration file is named `<agentname>_agent.properties`.

6. To create the `C:\Program Files\Ping Identity\PingAccess Agent for IIS\agent.properties` file on the agent system, copy and rename the `<agentname>_agent.properties` file. .

   |   |                                                                                                                                      |
   | - | ------------------------------------------------------------------------------------------------------------------------------------ |
   |   | If you changed the destination folder for the agent, update the file path for the `agent.properties` file to match the new location. |

7. Restart Microsoft IIS Server on the system:

   1. Launch IIS Manager.

   2. Navigate to the web server node in the Connections tree.

   3. In the **Actions** pane, click **Restart**.

      |   |                                                                             |
      | - | --------------------------------------------------------------------------- |
      |   | You can restart the IIS service by running the command `iisreset /restart`. |