Updating the Automator
Instructions for Updating the Automator version
The steps for updating Keeper Automator are below. The exact steps will depend on your environment and installation method. To refer back to the original installation instructions, see the Keeper Automator Service page.
Docker Install Method
(1) Back up your configuration
Ensure that you have the
ssl-certificate.pfx and ssl-certificate-password.txt files backed up locally from your running container.1
docker cp \
2
Keeper-Automator:/usr/mybin/settings/ssl-certificate-password.txt \
3
./ssl-certificate-password.txt
4
​
5
docker cp \
6
Keeper-Automator:/usr/mybin/settings/ssl-certificate.pfx \
7
./ssl-certificate.pfx
Copied!
(2) Stop and Remove the Container
1
docker stop "Keeper-Automator"
2
docker rm "Keeper-Automator"
Copied!
(3) Pull the latest image
1
docker pull keeper/automator
Copied!
(4) Start the service
Use the command below to start the service. This example below is listening to port 8089.
1
docker run -d -p8089:8089/tcp \
2
--name "Keeper-Automator" \
3
--restart on-failure:3 \
4
keeper/automator
Copied!
(9) Update the certificate
Copy the
ssl-certificate.pfx file and ssl-certificate-password.txt files from Step 1 into the container.1
docker cp ssl-certificate.pfx \
2
Keeper-Automator:/usr/mybin/settings/ssl-certificate.pfx
3
4
docker cp ssl-certificate-password.txt \
5
Keeper-Automator:/usr/mybin/settings/ssl-certificate-password.txt
Copied!
(10) Restart the container with the SSL cert
Now that the certificate is installer, restart the Docker container:
1
docker restart "Keeper-Automator"
Copied!
(11) Login to Keeper Commander and re-initialize
Login to Keeper Commander and locate the name of the Automator instance. In this example, it is called "My Automator"
1
My Vault> automator list
Copied!
Run the
setup command on the existing automator1
My Vault> automator setup "My Automator"
Copied!
Enable the service
1
My Vault> automator enable "My Automator"
Copied!
Linux Install Method
Please take the following steps to upgrade your service.
(1) Back up your configuration
Back up the folder where you installed Keeper Automator, just in case you need to revert.
(2) Stop the Automator service
Kill the Java process running to stop the service. The method of stopping the service will depend on your environment.
(3) Download the latest Automator Zip
Download and unzip Keeper Automator and place in a temporary folder:
https://keepersecurity.com/automator/keeper-automator.zip​
(4) Replace keeper-automator.jar
From the extracted Zip file, update only the keeper-automator.jar file from the download into your target installation.
(5) Restart Service
Use the method of starting the service as described in the installation instructions. For example,
java -jar keeper-automator.jar(6) Re-initialize the Config from Commander
When you stop/start the Keeper Automator service, you'll need to use Keeper Commander to re-initialize the service endpoint. (Keeper Commander documentation is linked here).
The commands required on Keeper Commander to re-initialize your Automator instance is "
automator setup" and "automator init".1
$ keeper shell
2
​
3
My Vault> automator list
4
288797895952179 My Automator True https://something.company.com:8089
5
​
6
(find the Name corresponding to your Automator)
7
​
8
My Vault> automator setup "My Automator"
9
​
10
My Vault> automator init "My Automator"
Copied!
(7) Test the Approvals
Ensure that device approvals are successful on new devices (incognito window on the web browser is sufficient to test).
Windows Environments
(1) Back up your configuration
Back up the configuration where you installed Keeper Automator, just in case you need to revert.
The 2 folders to back up are:
C:\Program Files\Keeper Security\Keeper Automator
C:\ProgramData\Keeper Automator\
(2) Stop the Automator service
From the Windows Services screen on the server, stop the "Keeper Automator" service.
(3) Download the latest Automator Zip
On the Automator instance, download and unzip the Keeper Automator service zip file:
Run the installer after unzipping the file.
(4) Restart Service
From the Windows Services screen on the server, start the "Keeper Automator" service.
(5) Re-initialize the Config from Commander
When you stop/start the Keeper Automator service, you'll need to use Keeper Commander to re-initialize the service endpoint. (Keeper Commander documentation is linked here).
The commands required on Keeper Commander to re-initialize your Automator instance is "
automator setup" and "automator init".1
$ keeper shell
2
​
3
My Vault> automator list
4
288797895952179 My Automator True https://something.company.com:8089
5
​
6
(find the Name corresponding to your Automator)
7
​
8
My Vault> automator setup "My Automator"
9
​
10
My Vault> automator init "My Automator"
Copied!
(6) Test the Approvals
Ensure that device approvals are successful on new devices (incognito window on the web browser is sufficient to test).
Last modified 1mo ago
Export as PDF
Copy link