Tutorial: Manually Edit Access Server Configuration Using ConfigReplace

Abstract

You can upload Access Server configuration changes in one file using the command, ConfigReplace.

Overview

Access Server 2.10.1 and newer supports a command, ConfigReplace, which allows you to upload configuration changes in one file, and Access Server imports those changes to the correct configuration files.

The process is as follows:

Download the configuration to a single file.
Edit that file.
Replace the configuration with changes from the file.
Access Server updates the appropriate configuration files.

Prerequisites

An installed and configured Access Server 2.10.1 and newer.
Console access and the ability to get root access.

Step 1: Download the configuration to a single file

Sign in to the console and get root privileges.
Download the configuration to a single file:
```
cd /usr/local/openvpn_as/scripts/
./sacli ConfigQuery > config.txt1
```
1
Where config.txt is the name of the new single configuration file.

Step 2: Edit the configuration file

Edit the file config.txt with your changes.
- For example, you might change auth.module.type to pam or vpn.client.routing.reroute_gw to false.
Save your changes.

Step 3: Replace the configuration

Replace the configuration:

cd /usr/local/openvpn_as/scripts/
./sacli --value_file=config.txt ConfigReplace
./sacli start

Verify your configuration changes.

Optional step 3: Replace the configuration for a specific profile

Alternatively, if you want to apply the configuration changes to a specific profile, use these commands for the third step, where you replace the configuration.

Replace the configuration for a specific profile:
```
cd /usr/local/openvpn_as/scripts/
./sacli --value_file=config.txt --prof=new_profile1 ConfigReplace
./sacli start
```
1
Where new_profile is the name of the configuration profile you want changed.
Verify your configuration changes.

In this section: