> For the complete documentation index, see [llms.txt](https://docs.pentaho.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pentaho.com/install/legacy-redirects/archive-installation-of-pentaho-legacy-pages/archive-installation-process-archived-pages/prepare-your-windows-environment-for-an-archive-install.md).

# Prepare your Windows environment for an archive install

This guide helps you prepare your Windows environment for an archive installation.

Archive installation includes a bundled Tomcat web application server.

For installation of the Pentaho Server on an existing web application server, see [Manual installation](https://docs.pentaho.com/install/pentaho-installation-overview-cp/manual-installation.md).

### Process overview

1. [Create Windows directory structure](#create-windows-directory-structure)
2. [Install Java](#install-java)
3. [Install the Pentaho Repository host database](#install-the-pentaho-repository-host-database)
4. [Download and unpack installation files](#download-and-unpack-installation-files)
5. [Set environment variables](#set-environment-variables)
6. [Prepare your Pentaho Repository](#prepare-your-pentaho-repository)

### Create Windows directory structure

Choose an installation path for installing Pentaho on a Windows system.

Pentaho recommends this directory structure:

1. Sign in to the machine where you will run the Pentaho Server.
2. Create the `pentaho\server` directory (for example, `C:\pentaho\server`).
3. Verify you have read, write, and execute permissions for the directories you created.
4. Verify users can write to the directory where you install Pentaho.

### Install Java

Pentaho requires a supported Java version.

1. Check [Components Reference](https://docs.pentaho.com/install/components-reference.md) for supported Java versions.
2. Download and install the supported JRE or JDK from the [Oracle website](http://www.oracle.com/technetwork/java/javase/downloads/index.html).
3. Set `JAVA_HOME` to your Java installation directory.

Example:

```
set JAVA_HOME="C:\Program Files\Java\<JDK_FOLDER>"
```

### Install the Pentaho Repository host database

The Pentaho Repository stores data used for scheduling and security.

It also stores metadata and models for reports.

1. Choose and install a database to host the Pentaho Repository.

Pentaho supports:

* PostgreSQL
* MySQL
* MariaDB
* Oracle
* MS SQL Server

2. Check [Components Reference](https://docs.pentaho.com/install/components-reference.md) for supported database versions.
3. Install the database you selected.
4. Verify the database is installed correctly.

### Download and unpack installation files

Pentaho Server and Operations Mart are delivered as compressed files.

Download them, unpack them, then move their contents to the correct directories.

#### Download files

1. Sign in to the [Support Portal](https://support.pentaho.com/hc/en-us) using the credentials from your Pentaho Welcome Packet.
2. In the **Pentaho** card, select **Download**.
3. In the **11.x** list, select **Pentaho 11.0 GA Release**.

{% hint style="info" %}
You might need to select **See all \<number> articles** to see the full list of 11.x downloads.
{% endhint %}

4. Scroll to the bottom of the **Pentaho 11.0 GA Release** page.
5. In the file component section, go to `Pentaho Server\Archive Build (Suggested Installation Method)`.
6. Download `pentaho-server-ee-11.0.0.0-<build number>.zip`.
7. In the file component section, go back to `11.0.0.0-GA`.
8. Open the `Operations Mart` folder.
9. Download `pentaho-operations-mart-11.0.0.0-<build number>.zip`.

#### Unpack installation files

1. Locate the two files you downloaded:
   * `pentaho-server-ee-11.0.0.0-<build number>.zip`
   * `pentaho-operations-mart-11.0.0.0-<build number>.zip`
2. Unpack `pentaho-server-ee-11.0.0.0-<build number>.zip` into the `\pentaho\server` directory.
3. Unpack `pentaho-operations-mart-11.0.0.0-<build number>.zip` into the `\pentaho\server` directory.
4. Move the directory for your database into `pentaho\server\pentaho-server\data\<database name>`. Delete the others.

Use these directory names:

* PostgreSQL → `postgresql`
* MySQL or MariaDB → `mysql5`
* Oracle → `oracle10g`
* MS SQL Server → `sqlserver`

5. Complete the steps for installing Data Integration Operations Mart in the **Administer Pentaho Data Integration and Analytics** document before installing your database.

#### Verify directory structure

Verify the files are placed correctly.

Your `pentaho` directory should include:

* `pentaho\server\pentaho-server\`
* `pentaho\server\pentaho-server\data\<database name>`

### Set environment variables

If you do not set the required `*_HOME` environment variables, Pentaho might not start correctly.

1. Set `PENTAHO_JAVA_HOME` to your Java installation directory:

```
set PENTAHO_JAVA_HOME="C:\Program Files\Java\<JDK_FOLDER>"
```

2. (Optional) If you are using a JRE, also set `JRE_HOME`.
3. Sign out and sign back in, then verify the variables are set.

Example:

```
echo %PENTAHO_JAVA_HOME%
```

### Prepare your Pentaho Repository

Once you finish preparing your environment, initialize and configure the Pentaho Repository.

Select the database you are using:

* [PostgreSQL](https://docs.pentaho.com/install/legacy-redirects/archive-installation-of-pentaho-legacy-pages/archive-installation-process-archived-pages/use-postgresql-as-your-repository-database-archive-installation.md)
* [MySQL or MariaDB](https://docs.pentaho.com/install/legacy-redirects/archive-installation-of-pentaho-legacy-pages/archive-installation-process-archived-pages/use-mysql-or-mariadb-as-your-repository-database-archive-installation.md)
* [Oracle](https://docs.pentaho.com/install/legacy-redirects/archive-installation-of-pentaho-legacy-pages/archive-installation-process-archived-pages/use-oracle-as-your-repository-database-archive-installation.md)
* [MS SQL Server](https://docs.pentaho.com/install/legacy-redirects/archive-installation-of-pentaho-legacy-pages/archive-installation-process-archived-pages/use-ms-sql-server-as-your-repository-database-archive-installation.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.pentaho.com/install/legacy-redirects/archive-installation-of-pentaho-legacy-pages/archive-installation-process-archived-pages/prepare-your-windows-environment-for-an-archive-install.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
