1. Prerequisites
2. Download and Install CET Developer
3. Configure CET Developer
4. Create a New Workspace
5. Launch Emacs and CET
6. Troubleshooting

CET Developer is the primary application for developing software for CET. It is a desktop application that provides a user-friendly interface for managing source control, launching CET, and editing code. This guide will walk you through the process of installing and configuring CET Developer, as well as creating a new workspace and launching both Emacs and CET.

1. Prerequisites

Before installing CET Developer, ensure you have the following:

• A CET Developer license (available at the Configura Marketplace)
• Account Credentials for MyConfigura, GitLab, and Jira (With a Developer License, GitLab, and Jira are accessible with your MyConfigura credentials.)

Note A MyConfigura account can be created here if needed.

2. Download and Install CET Developer

1. Go to the Download Page.
2. Click the 'Download CET Developer' button on the left side of the page.
3. Run the downloaded installer.
4. Follow on-screen instructions to complete the installation.

3. Configure CET Developer

When launching CET Developer for the first time, you will be directed to the Environment Setup window. Complete the setup process with these steps:

1. Read and accept all license agreements. 

2. Click the 'Download and Install All' button in the 'CET Environment' tab of the Environment Setup Window. This step may require CET Developer to be launched as an administrator.

3. Allow the installation process to finish. CET Developer will automatically switch to the 'Settings' tab once all applications downloaded and installed. 

4. Choose the server closest to your location from the map.

   

5. Type your MyConfigura and Jira credentials in the 'Settings' tab of the Environment Setup Window.

6. Click the login button for both the 'Jira' and 'MyConfigura' sections in the 'Settings' tab to confirm your credentials.

7. Enter your GitLab personal access token in the 'GitLab' section of the 'Settings' tab. If you don't have a GitLab personal access token, click the 'Generate token' button, which will redirect you to the GitLab website to create one. Follow the instructions for creating a personal access token here. Remember, the token must have the 'api' scope.
   

8. Click 'Continue' in the bottom right corner to save your settings and complete the setup process.

4. Create a New Workspace

After installing and configuring CET Developer, create a new workspace:

1. Click the 'Add Workspace' button in the bottom left corner of the CET Developer window. 

2. The name and file location of your workspace can be changed in the top right corner of the workspace editor.
   

3. Allow the workspace editor to refresh branches and repositories. 

4. Choose the repositories to include in your workspace. The 'Base' repository is required and should be selected by default. To include additional repositories, check the box next to the repository name. 

5. Change the Current Branch/Tag of the base repository to the latest version. The naming convention for the latest version is version/XX.X/official. More information about the official workflow for git and CET can be found here. 

6. If you don't have a personal repository set up, click the 'Profile Repo' tab at the top of the Workspace Editor. Then, click the 'Create Profile Repo' button to generate one.

7. Close the workspace editor and wait for the workspace to download. You can view the download progress on the right side of the workspace list. 

5. Launch Emacs and CET

With your workspace created and CET Developer having downloaded all selected repositories, you can begin working in your workspace. To launch Emacs and CET, follow these steps:

1. Ensure your desired workspace is selected in the workspace list.

2. Click the 'Emacs' button in the 'Developer' section of the right menu bar.

   

3. Once Emacs launches, click on the 'boot.cm' buffer and press C-M-u (Ctrl-Alt-U) to launch CET.

   

Troubleshooting

If you have trouble installing or configuring CET Developer, please contact CET Developer Support.