Deploying on Linux or Unix

Page created: 24 Jul 2019 |

Page updated: 8 Feb 2022

| 1 min read

Custom Applications PHP Other Documents Integrations Language English Integration Content Type Product documentation Audience Administrator

You can manually deploy the PHP Integration Kit sample applications on UNIX or other Linux platforms.

From the integration .zip archive, copy the sample directory to root level of the DocumentRoot of your Apache HTTP server. This makes the directory accessible at https://hostname/sample.
Move the sample/config directory to a directory on the server that is outside the DocumentRoot. This protects the config directory from unauthorized access.
Update the location of the agent-config.txt files. Modify the following files to point to the new location of the config directory.
1. Open sample/idp/pingidentity/opentoken/helpers/config.php for editing.
2. Change the following line based on the new location of your config directory:
```
const   AGENT_CONFIG_FILE = "../config/idp/agent-config.txt";
```
3. Repeat the equivalent steps a-b in sample/sp/pingidentity/opentoken/helpers/config.php for your SP agent-config.txt file.
Update the location of the config.properties files. Modify the following files to point to the new location of the config directory.
1. Open sample/idp/Const.php for editing.
2. Change the following line based on the new location of your config directory:
```
define("CONFIG_FILE", "../config/idp/config.properties");
```
3. Repeat the equivalent steps a-b in sample/sp/Const.php for your SP config.properties file.
Change the ownership and permission of the sample application configuration files for the user and/or group that runs the Apache server by doing the following:
chown –R <apache_user> <config_dir>/*
chmod u+w <config_dir>/*
If your PingFederate server is hosted on another computer, go to the following URLs and change the PF Host Name value in the SP and IdP sample applications configuration.
- https://hostname/sample/idp/ConfigUI.php
- https://hostname/sample/sp/ConfigUI.php