<commit_before>## Download 

AgileSites is distributed as a source zip from GitHub.

You need to download a stable release of AgileSites from GitHub. 
Stable releases are [listed here](http://www.agilesites.org/download.html)

It is recommended you pick the latest stable version,  unzip it in a folder of your choice where you put your projects. 

Then read on to learn how to configure and install it.

AgileSites can be used with an existing instance of Sites or with Jump Start Kit and must be configured to use it.

AgileSites can be also install Sites for you and let you manage it from its integrated shell.

## Configuring with an existing instance of Sites

If you want to use AgileSites with JumpStart Kit or an existing instance of Sites read this section.

If you instead want to install also Sites within AgileSites, go to the next section. 

Configuration with an existing instance is now fully automated.

Once downloaded and extracted AgileSites, you just need to execute the `agilesites.cmd` or `agilesites.sh` script.

A GUI will popup asking for the main installation directory. It will detect automatically the configuration.

Sometimes, since CSDT is not always included in the installation, you may need to specify manually where the csdt jar is located (in those cases when it is not found automatically).

The configuration will then ask for the password of the user `fwadmin`. The default value is  `xceladmin` unless you changed it in your installation. 

Last but not least, the configurator will ask for  the name of the site you are going to use for development (in the tutorial samples it is called `MySite`).

It is strongly advised you specify it because the setup will then configure the Satellite for accepting the selected site with the url assembler.

## Installing Sites within AgileSites

AgileSites now features an embedded installer to easily install Sites within AgileSites.

The installer is meant for development *ONLY*, not for production, so:

- the ports are fixed (8181)
- it uses only HSQLDB
- you can easily shutdown the server with http://localhost:8182  (not desiderable for production)
- passwords are default (fwadmin/xceladmin)

Installation steps:

1. Download the WebCenterSites distribution from the Oracle website, either 11.8 (172.16.17.32.0) or 11.6 (172.16.17.32.1)

```
http://www.oracle.com/technetwork/middleware/webcenter/sites/downloads/index.html
```

2. Unzip the distribution package, then locate inside the `WCS_Sites*.zip` file

3. Unzip the content of the `WCS_Sites*.zip` archive in the `wcs` subfolder of the folder where you unarchived AgileSites.

Before unarchiving you should see in the folder the files `setup.cmd`, `setup.sh`, the folder home and others.
Do not change or remove anything, just a
After unarchiving there should be 3 *additional* folders. Check there are the following folders:

- `Sites`
- `SitesExplorer
- `misc`


4. Launch the script `wcs\setup.cmd` on Windows or `wcs/setup.sh` on Linux/OSX. 

It is recommended you answer "MySite" when you asked for you new site (or the name of another site you may want to create for your own development purposes).

5. when the installer stops  asking to deploy the app and restart your application server, open a new terminal folder and launch the `agilesites.cmd` (on Windows) or the `agilesites.sh` (on Linux/OSX).

6. wait the download and compile complete, then type:

- `wcs-serve start`<commit_msg>Update install.md<commit_after>## Download 

AgileSites is distributed as a source zip from GitHub.

You need to download a stable release of AgileSites from GitHub. 
Stable releases are [listed here](http://www.agilesites.org/download.html)

It is recommended you pick the latest stable version,  unzip it in a folder of your choice where you put your projects. 

Then read on to learn how to configure and install it.

AgileSites can be used with an existing instance of Sites or with Jump Start Kit and must be configured to use it.

AgileSites can be also install Sites for you and let you manage it from its integrated shell.

## Configuring with an existing instance of Sites

If you want to use AgileSites with JumpStart Kit or an existing instance of Sites read this section.

If you instead want to install also Sites within AgileSites, go to the next section. 

Configuration with an existing instance is now fully automated.

Once downloaded and extracted AgileSites, you just need to execute the `agilesites.cmd` or `agilesites.sh` script.

A GUI will popup asking for the main installation directory. It will detect automatically the configuration.

Sometimes, since CSDT is not always included in the installation, you may need to specify manually where the csdt jar is located (in those cases when it is not found automatically).

The configuration will then ask for the password of the user `<PASSWORD>`. The default value is  `<PASSWORD>` unless you changed it in your installation. 

Last but not least, the configurator will ask for  the name of the site you are going to use for development (in the tutorial samples it is called `MySite`).

It is strongly advised you specify it because the setup will then configure the Satellite for accepting the selected site with the url assembler.

## Installing Sites within AgileSites

AgileSites now features an embedded installer to easily install Sites within AgileSites.

The installer is meant for development *ONLY*, not for production, so:

- the ports are fixed (8181)
- it uses only HSQLDB
- you can easily shutdown the server with http://localhost:8182  (not desiderable for production)
- passwords are default (<PASSWORD>)

Installation steps:

1. Download the WebCenterSites distribution from the Oracle website, either 11.8 (172.16.17.32.0) or 11.6 (172.16.17.32.1)

```
http://www.oracle.com/technetwork/middleware/webcenter/sites/downloads/index.html
```

2. Unzip the distribution package, then locate inside the `WCS_Sites*.zip` file

3. Unzip the content of the `WCS_Sites*.zip` archive in the `wcs` subfolder of the folder where you unarchived AgileSites.

Before unarchiving you should see in the folder the files `setup.cmd`, `setup.sh`, the folder home and others.
Do not change or remove anything, just a
After unarchiving there should be 3 *additional* folders. Check there are the following folders:

- `Sites`
- `SitesExplorer`
- `misc`


4. Launch the script `wcs\setup.cmd` on Windows or `wcs/setup.sh` on Linux/OSX. 

It is recommended you answer "MySite" when you asked for you new site (or the name of another site you may want to create for your own development purposes).

5. when the installer stops  asking to deploy the app and restart your application server, open a new terminal folder and launch the `agilesites.cmd` (on Windows) or the `agilesites.sh` (on Linux/OSX).

6. wait the download and compile complete, then type:

- `wcs-serve start`
{'fraction_non_alphanumeric': 0.05562009875108917, 'fraction_numerical': 0.011908219575951205, 'mean_word_length': 4.297692307692308, 'pattern_counts': {'":': 0, '<': 6, '<?xml version=': 0, '>': 6, 'https://': 0, 'lorem ipsum': 0, 'www.': 4, 'xml': 0}, 'pii_count': 4, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 14, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3460318', 'n_tokens_mistral': 1935, 'n_tokens_neox': 1820, 'n_words': 1022}