Install > Post-installation tasks > Install an Instance of the Marketplace Portal on a Remote System

Install an Instance of the Marketplace Portal on a Remote System

This section describes how to install the Marketplace Portal on a remote system, a system that is not the same system on which the Cloud Service Management Console is installed. The remote system must meet the same system requirements for CSA.

See the Support Matrix for version requirements.

Guides are available on the HPE Software Support web site at: https://softwaresupport.hpe.com (this site requires a Passport ID). Select Dashboards > Manuals.

Complete the following tasks to install and configure the Marketplace Portal on a remote system:

  • Copy the CSA certificate to the remote system.
  • Configure a CSA Group and User.
  • Install a JRE.
  • Install CSA.
  • Remove unneeded .war files.
  • Configure the Marketplace Portal.
  • Start the HPE Marketplace Portal service.
  • Launch the Marketplace Portal.

Note In the following instructions, Windows: %CSA_HOME% and Linux: $CSA_HOME represent the directory in which the Marketplace Portal is installed.

Copy the CSA Certificate

From the system on which CSA is installed, copy the CSA certificate to the system on which the remote instance of the Marketplace Portal will be installed.

On the system on which CSA is installed, the CSA certificate is located in:

Windows: %CSA_HOME%\jboss-as\standalone\configuration\jboss.crt

Linux: $CSA_HOME/jboss-as/standalone/configuration/jboss.crt.

Copy this file to the system on which you are installing the remote instance of the Marketplace Portal. Remember the name and location to which you have copied this certificate as you will be asked for this information when you install the remote instance of the Marketplace Portal.

This file is needed for TLS verification which, by default, is enabled for the Marketplace Portal.

Install CSA for MPP for Windows

Click on the link for information in this guide on how to install CSA with Remote MPP for Windows.

Install CSA for MPP for Linux

Click on the link for information in this guide on how to install CSA with Remote MPP for Linux.

Secure the Marketplace Portal

For security reasons, the Marketplace Portal file system must be protected by the operating system. Do the following:

Windows:

  1. Open an elevated command prompt (a command prompt that is run as the administrator). For example, navigate to All Programs > Accessories. Right-click on Command Prompt and select Run as administrator.

  2. From the elevated command prompt, run the following command:

    attrib +s +h "%CSA_HOME%\portal" /S /D /L

    where

    CSA_HOME is the directory in which CSA is installed

  3. Restart the CSA and HPE Marketplace Portal services.
    For example, navigate to Start > Administrative Tools > Services. Right-click the service and select Restart

Linux:

  1. Log on as the root user.

  2. Run the following commands:

    chown csauser:csagrp $CSA_HOME/portal
    chmod 700 $CSA_HOME/portal

    where csauser and csagrp are the user and group you configured for CSA when you installed CSA and

    CSA_HOME is the directory in which CSA is installed

  3. Log off as root and log on as csauser.

  4. Restart the csa and mpp services by running the following commands:

    service csa restart
    service mpp restart

Update the Marketplace Portal in the Cloud Service Management Console

The URL to launch the Marketplace Portal is displayed in the Cloud Service Management Console. Edit the csa.properties file to update this URL. Do the following:

  1. On the system on which CSA and the Cloud Service Management Console are installed:
    • Windows: edit the %CSA_HOME%\jboss-as\standalone\deployments\csa.war\WEB-INF\classes\csa.properties file.
    • Linux: edit the $CSA_HOME/jboss-as/standalone/deployments/csa.war/WEB-INF/classes/csa.properties file.
  2. Update the csa.subscriber.portal.url property value. Set the hostname to the fully-qualified domain name or IP address of the system on which the Marketplace Portal is remotely installed.
  3. Save and exit the file.

  4. Restart CSA.

    To restart CSA on Windows, complete the following steps:

    1. If you have configured CSA to be FIPS 140-2 compliant, create a CSA encryption keystore password file. The name and location of this file must match the value configured for the keystorePasswordFile property in the
      %CSA_HOME%\jboss-as\standalone\deployments\csa.war\
      WEB-INF\classes\csa.properties       file.

      The password file must contain only the following content: keystorePassword=<CSA encryption keystore password>

      where <CSA encryption keystore password> is the CSA encryption keystore password in clear text.

      This file is automatically deleted when the CSA service is started.

    2. On the server that hosts CSA, navigate to Start > Administrative Tools > Services.

    3. If global search is enabled, do the following:

      1. Right-click on the Elasticsearch 1.6.1 service and select Restart.

      2. Wait for a minute for the Elasticsearch 1.6.1 service to restart, then right-click on HPE Search Service and select Restart.

        Note If global search is disabled, skip this step.

    4. Right-click on the CSA service and select Restart.

    5. Right-click on the HPE Marketplace Portal service and select Restart.

    6. If you installed an embedded Operations Orchestration instance, right-click on the HPE Operations Orchestration Central service and select Restart.

    To restart CSAon Linux, complete the following steps:

    1. On the server that hosts CSA, type the following:

      service csa restart
