SAP Cloud Appliance Library

Advanced Mode: Creating an Appliance

Prerequisites

You are logged on to SAP Cloud Appliance Library and the relevant appliance template is listed under Appliance Templates.

Procedure

With the advanced mode you can create your appliance going through a wizard specifying all appliance configurations.
  1. In SAP Cloud Appliance Library, choose Appliance Templates.
  2. Choose Create Appliance for the appliance template you want to use to create an appliance.

    The system opens the Basic Mode: Create Appliance page.

  3. Choose Advanced Mode to switch from basic to advanced mode of the wizard.
  4. You have two options for selecting an account in the SAP Cloud Appliance Library:
    • To Choose an existing account in the SAP Cloud Appliance Library, from the Accounts dropdown list, select one of the existing accounts, and choose Step 2. The Account dropdown list displays the accounts in SAP Cloud Appliance Library where the appliance template is available in the corresponding cloud provider.
    • To Create a new account in the SAP Cloud Appliance Library, specify the details of your account. Then choose Step 2 to assign users in your account of SAP Cloud Appliance Library and choose Step 3.
      Property Description
      Name Enter a name for the account.
      Description Enter a description for the account. This entry is optional.
      Cloud Provider To connect to your SAP appliance template, you have to select a cloud provider to be the Web service for managing images and virtual machines.
      Access Key ID (appears once Amazon Web Services is selected) Enter the access key ID for the AWS account. Your access key identifies you as the party responsible for service requests.
      Secret Access Key (appears once Amazon Web Services is selected) Enter the secret access key for the AWS account. Each access key has a secret access key associated with it. This key is just a long string of characters (and not a file), which you use to calculate the digital signature that you include in the request.

      Your secret access key is a secret, and only you and AWS should know what it is. Do not e-mail it to anyone, do not include it in any AWS requests, and do not post it on the AWS Discussion Forums.

      Subscription ID (appears once Microsoft Azure is selected) Enter the unique subscription ID (GUID) of your subscription in Microsoft Azure.
      Authorization Type (appears once Microsoft Azure is selected) Select the authorization type to establish the connection to the cloud provider. There are the following types from which you could choose:
      • Standard Authorization
        The standard authorization includes permissions to create and manage appliances including such with Kubernetes clusters.
      • Authorization with Application

        You have to create an application registration and assign the role Contributor to the corresponding application for your subscription. When you select this type, you must specify the following additional Microsoft Azure properties:

        • Azure Active Directory Tenant ID
        • Application (Client) ID
        • Client Secret
      Project ID (appears once Google Cloud Platform is selected) This entry is a customized name for the created project in Google Cloud Platform. It is automatically rendered when the JSON File is uploaded.
      Private Key ID (appears once Google Cloud Platform is selected) This is the private key of your service account from Google Cloud Platform. It is automatically rendered when the JSON File is uploaded.
      JSON File (appears once Google Cloud Platform is selected) With the JSON file you establish a connection between SAP Cloud Appliance Library and Google Cloud Platform. You can get it when you create a service account or for an existing service account you could create a new private key in Google Cloud Platform.

      Browse a JSON file for your project and then choose Upload File.

      For more information about service account keys, see the Google Cloud Platform documentation.

  5. In the Appliance Details step, enter the general properties of the appliance as described in the table below, and then choose Step 4.
    Property Description
    Name Enter a name or a short description for the appliance.
    Description Enter a long text description for the appliance.
    Number of Appliances Enter the number of identical appliances that you want to create.
    Account Select the SAP Cloud Appliance Library account for the appliance. The Account dropdown list displays the accounts for which the relevant SAP appliance template is activated. The users assigned to the account you select can manage the appliance.
    Region Select the region for the appliance.
    Zone (appears when Google Cloud Platform is the selected cloud provider) Select the zone for the appliance.
    Network Select the network where the appliance will be created.
    Subnet Select the subnet from the list of available subnets for the appliance.
    Public Static IP Address Select this property, if you want your appliance to have a static IP address until it is terminated.
    DNS Settings Select the type of domain name you want to use:
    • Do not use a domain name – rely on IP addresses only.

    • Use a default domain name – use the cloud provider mechanisms to provide a domain name for your appliance. This option is available for the following cloud providers: Amazon Web Services and Microsoft Azure.

    • Use own domain name – use a hosted zone registered in your cloud provider account. This option enables the usage of certificates registered in your cloud provider account.

    SAP Cloud Appliance Library provides the option to assign Fully Qualified Domain Names (FQDN) and signed certificates in the following cloud providers: Amazon Web Services, Google Cloud Platform and Microsoft Azure. For more information about this feature, see this guide.
  6. In the Virtual Machines step, configure the parameters of the virtual machines, and then choose the next step.
    • Select Sizes - defined for the SAP appliance template you are using to create an appliance.
      The system distinguishes two types of VM sizes for the cloud providers: SAP Certified and SAP Tested.
      • The certified VM sizes for a appliance template are fully supported on the certified platforms.
      • The tested VM sizes for a appliance template are tested on the platform, but the support remains limited to community support, even if an SAP Cloud Appliance Library subscription is in place.
    • Configure Expandable Storage for the volumes of the virtual machines in your appliance.

      In the Additional Size column, you can add the number with which a volume will be expanded. In the Total column is visualized the sum of both sizes: default and additional size.

    • Configure the Access Points for the virtual machines by choosing from the following actions:
      • To create an access point for a virtual machine, choose Add. The system adds a new row in the table with the access points. Here you specify the following mandatory properties of the access point, to connect to the virtual machine:
        Property Description
        Virtual Machine From the dropdown list, select the virtual machine for which you want to add an access point.
        Service From the dropdown list, select the protocol for the access point.
        Port Range Enter a port or a port range for the access point.
        IP Range Enter an IP range for the access point.
      • To modify the properties of an existing access point for a virtual machine, select an access point and then choose Edit.
      • To allow users to connect to the virtual machines on the selected ports, select an access point and then select the Enabled checkbox.
      • To prevent users to connect to the virtual machines on the selected ports, select an access point and then deselect the Enabled checkbox.
      • To delete an access point for a virtual machine, select an access point, and then choose Delete.
      • If you want to restrict the IP ranges for your appliance choose Restrict Access and select rules that will be applied to all configured access point for the appliance:
        • Custom IP Range – you must specify valid comma-separated IP ranges from which the appliance could be accessed
        • My IP Address – you can access the appliance from your public IP address
  7. The Kubernetes Cluster step appears when the appliance template, from which you will create the appliance, supports Kubernetes cluster. In this step, you can configure the cluster properties: number of nodes in the cluster, its size and the IP range of the access point. Then choose the next step.
  8. In the Appliance Template Password step, enter the master password for the appliance. Then choose the next step.
  9. In the Schedule Details step, define the schedule of the appliance as described in the table below and then choose Review.
    Schedule Option Description
    Time Zone Select the time zone where the schedule is in used.
    Activate and suspend by schedule Select this option if you want to define the schedule of the appliance by using time intervals. This means the user can only use the appliance in the specified time window.

    The required parameters for this schedule option are From, To, and Recurrence.

    • In From, select the time when you want to activate the appliance. This time is in 24 hour format.
    • In To, select the time when you want to suspend the appliance. This time is in 24 hour format.
    • Using Recurrence, select the recurrence interval (Daily, Weekly or Advanced).
    Suspend on an exact date Select this option if you want to configure the exact date and time when the appliance is suspended.
    In Suspend Date, select the date and time when you want to suspend the appliance. This time is in 24 hour format.
    Manually activate and suspend Select this option if you do not want a schedule (time intervals) to be set for the appliance.

    If this option is selected, you can activate or suspend the appliance manually.

    Set the termination date of the appliance Select this option if you want to specify a date and time to terminate the appliance. This means the user can only use the appliance until the specified date and time; the appliance is then terminated.

    In Termination Date, select the date and time when you want to terminate the appliance. This time is in 24 hour format.

  10. In the Summary step, verify the details of the appliance you want to create.

    If you want to change some of the account properties, choose Edit.

  11. Choose Create. The system generates a private key for accessing the appliance and displays it in the Private Key dialog box.
  12. In the Private Key dialog box, you have two options to save the private key:
    • Store the private key in SAP Cloud Appliance Library by choosing Store.
    • Download it locally in a privacy enhanced mail file (.PEM file extension) by choosing Download.

Results

You are redirected from the Appliance Templates tab page to the Appliances tab page. The appliance appears in the list of appliances and the system displays the appliance details and its current status. The screen is refreshed automatically.

You can find the stored private key in the appliance details by choosing Download Key.

To view the access details, choose the name of the appliance. For more information, see Viewing Appliance Access Details.

Basic Mode: Creating an ApplianceEditing an Appliance