Install SourceConnect Management Console

This chapter describes the procedures required to install the SourceConnect Management Console on Windows and Linux operating systems.

Important: If you are an existing customer, you must upgrade the Management Console by following the steps explained in the Upgrade SourceConnect Management Console chapter.

Install SourceConnect Management Console using Windows Installer

1. Download and initiate the installation of the SourceConnect-8.0-Release.exe file provided by insightsoftware.
2. The prerequisites are pre-selected. Proceed as is or select the Options button to make any changes mentioned here after in the below steps.
3. Select the Metadata Store between PostgreSQL and MS SQL. PostgreSQL is the default value.
4. Enter the folder path in the Configure Log/Cache Location: field to store log and cache files.
5. Select OK and accept the End User License Agreement.
6. If you have selected Postgres SQL as your metadata store, the setup process will automatically begin.
   1. Uncheck Stack Builder and enter your Postgres SQL password during the setup.

      Note: You must finish the Postgres SQL installation before the SourceConnect installation can be completed.

   2. Complete the next few self-explanatory steps. The Custom Setup window appears, select Next.
7. On the SourceConnect Configuration screen, enter the following details for Postgres SQL or MS SQL Connection, based on your selection in Step 3: 
   • SourceConnect server port: Indicates the IIS web server port number where you want the SourceConnect Management Console to run. Change the port number to any other port that is not in use by another application.
   • Username: Indicates the username used to sign in to the PostgreSQL or MS SQL server.
   • Password: Indicates the password used to sign in to the PostgreSQL or MS SQL server.
   • Server: Indicates the server name on which PostgreSQL or MS SQL is running.
   • Database: SourceConnect is the default value, you can update it.
   • Port: Indicates the port on which PostgreSQL is running. (The Port field will not be visible if your metadata store is MS SQL.)
8. Select Yes. The SourceConnect Management Console opens in the default web browser.

Uninstall SourceConnect Management Console using Windows Installer

1. Navigate to the installation location (WebContent and DataExtractUtility) and create backups of the following items:

   1. appSettings.*.json files
   2. Logs folder.
2. Go to Control Panel > Programs and Features.
3. Search for SourceConnect and select Uninstall. The SourceConnect Management Console will be uninstalled.

Install SourceConnect Management Console on Linux

1. Download the SourceConnect.tar.gz software from the SAP Download Center and run it.
2. Copy the file to a folder on the Linux file system using WinSCP or any FTP tool.
3. Extract the contents by running the following command.
   tar -xvf SourceConnect.tar.gz

   The above command will extract all the files to the same location.

4. Run the following command to convert the EOL characters in the shell script.
   For Red Hat Linux: dos2unix ISW_SCT_Linux_Setup.sh
   For SUSE Linux: dos2unix ISW_SCT_Linux_Setup_SUSE.sh
5. Run the following command to grant the execute permission for the shell script.
   For Red Hat Linux: sudo chmod 500 ISW_SCT_Linux_Setup.sh
   For SUSE Linux: sudo chmod 500 ISW_SCT_Linux_Setup_SUSE.sh
6. Now, run the following command to run the script.
   For Red Hat Linux: ./ISW_SCT_Linux_Setup.sh
   For SUSE Linux: ./ISW_SCT_Linux_Setup_SUSE.sh

   A few options are visible in the console.

7. Enter 2 as your choice to install the management console and select Enter.
8. Enter a port number that is not in use by another application on that system and select Enter.
9. Enter the default SSL certificate or your preferred one and select Enter.
10. Enter the default log and cache folder path or your preferred one and select Enter.
11. Enter the preferred metadata store between Postgres SQL and MS SQL and select Enter. Postgres SQL is the default value.
12. Based on whether you have an existing Postgres SQL or MS SQL Database, enter either Y for Yes or N for No.
13. Enter a password that you want to use for the PostgreSQL or MS SQL database, confirm it, and select Enter.The installation begins.
14. Wait for a few minutes for the process to complete.
15. When you see the management console URL with a placeholder for the hostname, it indicates that the console is ready to serve any requests. To confirm the same, run the following command and check if the SourceConnect login page contents are displayed.
    curl -k https://<hostname/IP>:<port>

Uninstall SourceConnect Management Console on Linux

1. Go to the folder where the software scripts are extracted.
2. Now, run the following command to run the script.
   Red Hat: ./ISW_SCT_Linux_Setup.sh
   SUSE: ./ISW_SCT_Linux_Setup_SUSE.sh
3. Out of the available options, enter 1 as your choice to uninstall the management console and select Enter.
4. Based on whether you want uninstall the prerequisites, enter either Y for Yes or N for No.
5. Based on whether you want to continue the uninstall, enter either Y for Yes or N for No. The console will be uninstalled.