The main purpose of this blog post is to list the steps required to provision a Hana SP12 System as a development server, along with XS Advanced runtime components such as the Database Catalog Tool (HRTT) and WebIDE.
Note – In this blog post we will be using command line tools for the installation. However, the last few steps should be applicable to even if you used the GUI.
Prerequisites
In this tutorial, we assume that you have already,
SAP Software Download Center > Download Software > By Alphabetical Index (A-Z) > H > SAP IN-MEMORY (SAP HANA ) > HANA PLATFORM EDITION > SAP HANA PLATFORM EDITION > SAP HANA PLATFORM EDITION 2.0
Note – Make sure you also download the mtaext files for DevX and WebIDE. Alternatively, you could also create these files as show below.
The mtaext file for the DevX components should look like this:
_schema-version: "2.0.0"
ID: com.sap.devx.di.xs2-config1
extends: com.sap.devx.di
modules:
- name: di-core
parameters:
memory: 512M
properties:
JBP_CONFIG_JAVA_OPTS: '[java_opts: ""]'
- name: di-runner
parameters:
memory: 768M
resources:
- name: di-builder-memory
properties:
DI_BUILDER_MEMORY: 512M
The mtaext file for the WebIDE should look like this:
_schema-version: "2.0.0"
ID: com.sap.devx.webide.ext
extends: com.sap.devx.webide
# any change in mtad should be downported to 1SCV repo -com.sap.devx.fassembly/com.sap.devx.fassembly.build/mtad.*
modules:
- name: webide
parameters:
port: 53075
host: webide
memory: 1GB
Now that we have downloaded the required installation files and copied them into the target server, let’s get started with the installation process.
1. Make all files executable.
Run following command as sudo user on target server
cd <installation directory>
chmod -R 777 *
2. Start HDBLCM installation process to install Hana, XSA Runtime
Change directories into the directory which contains the hdblcm tool and run the command given below as sudo user. Using the component_dirs option, provide the paths for the Hana server installation files and the XSA Runtime components separately (comma separated).
If you want to install the HRTT and DevX as part of this step, you need to specify their directories as well. If not, you can install these later.
Note – Web IDE needs to be installed separately.
./hdblcm --component_dirs=<hana server installation directory>,<xsa runtime installation directory>,<additional components directory (hrtt, devx)>
3. Follow installation prompts.
You can select default settings for most options, except maybe the ones given below.
Now that you have installed the Hana Database and XSA Runtime, you can verify the installation. You can do this using the XSA Runtime client tool or using Hana Studio.
4a. Verify using XSA Runtime client tool
4b. Verify using Hana studio
In order to access the Web IDE, Space Enablement Tool and Certificate Administration Tool, you will need to create Role Collections and add them to your users. First step is to find the URL for the XS Advanced Administration and Monitoring tool.
8a. Find the URL for the XS Advanced Administration and Monitoring tool
9. Add space roles to XSA_ADMIN
xs set-org-role XSA_ADMIN SAP OrgManager
xs set-space-role XSA_ADMIN SAP DEV SpaceDeveloper
xs set-space-role XSA_ADMIN SAP DEV SpaceManager
10. Add Github SSL certificate to Web IDE (requried for cloning github repositories)
12. Create DEV users
To access the WebIDE, your dev users need to be granted the WebIDE_Developer role. For this, you can either use the XS Advanced Administration Tool, or run an SQL command in Hana Studio. In this tutorial we will be using Hana Studio. The second requirement is to specify the new dev user as a SpaceDeveloper in the DEV space (or whichever space you created). The steps are given in detail below.
12a. Create new users and add WebIDE developer role
In Hana Studio, open an SQL window as SYSTEM user, and run the following SQL statements.
CREATE USER PASSWORD "InitialPwd1"
SET PARAMETER 'XS_RC_XS_CONTROLLER_USER' = 'XS_CONTROLLER_USER';
ALTER USER SET PARAMETER 'XS_RC_WEBIDE_DEVELOPER' = 'WEBIDE_DEVELOPER';
12b. Add user as SpaceDeveloper
Run the following command in the XSA Runtime Client Tool as XSA_ADMIN user:
xs set-space-role <username> <ORGNAME> <spacename> SpaceDeveloper
Now your new dev users should be able to login to the WebIDE and Catalog Tools.
Note – In this blog post we will be using command line tools for the installation. However, the last few steps should be applicable to even if you used the GUI.
Prerequisites
In this tutorial, we assume that you have already,
- Downloaded the latest version of the Hana Database Server
- Downloaded the latest version of the XS Advanced Runtime
- Downloaded the latest version of the XS Advanced Runtime Additional Components, such as HRTT, DevX and WebIDE. These should be zip files (which contain mtar files of the applications). For example, sap-xsac-hrtt-2.0.8.zip, sap-xsac-di-4.0.9.zip, sap-xsac-webide-4.0.9.zip.
- Copied the installation files into an installation folder in your target server.
SAP Software Download Center > Download Software > By Alphabetical Index (A-Z) > H > SAP IN-MEMORY (SAP HANA ) > HANA PLATFORM EDITION > SAP HANA PLATFORM EDITION > SAP HANA PLATFORM EDITION 2.0
Note – Make sure you also download the mtaext files for DevX and WebIDE. Alternatively, you could also create these files as show below.
The mtaext file for the DevX components should look like this:
_schema-version: "2.0.0"
ID: com.sap.devx.di.xs2-config1
extends: com.sap.devx.di
modules:
- name: di-core
parameters:
memory: 512M
properties:
JBP_CONFIG_JAVA_OPTS: '[java_opts: ""]'
- name: di-runner
parameters:
memory: 768M
resources:
- name: di-builder-memory
properties:
DI_BUILDER_MEMORY: 512M
The mtaext file for the WebIDE should look like this:
_schema-version: "2.0.0"
ID: com.sap.devx.webide.ext
extends: com.sap.devx.webide
# any change in mtad should be downported to 1SCV repo -com.sap.devx.fassembly/com.sap.devx.fassembly.build/mtad.*
modules:
- name: webide
parameters:
port: 53075
host: webide
memory: 1GB
Now that we have downloaded the required installation files and copied them into the target server, let’s get started with the installation process.
1. Make all files executable.
Run following command as sudo user on target server
cd <installation directory>
chmod -R 777 *
2. Start HDBLCM installation process to install Hana, XSA Runtime
Change directories into the directory which contains the hdblcm tool and run the command given below as sudo user. Using the component_dirs option, provide the paths for the Hana server installation files and the XSA Runtime components separately (comma separated).
If you want to install the HRTT and DevX as part of this step, you need to specify their directories as well. If not, you can install these later.
Note – Web IDE needs to be installed separately.
./hdblcm --component_dirs=<hana server installation directory>,<xsa runtime installation directory>,<additional components directory (hrtt, devx)>
3. Follow installation prompts.
You can select default settings for most options, except maybe the ones given below.
- System index: [Install new system]
- Components for installation: [All components]
- Local Host Name: [specify full domain name. eg: hostname.example.company.com]
- SAP HANA System ID: [eg: DEV]
- Database Mode: [single_container]
- System Usage: [development]
- Organization Name: [eg: SAP]
- Space Name: [eg: DEV]
- Routing Mode: [ports]
- XS Advanced components to be installed: [xsac_di_core, xsac_hrtt, xsac_portal_serv, xsac_monitoring, xsac_services, xsac_ui5_fesv2, etc]
Now that you have installed the Hana Database and XSA Runtime, you can verify the installation. You can do this using the XSA Runtime client tool or using Hana Studio.
4a. Verify using XSA Runtime client tool
- Login to server using PuTTY (or SSH) as <sysid>adm (Alternatively, you can use your local XSA Runtime Client tool to login as XSA_ADMIN)
- Login as XSA_ADMIN
- Check XSA CLI version
- Check if apps are installed and running
4b. Verify using Hana studio
- Add the system on Hana studio as SYSTEM user
- Go to the Landscape tab in the system info
- Verify that xsengine, xscontroller, xsuaaserver, etc are running
- Login to server using PuTTY (or SSH) as <sysid>adm (Alternatively, you can use your local XSA Runtime Client tool to login as XSA_ADMIN)
- Login to XSA Runtime as XSA_ADMIN.
- Note – Make sure that you are on the SAP space.
- Replace the path and zip file name with your zip file and run the following command:
- Verify by running the xs apps command. You should see an app named hrtt-core, that is STARTED. This is the Hana Catalog Tool. You should also be able to login to this application as XSA_ADMIN using the specified app URL.
- Run the following command as XSA_ADMIN (same as above). Replace the path and zip file name with your zip file:
- Verify by running the xs apps command. You should see a number of apps starting with di* and devx*
- Run the following command as XSA_ADMIN (same as above). Replace the path and zip file name with your zip file:
- Verify by running xs a command. You should see an app named webide.
In order to access the Web IDE, Space Enablement Tool and Certificate Administration Tool, you will need to create Role Collections and add them to your users. First step is to find the URL for the XS Advanced Administration and Monitoring tool.
8a. Find the URL for the XS Advanced Administration and Monitoring tool
- Login as XSA_ADMIN
- Run the xs version command.
- You should see an application named xsa-admin with an endpoint. Copy this URL and login as XSA_ADMIN.
- Login to XS Advanced Administration and Monitoring tool as XSA_ADMIN
- Open Application Role Builder tile
- Click the three parallel lines (on the left upper side)
- Select Role Collection
- Click on the + at the bottom
- Provide Role Collection name (e.g. WebIDE_DEVELOPER, WebIDE_ADMIN) and click on Create button
- Once you have created the two Role Collections, click Save at the bottom of the screen
- Go to Application Role tab
- Select webide!i1
- Select the WebIDE_Developer Role
- Click Add to Role Collection
- Select WebIDE_DEVELOPER and click OK
- Do the same for WebIDE_ADMIN
- Click Home button
- Go to User Management tile
- Click on XSA_ADMIN user
- Go to Role Collections tab
- Click Add button
- Add WebIDE_DEVELOPER and WebIDE_ADMIN
- Click Save button at the bottom of the screen
9. Add space roles to XSA_ADMIN
xs set-org-role XSA_ADMIN SAP OrgManager
xs set-space-role XSA_ADMIN SAP DEV SpaceDeveloper
xs set-space-role XSA_ADMIN SAP DEV SpaceManager
10. Add Github SSL certificate to Web IDE (requried for cloning github repositories)
- Export github.wdf.sap.corp SSL certificate using a browser as a Base64 encoded, CER (X.509) file
- Find URL for Certificate Administration Tool (di-cert-admin-ui) and login as XSA_ADMIN
- Upload github SSL certificate
- Now you should be able to clone your github repositories
- Find URL for Space Enablement Tool (di-space-enablement-ui) and login as XSA_ADMIN
- Click Enable button for DEV space (this process might take a few minutes to complete)
- Now you should be able to run builds in the Web IDE
12. Create DEV users
To access the WebIDE, your dev users need to be granted the WebIDE_Developer role. For this, you can either use the XS Advanced Administration Tool, or run an SQL command in Hana Studio. In this tutorial we will be using Hana Studio. The second requirement is to specify the new dev user as a SpaceDeveloper in the DEV space (or whichever space you created). The steps are given in detail below.
12a. Create new users and add WebIDE developer role
In Hana Studio, open an SQL window as SYSTEM user, and run the following SQL statements.
CREATE USER PASSWORD "InitialPwd1"
SET PARAMETER 'XS_RC_XS_CONTROLLER_USER' = 'XS_CONTROLLER_USER';
ALTER USER SET PARAMETER 'XS_RC_WEBIDE_DEVELOPER' = 'WEBIDE_DEVELOPER';
12b. Add user as SpaceDeveloper
Run the following command in the XSA Runtime Client Tool as XSA_ADMIN user:
xs set-space-role <username> <ORGNAME> <spacename> SpaceDeveloper
Now your new dev users should be able to login to the WebIDE and Catalog Tools.
No comments:
Post a Comment