Installing Obfusware AG

Notes

Obfusware experience: Beginner
Requirements:
A Windows, MacOS, or Linux computer with internet browser
Preparing for Obfusware AG Installation
Approximate time to complete: 60 minutes (depending on state of existing environment)
Last updated: 15 Aug 2025

Overview

Installing Obfusware has a few steps needed to get Obfusware installed into your AWS environment including downloading Obfusware AG, getting a valid Obfusware AG license file, and installing into the AWS environment.

Downloading Obfusware AG

Obfusware products are available on the Obfusware website on the Download page. You can download Obfusware AG by simply visiting the page and selecting the latest version of Obfusware AG.

Obfusware website download page: Obfusware Downloads

Obfusware License File

Purchased license

If your organization has purchased Obfusware AG, it will have received a license file. You need to have access to the file and put it on the computer you will be using to install Obfusware AG to your AWS environment. Your license file will be named similar to obfusware-companyname.lic

Free license (30 day)

You may also have a 30 day Free License. If you have received a free license the license file will be named similar to obfusware-companyname-yy-mm-dd.lic, where yy-mm-dd is the date the license will expire.

Requesting a Free license (30 day)

You can request a free license on the Obfusware website using the Free Trail Request form at: Free Trial Request

Running the Obfusware AG installation file

You can run the Obfusware AG installation from any location on the filesystem of your computer. It is easiest to locate both the install file (obfusware_installer_3_0.pyz) and your license file (obfusware-companyname.lic) in the same directory.

Checking the installation configuration

Obfusware using a command line tool to run the installation.

Run the following command: python obfusware_installer.pyz --verbose verify

The output should display your AWS account, region and a unique id. For example:

AWS account: 381492123456
AWS region: us-east-1
AWS S3 unique-id : 381492123456-us-east-1

Installing Obfusware AG in the AWS environment

The installation is done is 4 stages. First the installation configuration is verified, then the Obfusware product files are generated by the obfusware installer, then the files are sync’ed to AWS S3, and finally entities such as roles are created.

1. The first stage is the same as the verify command run when checking the installation configuration.

2. During the second stage, the generated obfusware files are stored in the in the .obfusware/ directory located in the user home directory (for instance /users/username).

3. In the third stage of the installation the files are sync’ed to an S3 bucket (such as: s3://obfusware-381492123456-us-east-1).

4. The fourth stage creates any AWS entities needed by Obfusware suach as the ObfuswareGlueRole role in AWS IAM.

To run the installation, run the following command:

python obfusware_installer_3_0.pyz --verbose install -l ./obfusware-touissetservices.lic`

The output should display status from each of the 4 stages of installation. For example:

Installing Obfusware to the AWS Glue account...
Verifying AWS command line tool and AWS services...
AWS account: 381492123456AWS
region: us-east-1
AWS S3 unique-id : 381492125655-us-east-1
Verifying AWS command line tool installation and configuration...
Verifying access and configuration to the AWS account and/or the AWS s3 service...
Verifying AWS Glue Setup...
AWS tools installation, configuration and access verification SUCCEEDED
Generating Obfusware directory and contents...
Moving existing Obfusware directory(/Users/username/.obfusware-aws) to /Users/username/.obfusware-aws-20250730_122756
Generating Obfusware directory(/Users/username/.obfusware-aws/3.0) contents
Copying Obfusware license(./test-obfusware-license.lic) to Obfusware directoryGeneration of Obfusware configuration and code directory COMPLETED
/Users/username/.obfusware-aws/3.0
Synchronizing Obfusware directory contents to AWS...
Synchronizing Obfusware config directory contents to Obfusware bucket(s3://obfusware-381492123456-us-east-1/3.0/config)...
Synchronizing Obfusware jars directory contents to Obfusware bucket(s3://obfusware-381492123456-us-east-1/3.0/jars)       This operation may take up to 1-2 minutes depending on upload speed...
Synchronizing Obfusware python directory contents to Obfusware bucket(s3://obfusware-381492123456-us-east-1/3.0/python)...
Synchronizing Obfusware resources directory contents to Obfusware bucket(s3://obfusware-381492125655-us-east-1/3.0/resources)...
Synchronizing Obfusware transforms directory contents to AWS Glue bucket(s3://aws-glue-assets-381492123456-us-east-1/transforms)...
Synchronization of Obfusware directory contents to AWS SUCCEEDED
Creating Obfusware AWS entities...
Creating Obfusware AWS roles...
Obfusware AWS entities creation SUCCEEDED
Installation of Obfusware to AWS Glue SUCCEEDED
success

Congratulations on successfully installing Obfusware to your AWS environment.

Error

If you receive any error running the install command which you cannot rectify, please contact Obfusware support at support@obfusware.com:

Please include:

• Operating System you are using (Windows 10, Windows 11, MacOS, or Linux including the version number
• The name of the Obfusware installer (i.e. obfusware_installer_3_0.pyz)
• The directory where you ran the command.
• The full command you used including all arguments
  

   python obfusware_installer_3_0.pyz --verbose install -l ./obfusware-company.lic`

• All the text output from running the install command.