Skip to content

installing-abapgit.md

Latest commit

 

History

History
177 lines (124 loc) · 6.6 KB

installing-abapgit.md

File metadata and controls

177 lines (124 loc) · 6.6 KB

Tutorial 1: Installing abapGit in SAP System

Introduction

This tutorial guides you through the process of installing abapGit in your SAP system, which is the first technical step in establishing the SAP-GitHub integration. abapGit is an open-source git client for ABAP that enables version control for your SAP development objects. Following this tutorial sets the foundation for all subsequent integration steps.

Prerequisites

Before beginning this tutorial, ensure you have:

  • SAP NetWeaver 7.40 or higher (7.50+ recommended)
  • Developer authorization in your SAP system
  • SAP_BASIS component with appropriate support package level
  • Required SAP Notes installed (listed in system requirements)
  • Developer access to transaction SE38 or SE80
  • Authorization for Z* development objects

Installation Overview

flowchart TB
    dev[Developer Workstation] -- SAP GUI --> sap[SAP System]
    github[GitHub] -- HTTPS --> proc
    subgraph proc[Installation Process]
        step1[1. Install Standalone Version] --> step2[2. Create abapGit Package]
        step2 --> step3[3. Install Developer Version]
        step3 --> step4[4. Configure SSL Certificate]
        step4 --> step5[5. Verify Installation]
    end
    sap --- proc
Loading

The installation process follows these key steps:

Step-by-Step Installation

Step 1: Install Standalone Version

  1. Open SAP GUI and connect to your SAP system

  2. Launch transaction SE38 (ABAP Editor)

  3. Enter program name ZABAPGIT_STANDALONE and click Create

  4. In the program attributes dialog:

    • Set program type to Executable Program
    • Enter a description like "abapGit Standalone"
    • Click Save

  5. Select appropriate package (local object is fine for initial installation)

  6. Copy the latest standalone abapGit code from the official repository

  7. Paste the code into the editor

  8. Click Save and then Activate (or use keyboard shortcuts Ctrl+S, Ctrl+F3)

Step 2: Create a Package for abapGit

After successfully installing the standalone version in Steps 1-8, you'll need to create a proper package for the developer version of abapGit:

  1. Execute transaction SE80

  2. Select Package from the dropdown menu

  3. Enter $ABAPGIT as the package name (or use your own naming convention)

  4. Click Create

  5. In the package properties dialog:

    • Enter a meaningful description: "abapGit Development Package"
    • Set package type to "Development"
    • Assign to an appropriate transport request
    • Click Save

Step 3: Install Developer Version of abapGit

Now that you have created the package to hold the abapGit objects in Steps 9-13, you can proceed with installing the full developer version:

  1. Execute the standalone version by running transaction SE38 and executing program ZABAPGIT_STANDALONE that you created in Steps 1-8

  2. In the abapGit interface, click on "New Online"

  3. Enter the following details:

    • Git Repository URL: https://github.com/abapGit/abapGit.git
    • Package: $ABAPGIT (the package you created in Steps 9-13)
    • Branch: main (default)
    • Click Create Online Repo

  4. abapGit will show the repository overview with available objects

  5. Click Pull to download and install all objects

  6. Confirm any dialogs regarding package assignment or transport requests

  7. Wait for the installation to complete

Step 4: Configure SSL Certificate for GitHub

With abapGit now installed in Steps 14-20, you need to set up the SSL certificate to enable secure communication with GitHub:

  1. Execute transaction STRUST

  2. Navigate to "SSL client SSL Client (Standard)"

  3. Double-click to open the certificate manager

  4. Click on the Import Certificate button

  5. In the dialog:

    • Enter github.com in the "PSE Object name" field
    • Set options to "Binary" and "Add to certificate list"
    • Click Continue

  6. Navigate to GitHub in your browser and download the SSL certificate:

    • In most browsers, click the lock icon in the address bar
    • View certificate details
    • Export or save the certificate to your local machine

  7. In STRUST, import the downloaded certificate

  8. Save the changes

Step 5: Verify The Installation

After completing the SSL certificate configuration in Steps 21-28, let's verify that your abapGit installation is working correctly:

  1. Create a new program to validate the installation:

    • Execute transaction SE38
    • Create a new program named Z_ABAPGIT_TEST
    • Add the following code:
    REPORT z_abapgit_test.

TRY.
    NEW zcl_abapgit_repo_online( ).
    WRITE: / 'abapGit installed successfully!'.
  CATCH cx_root INTO DATA(lx_error).
    WRITE: / 'Error:', lx_error->get_text( ).
ENDTRY.

  2. Execute the program

  3. Verify that it displays "abapGit installed successfully!"

Verification Checkpoint

Before proceeding to the next tutorial, verify that:

  • You can launch the abapGit program without errors
  • You can see the abapGit repository you created
  • The test program shows a successful connection
  • You don't receive any SSL certificate errors

Common Issues and Solutions

SSL Certificate Problems

Issue: "SSL handshake failed" or "SSL connection failed" errors

Solution:

  1. Ensure you've correctly imported the GitHub certificate in STRUST (Steps 21-28)
  2. Verify your SAP system has the required support packages for SSL
  3. Check if your network allows HTTPS connections to GitHub

Authorization Issues

Issue: "Not authorized" errors during installation

Solution:

  1. Ensure your user has developer authorization
  2. Check SAP_BASIS authorization for required objects
  3. Consult with your SAP Basis team for specific authorizations

Code Activation Errors

Issue: Syntax errors or activation problems

Solution:

  1. Ensure you're using the latest abapGit version
  2. Verify your SAP system meets the minimum version requirements (SAP NetWeaver 7.40+)
  3. Check for any missing dependent objects

Next Steps

Now that you have successfully installed abapGit in your SAP system in Steps 1-31, you're ready to proceed to the next phase of the integration setup:

In Tutorial 2, you'll learn how to create your first ABAP project repository and establish the connection between your SAP development objects and GitHub, utilizing the abapGit installation you've just completed.