How to use Version Management with Github Repository

[rajdeep_marathe]

The Version Management application allows you to manage versions of BI resources that exist in the BI Platform repository. 
We have an Option to use the Version Management Application to Use Subversion or Git/ GitHub as a repository.
In this Blog, we will be checking on how to use the Version Management with Github as an repository

Downloading and Installing the GIT Application

• Download the GIT application from : https://git-scm.com/ 
• Download and install the GIT application on the BO Server. We will need this to configure later.

Configuration of Github 

• Create an Account on Github - > https://github.com/ 
• Create a Public repository on the Github which we want to use for Version Management.

Token Generation in Github and Maintaining the default branch

1. Navigate to the Profile on the https://github.com/settings/profile
2. Scroll Down to <> Developer Setting.
3. Next Select the Personal Access Tokens > Tokens ( classic)
4. Generate new token ( classic)
   
5. Under Scopes Select Repo:
   
   

To check the default Branch. Navigate to Settings and then Repository : https://github.com/settings/repositories 

Master is been set as default

Configuring Version Management in CMC to use Github

1. In CMC Home page, select Applications.
2. Select Version Management.
3. Choose Git from the Version Management Systems list.
4. Click the checkbox Use as Default VMS.
5. Under Protocol use HTTP(s). (HTTP is used if you want to completely use local GIT)
6. Below are the parameters that needs to be maintained. 
   
   
   

   Parameters	Details
   User name	Enter the username of the Github account that was used to create repository
   GitHub personal access tokens (classic)	Enter the token generated above from Github
   GitHub Remote Repository URL	Enter the link to the Repository that was created on Github. <https://github.com/<username>/<Repository Name>
   Workspace Directory	Enter the Path where you want to save your workspace.
   Repository Name	Enter a name for your Github repository. Should be the same that is been created in Github. <Repository Name>
   GIT Install Path	Enter the install directory of Git. <install_dir>\Git\bin
   Default Branch Name	Enter the Default Branch name that is been maintained in your profile on github.

   
   
7. Once all the Details are maintained, Click on SAVE
8. Restart the APS hosting the Version Management Services. 
9. Navigate to the CMC > and access the Version Management Application