service mpp restart

    1. If you installed an embedded Operations Orchestration instance, type:

      <embeddedHPEOOinstallation>/central/bin/central stop

      <embeddedHPEOOinstallation>/central/bin/central start

      For example, type:
      /usr/local/hpe/csa/OO/central/bin/central stop
      /usr/local/hpe/csa/OO/central/bin/central start

Launch the Marketplace Portal

Launch the default remote instance of a Marketplace Portal

Launch the default remote instance of the Marketplace Portal by typing one of the following URLs in a supported Web browser:

  • https://<csahostname>:8444/mpp
  • https://<mpphostname>:8089

where:

  • <csahostname> is the fully-qualified domain name of the system on which CSA is installed and the URL in the CSA_HOME\jboss-as\standalone\deployments\mpp.war\index.html file (on the system on which CSA is installed) has been updated to https://<mpphostname>:8089.

  • <mpphostname> is the fully-qualified domain name of the system on which the Marketplace Portal instance resides.

Examples:

  • https://csa_system.abc.com:8444/mpp
  • https://mpp_system.abc.com:8089

The organization associated with the default Marketplace Portal is defined in the CSA_HOME\portal\conf\mpp.json file (on the system on which the Marketplace Portal instance resides). By default, this is the sample organization that is installed with CSA (CONSUMER). To modify the organization associated with the default Marketplace Portal, modify the defaultOrganizationName property value by setting it to the <organization_identifier> of the desired organization, where <organization_identifier> is the unique name that CSA assigns to the organization, based on the organization display name (the organization identifier can be found in the General Information section of the Organizations menu of the Cloud Service Management Console).

Launch an organization-specific remote instance of a Marketplace Portal

Launch an organization's remote instance of the Marketplace Portal by typing the following URL in a supported Web browser:

https://<mpphostname>:8089/org/<organization_identifier>

where:

  • <mpphostname> is the fully-qualified domain name of the system on which the Marketplace Portal instance resides.

  • <organization_identifier> is the unique name that CSA assigns to the organization, based on the organization display name (the organization identifier can be found in the General Information section of the Organizations menu of the Cloud Service Management Console)

Example:

https://mpp_system.xyz.com:8089/org/ORGANIZATION_A

Caution Do not launch more than one organization-specific Marketplace Portal from the same browser session. For example, if you launch ORGANIZATION_A's Marketplace Portal in a browser, do not open a tab or another window from that browser and launch ORGANIZATION_B's Marketplace Portal. Otherwise, the user who has logged in to the Marketplace Portal launched for ORGANIZATION_A will start to see data for ORGANIZATION_B.

Instead, start a new browser session to launch another organization's Marketplace Portal.

Start, Stop, or Restart the Marketplace Portal on the Remote System

Use the following instructions to start, stop, or restart the Marketplace Portal on the remote system.

Windows:

Note: In Windows, this feature is referred to as the HPE Marketplace Portal service.

To start the HPE Marketplace Portal service, do the following:

  1. Navigate to the Services screen (Control Panel > Administrative Tools > Services).
  2. Right-click the HPE Marketplace Portal service and select Start.

To stop the HPE Marketplace Portal service, do the following:

  1. Navigate to the Services screen (Control Panel > Administrative Tools > Services).
  2. Right-click the HPE Marketplace Portal service and select Stop.

To restart the HPE Marketplace Portal service, do the following:

  1. Navigate to the Services screen (Control Panel > Administrative Tools > Services).
  2. Right-click the HPE Marketplace Portal service and select Restart.

Linux:

To stop Marketplace Portal, on the remote system, open a command prompt and type
service mpp stop.

To restart Marketplace Portal, on the remote system, open a command prompt and type
service mpp restart.

Send Help Center feedback