Saas DagKnows proxy setup instructions

Clone the DK Proxy repository from GitHub to the local system using the following command. This step is crucial to obtain the latest version of DK Proxy and its associated files.

Prepare the instance for DK Proxy. This involves navigating to the appropriate directory, updating the package lists, installing the 'make' tool, and running the preparation script.

For Ubuntu Instance use the following commands:-

Install the DagKnows Command Line Interface (CLI). This tool provides wrappers for interacting with DagKnows and managing proxies. The force reinstall option ensures the latest version is installed.

Add the executable path to the environment variable

1. Log into DagKnows UI
2. Go to Settings
3. Look for "Generate access token"
4. Enter a label in the label box. No special characters.
5. Specify a period (e.g. 1 year)
6. Click Generate
7. Verify the token shows up in the table below.
8. Copy the token by clicking copy button

Configure the DagKnows CLI by providing an access token. This step involves specifying the host address for the SaaS instance where DagKnows is running (this can vary for onprem or custom installations) and entering the access token obtained from the app's settings page. DAGKNOWS_SERVER_URL must be https even if when using IP address.

Create a new proxy or use an existing one. First, list available proxies, then create a new one with a unique label or select an existing proxy.

The following command actually creates a proxy in the k8s.

Keep proxynamespace same as LABEL, the one that you assigned to the proxy.

Retrieve and install a basic .env file for the proxy. This file contains necessary configurations for the proxy to connect to the SaaS instance.

1. Log into DagKnows
2. Go to Settings
3. Click on the Proxies tab on the top
4. Look for the table "Proxy Roles"
5. Add a role label. e.g. admin, superuser etc. No special characters.
6. Click Add

1. Log into DagKnows
2. Click on "User Management" in left navbar
3. Click on the user ID you want to assign roles to
4. Click on "Modify settings"
5. On the right side the user details, look for Proxy Roles and select a role to assign on a proxy
6. Click modify
7. Ensure that the user now has the role assigned

1. Log into DagKnows
2. Click on "Adjust Settings" in left navbar
3. If desired, click on the toggle button next to "Auto Exec" if it is not enabled
4. If desired, click on the toggle button next to "Send Execution Result to LLM" if it is not enabled

1. Create a runbook with some simple command
2. Try executing it, the command will execute on the proxy