User Manual

12.03.2025

MANUAL

Install Pleasanter in a serverless configuration on Azure AppService using the installer

## Overview This procedure is for building a Pleasanter operating environment using the "Installer". You can also install it using the previous procedure of manually placing modules and setting parameters. Please refer to the following for manual installation procedures. [Install Pleasanter on Azure AppService with serverless configuration](getting-started-pleasanter-azure) | Target | Environment/Version | | ------------------ | :--------------------------- | | Web | Microsoft Azure AppService | | DB | Microsoft Azure SQL Database | | ランタイムスタック | .NET8 | | Pleasanter | 1.4.0.0 or later | ## Limitation 1. Installation using the "Installer" is for version 1.4.0.0 or later. Please refer to the manual installation procedures when installing version 1.3.50.2 or earlier.<br/> [Install Pleasanter on Azure AppService with serverless configuration](getting-started-pleasanter-azure) ## Prerequisites 1. You can log in to the Azure Portal. 1. One instance of Microsoft Azure App Service (Windows/.NET8) is prepared. 1. One instance of Microsoft Azure SQL Database is prepared. 1. The connection string for Microsoft Azure SQL Database is prepared. 1. 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 1. Install the installer 1. Set up Pleasanter 1. Check that Pleasanter is running ## 1. .NET Settings 1. Connect to the [Azure Portal](https://portal.azure.com/). 1. Open App Service. ![image](https://pleasanter.org/binaries/90ff8944d431483da62410cdf5f90100) 1. Select the App Service instance you created. 1. Open "General Settings" in the "Configuration" menu and set it as shown below. ![image](https://pleasanter.org/binaries/3522234ddfd34a649998544be0d76b9e) |Column|Settings| |:--|:--| |.NET version|.NET 8 (LTS)| |Platform|64bit| |FTP status|Disabled| |Always connected|On| ## 2. Install the Installer 1. Stop the instance in App Service. 1. Access [Kudu](https://learn.microsoft.com/en-us/azure/app-service/resources-kudu#access-kudu-for-your-app). 1. Click "Advanced Tools" from "Developer Tools" in the left menu of App Service ![image](https://pleasanter.org/binaries/9e9a929cb8174c9f81ac9a25479890c4) 2. Click the "「Move」" link ![image](https://pleasanter.org/binaries/8639e642c6ed4b07b1b86538b8394a9f) 3. Click "Debug console" > "CMD" from the Kudu header menu ![image](https://pleasanter.org/binaries/8d9aeb33b8b94c62a787d8adca8360c8) 4. Install the installer. (Depending on the user, it may be D:\home. In that case, please read accordingly.) 1. Open the Nuget Gallery for Implem.PleasanterSetup from [here](https://www.nuget.org/packages/Implem.PleasanterSetup/) and download the .nupkg file from "Download package". ![image](https://pleasanter.org/binaries/3566ffc5937a42f4b78b0e055375db87) 1. Execute the following command to create a folder of your choice to install the installer. ※This procedure explains how to create 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. Setting up Pleasanter ※By using the installer, the latest version resources will be automatically downloaded and the values ​​of Service.json and Rds.json will be automatically set based on the values ​​you entered. 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 Enter. ![image](https://pleasanter.org/binaries/46659c2b54c742dc9e5aeb5f5cd6d9a6) 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 Enter. ![image](https://pleasanter.org/binaries/b8a1d7a4616b4fc5b7a872c680f6c88d) 4. Enter the service name. Enter the database name created in Azure. If you are using "Implem.Pleasanter", leave it blank and press the Enter key. ![image](https://pleasanter.org/binaries/ea914e6198a64929896e692a7b75b93b) 5. Enter the connection string. ※ **Enter the full Microsoft Azure SQL Database connection string.** ![image](https://pleasanter.org/binaries/c83469f26e20478982be1f0d8b114e95) 6. Enter the default language. Enter the number of the corresponding language. ![image](https://pleasanter.org/binaries/641ecae4738f48759264e47203344901) 7. Enter the default time zone. Enter the number for the corresponding language. ![image](https://pleasanter.org/binaries/cd3fc0ac4c304d8ca64b555bdf9e592b) 8. The summary screen will be 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 Enter. ※The password is masked. ![image](https://pleasanter.org/binaries/ce61dd3fe78446cf972c4bd5986b1308) 9. After execution, the following log will be displayed. ``` Shall I install Pleasanter with this content? Please enter ‘y(yes)' or 'n(no)’. : y Download Pleasanter Downloaded Pleasanter_1.4.11.0.zip to C:\home\site\Pleasanter_1.4.11.0.zip Start setting parameters Finish setting parameters <INFO> Starter.Main: Implem.CodeDefiner 1.4.11.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 the message "Type "y" (yes) if the license is correct, otherwise type "n" (no)" appears, 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, a web browser will launch and display the [Enterprise Edition trial information page](https://pleasanter.org/pleasanter-extensions-trial/?utm_source=installer&utm_medium=app&utm_campaign=extension-trial&utm_content=route01). ![image](https://pleasanter.org/binaries/09ac5817d8174ecb8f311ec769caf54b) ## 4. Check that Pleasanter is running 1. Start the instance in App Service. 1. Open the Pleasanter login screen in your browser, enter "Login ID: Administrator" and "Initial password: pleasanter", and click the "Login" button. ![image](https://pleasanter.org/binaries/5477647dc121413190827affdc7fa1ff) 1. After logging in, you will be asked to change the "Administrator" user password, so enter a password of your choice and click the "Change" button. ![image](https://pleasanter.org/binaries/d57262564d8e49568553a84b273d3797)
TOP