Settings of Service Apps in Service Manager

Last modified on 2023/12/20 14:33

Service Manager : Version 2022 - Build 2022.1.109.0.03+

The setting screen is used to manage the Service Apps tenant and configure Service Apps team management rules.

  • The tenant is a secure cage in Service Apps containing all of the customer's Service Apps data and apps.
  • A single Service Manager user account is defined as the Service Apps platform administrator.
  • Teams are groups of users authorized to access the same Service Apps apps with the same rights. 

Conditions for accessing the setting screen

  • On-premises or SaaS-based customers with a user profile without a tenant
    • No configuration action can be performed on Service Apps administration.
               Screen for user without tenant.png
  • On-premises or SaaS-based customers with a user profile with a tenant
    • They can modify the logo in the login window and App Gallery in Service Apps. Open url.png See the procedure
    • They can access the options for managing the password reset procedure. Open url.png See the procedure
    • The Service Manager user account defined as the Service Apps platform administrator can be modified.
    • Service Apps team creation rules can be defined.
               Screen for user with tenant.png
  • On-premises customers with a Service Manager platform administrator profile with a tenant
    • They can perform all configuration actions on Service Apps administration.
    • The Service Manager user account defined as the Service Apps platform administrator can be modified.
    • Service Apps team creation rules can be defined.
    • They can modify the logo in the login window and App Gallery in Service Apps. Open url.png See the procedure
    • They can access the options for managing the password reset procedure. Open url.png See the procedure
    • They can manage aliases in the dedicated tab.

Notes

  • When you modify information on the Service Apps tenant, you do not need to restart the smoServer service.
  • Service Apps tenant management can also be performed in Service Apps, with limited options. You do this in the Admin Panel > Tenant Management.
  • The Administration > Service Apps > Teams / Users screens are only accessible in read mode, irrespective of the logged-in user profile.
    • You can manage team members and access rights to apps for each team in Service Apps by selecting Teams Management in the Admin Panel.
    • You can manage users, user profiles and access rights to apps for each user in Service Apps by selecting Teams Management in the Admin Panel.
  • The Service Apps tenant is associated with a single Service Manager account. This involves a single Service Apps tenant for the two accounts 50004 (production environment) and 50005 (development environment), and therefore a single URL for the two accounts.

Caution

  • For SaaS-based customers, you must submit a request to the EasyVista CMC team in order to modify the logo to be displayed in Service Apps or to modify the method for the password reset procedure.
        Open url.png See the conditions for accessing the setting screen

Best Practice

  • If you want to have two tenants, and consequently, use two distinct URLs for the two accounts 50004 and 50005, please contact your EasyVista consultant.
  • You should delete old application history logs to free up disk space and optimize platform performance. You can specify the storage duration via the Executed Applications' History Duration field.

   •   Only for on-premises customers with a Service Manager platform administrator profile with a tenant.

  • SaaS customers must submit a request to the CloudOps team via the customer portal.

Menu access

Administration > Service Apps > Parameter Settings

Description of tabs

          Screen for administrator with tenant.png

Platform tab

   List of visible and modifiable fields only by on-premises customers with a Service Manager platform administrator profile with a tenant

Name: Name of tenant.

FQDN: Fully Qualified Domain Name of the tenant, corresponding to the folder name of the tenant on the drive, in the following format: com.folder_name.

Hostname: Hostname of the tenant, corresponding to the last subdomain.
          https://{hostname}.{domain}.com

Log Level: Used to select the types of logs to be received when errors are detected on the Service Apps platform.

  • Platform mode (default mode): The parameters used are those defined in the log.ini file.
  • Custom: The parameters used are managed via the tenant. They enable you to select the types of logs you want, e.g. actions, information, errors or warnings.

Maintenance: Used to indicate whether the Service Apps platform is currently undergoing maintenance (box is checked) or if the platform is available (box is not checked). If the box is checked, when users log on, the login window will be replaced by a maintenance message.

Private Key / Password: Private key and password required for authenticating and calling contextual Service Apps apps from Service Manager forms.

Executed Applications' History Duration: Used to define the storage duration for application history logs.

  • By default, logs are stored for 12 months.

   List of visible and modifiable fields only by on-premises and SaaS-based customers with a user profile with a tenant

App Center Manager: Service Manager user account defined as the Service Apps platform administrator, i.e. App Center Manager profile.

  • The Service Apps platform administrator is the only one who can access user and team management in Service Apps via the Admin Panel.

Logo: Logo displayed in the Service Apps login window and in the App Gallery. Open url.png See the procedure

  • Only standard Web image formats are accepted, e.g. PNG, JPEG.

Forgot your password: Used to select the method you want to use when a password is forgotten.

  • Enable: This displays the default link, Forgot your Password? used to run the standard procedure.
  • Disable: No link is displayed.
  • Overwrite: This replaces the default link with a URL you can customize.

Teams Creation Settings: Rules for managing teams based on Service Manager data.

  • Create User's Groups as Teams:
    • New Service Manager groups for the user will be added as Service Apps teams.
    • The names of existing teams will be updated in the company language.
  • Create User's Profile as Teams:
    • New user profiles will be created as Service Apps teams. 
    • The names of existing profiles will be updated in the company language.
  • Create User's Language as Teams:
    • New user languages will be created as Service Apps teams. 
    • The names of existing languages will be updated (language name = LANGUAGE_SYSTEM_ALIAS column). 
  • Delete Removed Groups and Profiles from Teams:
    • Teams associated with groups or profiles that no longer exist in Service Manager will be deleted.
       

Save: Used to save the Service Apps tenant configuration.

Create Teams: Used to create all teams immediately based on the management rules.

Delete Teams: Used to delete all teams immediately based on the management rules.

Alias tab

Alias Name: Name of the alias.

Hostname: Hostname of the alias.

Created on: Creation date of the alias.

Procedures

How to configure the Service Apps tenant

Step 1: In Service Manager, select the Service Apps platform administrator 

1. Log in to Service Manager.

2. Select Administration > Service Apps > Parameter Settings in the menu.

3. Select the Service Manager user to be defined as the Service Apps platform administrator by selecting the App Center Manager box.

4. Click Save.
 

Step 2: In Service Apps, check that the tenant is correctly configured

1. Log in to Service Apps using the Service Apps administrator account.

2. Check that the user has administrator rights and can access the Admin Panel.

          Access to Service Apps Admin panel.png

How to customize the logo in the login window and App Gallery

CustomizeLogoProcedure

   You must be authorized to access the Administration > Service Apps > Parameter Settings menu in Service Manager via your profile.

1. Go to the /var/www/argo/dist/resources/theme/logo folder on your server.

2. Replace the image file with your logo file.

  • Only standard Web image formats are accepted, e.g. PNG, JPEG.

Caution:

  • You must not modify the name of the image.
  • You must clear the cache or log out and log in again to apply the changes.

Best Practice icon.png  Download an image whose width is greater than its height. This is because even though there are no restrictions on image dimension and size when downloading, the image will automatically be cropped or modified to fill the available space.

Login window App Gallery
Logo updating - Login page.png Logo updating - Gallery.png
Tags:
Powered by XWiki © EasyVista 2024