Skip to content

Install Pleasanter in a serverless configuration on Azure App Service using the installer

Overview

This procedure builds a Pleasanter operating environment using the installer. You can also install Pleasanter with the previous procedure, in which you place the modules and set the parameters manually. For the manual installation procedure, see the following page.
Install Pleasanter on Azure App Service with serverless configuration

Target Environment/Version
Web Microsoft Azure App Service
DB Microsoft Azure SQL Database
Runtime stack .NET 10
Pleasanter 1.5.0.0 and later

Limitations

Installation using the installer is for version 1.5.0.0 and later. To install version 1.4.23.3 or earlier, see the manual installation procedure.
Install Pleasanter on Azure App Service with serverless configuration

Prerequisites

  1. You can log in to the Azure Portal.
  2. One instance of Microsoft Azure App Service (Windows/.NET 10) is prepared.
  3. One instance of Microsoft Azure SQL Database is prepared.
  4. The connection string for Microsoft Azure SQL Database is prepared.
  5. The firewall settings for Microsoft Azure SQL Database allow connections from App Service and PC.

Procedure

The construction procedure is as follows.

  1. .NET settings
  2. Install the installer
  3. Set up Pleasanter
  4. Check that Pleasanter is running

1. .NET Settings

  1. Connect to the Azure Portal.
  2. Open App Service.
    The Azure Portal with App Service open
  3. Select the App Service instance you created.
  4. Open "General settings" in the "Configuration" menu and set it as shown in the table below.

    No. Item Setting
    1 Configuration (preview) Click to select
    2 General settings Click to select
    3 Platform 64bit
    4 FTP state Disabled
    5 Always On On (may be shown as "Always connected")
    6 Stack settings Click to select
    7 Stack .NET
    8 .NET version .NET 10 (LTS)

2. Install the Installer

  1. Stop the instance in App Service.
  2. Access Kudu.
  3. Click "Advanced Tools" from "Development Tools" in the left menu of App Service
    The left menu of App Service, with "Advanced Tools" under "Development Tools"
  4. Click the "Go" link
    The "Advanced Tools" screen of App Service, with the link that opens Kudu
  5. Click "Debug console" > "CMD" from the Kudu header menu
    The Kudu header menu, choosing "CMD" under "Debug console"
  6. Install the installer. (Depending on the user, it may be D:\home. In that case, replace the path accordingly.)
    1. Open the NuGet Gallery page for Implem.PleasanterSetup from here and download the .nupkg file from "Download package".
      The NuGet Gallery page for Implem.PleasanterSetup, with "Download package"
    2. Execute the following command to create a folder of your choice to install the installer.
      ※This procedure explains the case of creating C:\home\dotnet-tools.
      mkdir C:\home\dotnet-tools
      
    3. Place the .nupkg file downloaded in 2.4.1 in C:\home\dotnet-tools.
    4. Execute the following command to install the installer.
      dotnet tool install Implem.PleasanterSetup --tool-path C:\home\dotnet-tools --add-source C:\home\dotnet-tools
      
    5. Set the path.
      set PATH=%PATH%;C:\home\dotnet-tools
      

3. Set Up Pleasanter

※By using the installer, the latest version resources are downloaded automatically, and the values of Service.json and Rds.json are set automatically based on the values you enter.

  1. Run the installer by executing the following command.

    pleasanter-setup
    
  2. Enter the directory where you want to install Pleasanter.
    If you want to install it in "C:\home\site\wwwroot", leave it blank and press the Enter key.
    The installer prompt for the directory where Pleasanter is installed

  3. Enter the directory where you want to install CodeDefiner.
    If you want to install it in "C:\home\site\CodeDefiner", leave it blank and press the Enter key.
    The installer prompt for the directory where CodeDefiner is installed

  4. Enter the service name.
    Enter the name of the database created in Azure.
    If you use "Implem.Pleasanter", leave it blank and press the Enter key.
    The installer prompt for the service name

  5. Enter the connection string.
    ※ Enter the full Microsoft Azure SQL Database connection string.
    The installer prompt for the database connection string

  6. Enter the default language.
    Enter the number of the corresponding language.
    The installer prompt for the number of the default language

  7. Enter the default time zone.
    Enter the number of the corresponding time zone.
    The installer prompt for the number of the default time zone

  8. The summary screen is displayed.
    If the entered values are correct, enter y after "Shall I install Pleasanter with this content? Please enter ‘y(yes)' or 'n(no)’. : " and press the Enter key.
    ※The password is masked.
    The installer summary of the entered values, asking whether to install

  9. After execution, a log like the following is displayed.

    Shall I install Pleasanter with this content? Please enter ‘y(yes)' or 'n(no)’. : 
    y
    Download Pleasanter
    Downloaded Pleasanter_1.5.0.0.zip to C:\home\site\Pleasanter_1.5.0.0.zip
    Start setting parameters
    Finish setting parameters
    <INFO> Starter.Main: Implem.CodeDefiner 1.5.0.0
    <INFO> Configurator.OutputLicenseInfo: 
    ServerName:
    Database:
    Deadline: 1/1/0001
    Licensee: 
    Users: 0
    <INFO> Configurator.OutputLicenseInfo: This edition is "Community Edition".
    Type "y" (yes) if the license is correct, otherwise type "n" (no).
    
  10. When "Type "y" (yes) if the license is correct, otherwise type "n" (no)." is displayed, enter y and execute.

    <SUCCESS> Starter.ConfigureDatabase: Database configuration has been completed.
    <SUCCESS> Starter.Main: All of the processes have been completed.
    Setup is complete.
    
  11. When setup is complete, the URL of the Enterprise Edition 90-day trial information page (Japanese) is shown on the screen. A web browser does not open on Azure App Service. Setup is now complete. Continue to the next step.

4. Check that Pleasanter is running

  1. Start the instance in App Service.

  2. Open the Pleasanter login screen in your browser, enter "Login ID: Administrator" and "Initial password: pleasanter", and click the "Login" button.
    The Pleasanter login screen, where the login ID and initial password are entered

  3. After logging in, you are asked to change the password of the "Administrator" user. Enter a password of your choice and click the "Change" button.
    The password change screen for the Administrator user, shown after the first login