LongJump Support Wiki

Service Configuration

From LongJump Support Wiki
Revision as of 23:26, 11 April 2014 by imported>Aeric (→‎Community Site Configuration)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Settings > Service Provider Settings > Service Configuration

Basic Service Configuration

These values define the basic service configuration:

First-Time Service Configuration

Configure the Service Settings and specify Service and Domain names:
Parameter Description Typical Value
Service Name Name of the service provider Financiocorp Services
Prefix for Service Domain Optional, a subdomain name
Learn more: About the Prefix for Service Domain

Allowed characters: a-z, A-Z, 0-9, - (alphanumeric, plus hyphen)

Example: service

Service Domain Name of the service domain, part of the URL
See Domain Name for more information
 mydomain.com
Domain URL

Read Only

Automatically populated, created from Prefix + Primary Service Domain

service.mydomain.com service.otherdomain.com

Subsequent Configuration

These additional parameters become available after the initial configuration is complete.

Parameter Description Typical Value
Recaptcha Private Key After signing up for Google's Captcha implementation of the Captcha service, enter the public and private keys here. (They are used to interact with that service.)
Recaptcha Public Key

Error Notification Email Address An email message is sent to this address when errors occur customer_support@mydomain.com
No Reply Email Address The email address to use for messages sent by the platform, when replies are not permitted systemadministrator@mydomain.com
Help Domain Required field; Domain name for user help; This page is opened in a new browser window when Help is invoked from the platform http://www.mydomain.com/help
Custom Help Domain Optional; If present, it is the domain name for user help;

Can be used with a custom Help URL in Custom Object

http://www.customhelp_mydomain.com

Or, with Help URL http://www.customhelp_mydomain.com/userdefined_object_name

Document Directory File location for Documents /usr/local/
Temp Directory Used as a temporary storage location /temp/

Service Domain

The Primary Service Domain and Alternate Service Domain names are configured in Service Provider Settings and comply with the following guidelines:
  • Service Domain names can contain the following characters:
  • alphanumeric (a-z, A-Z, 0-9)
  • hyphen (-)
  • period, dot, full stop (.), used as the delimiter in the Prefix for Service Domain
Considerations for the Service Domain
  • The Service Domain is required

|-valign="top" |serviceproviderdomain.com | MSPdomain.com |www.abcde.serviceproviderdomain.com

www.abcde.MSPdomain.com |}

Prefix for Service Domain

This defines the subdomain name for the service. The subdomain name can only accept alphanumeric characters or the underscore character.

Examples
Prefix for Service Domain Service Domain Domain URL(Read Only)
www.abc.com www.abc.com
xyz www.abc.com xyz.abc.com
xyz abc.com xyz.abc.com


Help URL and Custom Help Domain

As a Service Provider, you might create a help website to align with a customer's branded instance of the platform. In this case, the URL of this help website would be used as the default Help Domain. When a user clicks the Help link in the platform, this default Help Domain opens in a new browser window.

The Custom Help Domain operates like the Help Domain, however it has an added benefit: it can be combined with the Help URL function to create custom help links for Custom Objects (excludes Built-in or CRM objects).

The following sections describe typical situations and the result when a user clicks the Help Helpicon.gif icon in a Custom Object.

How the Custom Help Domain and Help URL Work
  • The platform automatically checks for http/https protocols; If they are not present, they are prefixed to the Help URL
  • The custom Help URL can be an Absolute URL or it can be combined with the Custom Help Domain as a Relative URL:
  • Absolute URL Example
Custom Help Domain not applicable

(When the Help URL is specified as an absolute URL, this value is ignored)

Help URL for an Inventory object http://www.mydomain.com/help/inventory
Result: Click the Help icon in the Inventory object to invoke help at:
http://www.mydomain.com/help/inventory
  • Relative URL Example
Custom Help Domain www.customhelp_mydomain.com
Help URL for an Inventory object inventory
Result: Click the Help icon in the Inventory object to invoke help at:
http://www.customhelp_mydomain.com/inventory
The Effect of Custom Help Domain and Help URL Settings

Both the Custom Help Domain and the Help URL are optional. These examples describe how user help is provided when these values are specified or omitted.

  • Custom Help Domain and Help URL are specified
    All the specified Help URLs for Custom Objects are treated as relative to Custom Help Domain if they do not start with http:// or https://
Example:
Custom Help Domain www.customhelp_mydomain.com
Help URL inventory
Resulting help URL for the object is: http://www.customhelp_mydomain.com/inventory
Example:
Custom Help Domain www.customhelp_mydomain.com
Help URL http://myhelpdomain.com/inventory

Because the http:// is specified in the Help URL, the Custom Help Domain information is not used

Resulting help URL for the object is: http://myhelpdomain.com/inventory
  • Custom Help Domain is not specified
    The Custom Help URLs for objects are treated as complete URLs and are used to display help
Example:
Custom Help Domain: n/a
Help URL http://myhelpdomain.com/inventory
Resulting help URL for the object is: http://myhelpdomain.com/inventory
  • Custom Help Domain and Help URL are not specified
    A generic help URL is formed using the 'Help Domain' field in Service Provider Settings.
Example:
Custom Help Domain: n/a
Help URL: n/a
Resulting help URL for the object: Reverts to the default Help Domain

Support Service Configuration

This information is published for users to contact you regarding your service.

  • When tenants publish Packages, this email address receives the notification
Parameter Description Typical Value
Support Organization Name of the Support Organization Service Provider Support Team
Support Email Email address to send support requests support@mydomain.com
Available Case Types Picklist of types of support cases

Email Configuration

Configuration for all the emails sent from the LongJump Platform.

Parameter Description Typical Value
Hostname For Relay Server Hostname localhost
User Name User/login name for the email relay server
Password Password related to the user/login name for the email relay server

Bounced Email Configuration

This email configuration will process all the bounced emails sent through the platform. When an email message does not reach the recipient, it is returned (considered "bounced"). This can happen when an email address is no longer active, or because the recipients' email box is full.

Learn more: Bounced Email Configuration for Alternate Service Domains

To enable Bounced Email Processing:

  1. From the Email Configuration section, complete the following information:
  2. Enable Bounced Email Processing
    Click the checkbox Checkboxicon.gif icon to enable processing for bounced email messages and complete the information in the required fields
  3. Optionally, Enable Bounced Email Processing to the Alternate Service Domain
    Click the checkbox Checkboxicon.gif icon to enable processing for bounced email messages and complete the information in the required fields
Parameter Description Typical Value
Enable Bounced Email processing Email Bounce Address Checkbox: Yes/No
Hostname Hostname pop.my_secure_email_provider.net
Mailbox Address Email Mailbox Address bounce@myemailprovider.com
Mailbox Password Specify the password for this email account T0pS3cr3tPa$$word

External Email Tracking Configuration

To enable external email tracking, set the following attributes to initialize the service:

Parameter Description Typical Value
Enable External Email Tracking Option to enable External Email Tracking Checkbox: Yes/No
Hostname Specify the email provider hostname that manages email messaging to/from your site pop.my_secure_email_provider.net
Mailbox Address Specify the email address used for email messaging to your site service@mydomain.com
Mailbox Password Specify the password for this email account T0pS3cr3tPa$$word

Warn.png

Important:
Set up a "catch-all" mailbox in a separate domain to accept messages of the form xyz@your-special-domain.com.

  • Messages are deleted from the mailbox after they are read, so you don't want to use your standard mailboxes.
  • A catch-all mailbox collects everything sent to the specified domain.
    (That way, you don't have to set up a separate mailbox for each user.)
  • Using a separate domain ensures that none of your regular mail goes into the catch-all mailbox.

Learn more: Catch-all mailboxes

Process Workflow by Email Configuration

Workflows can be email-enabled, using these attributes:

Parameter Description Typical Value
Enable Workflow By Email Option to allow Workflow managment via email Checkbox: Yes/No
Hostname Specify the email provider hostname that manages email messaging to/from your site pop.my_secure_email_provider.net
Mailbox Address Specify the email address used for email messaging to your site service@mydomain.com
Mailbox Password Specify the password for this email account T0pS3cr3tPa$$word

Warn.png

Important:
Set up a "catch-all" mailbox in a separate domain to accept messages of the form xyz@your-special-domain.com.

  • Messages are deleted from the mailbox after they are read, so you don't want to use your standard mailboxes.
  • A catch-all mailbox collects everything sent to the specified domain.
    (That way, you don't have to set up a separate mailbox for each user.)
  • Using a separate domain ensures that none of your regular mail goes into the catch-all mailbox.

Learn more: Catch-all mailboxes

Service Theme and Stylesheet

Parameter Description
Theme Select a default Theme; Defines the color for the tabs, background and highlight colors
Allow Users to Change Theme Optionally, allow users to personalize the color scheme for their pages. Checkbox: Yes/No
URL for Custom Style sheet Specify the URL for a CSS (Cascading Style Sheet) that is applied to all pages
UI Container Scripts CSS style sheet declarations, javascript declarations, or any other HTML elements to be included in the header of each page.

Develop Configuration

Java code running in a tenancy is subject to strict limits--or governors:

  • Some settings put limits on the number of resources that tenants can use, to prevent infinite loops and other kinds of runaway programs. The limits apply to each tenant execution interval--from the time that the platform application instance gives control to tenant code, until the time that control returns to the platform. Up to that limit, an application can use as many resources as it wants. But once a constraint is exceeded, the executing code aborts with an exception.
  • Other settings restrict the kinds of Java classes that can be used, to prevent unwarranted access to the server and/or security violations.

The Service Provider Settings can be used to tighten those restrictions, ameliorate them, or lift them entirely.

Considerations
  • Settings are global. They apply to all tenants in the platform instance.
  • Settings apply to scheduled (background) jobs, as well as foreground applications.
  • The minimum for all numeric settings is "1".
  • Changes to these settings take effect only when the platform application instance is restarted.

Here are the default settings:

Parameter Description Default Value
Apply Governors in Java Code? Whether or not governors are applied to this platform instance. A development instance may want to turn them off, in some cases. Any multi-tenant production instance will want them on, to ensure that a runaway program in one tenant does not interfere with other tenants. Yes
Max Number of Statements allowed The maximum number of Java code statements that can be run during an execution interval. 10000


Maximum String Length allowed The total size of all strings allocated in the Java heap space during an execution interval. 30000


Maximum CPU Time allowed (milliseconds) The maximum number of CPU milliseconds that can be consumed during an execution interval. 60000


Java classes not allowed in code There are certain Java classes which are disallowed in tenant classes, to prevent access to the server and any compromise of server security. (They are, however, allowed in global classes developed by the ISV for use by all tenants.)

In order to protect the security of the server, enter a comma-separated list of fully qualified Java Class Names for this option. At compile time, application will check if any of these classes are referenced in the user code and throw an exception if they are. Note that this will take effect only after the server is restarted. 

java.lang.System, 
java.lang.Runtime,
java.lang.Class, 
java.lang.ClassLoader, 
java.lang.Thread, 
java.lang.ThreadGroup, 
java.lang.ThreadLocal, 
java.lang.Runnable, 
java.lang.Compiler, 
java.lang.RuntimePermission, 

java.lang.reflect.AccessibleObject, 
java.lang.reflect.Array, 
java.lang.reflect.Constructor, 
java.lang.reflect.Field, 
java.lang.reflect.Method, 
java.lang.reflect.Modifier, 
java.lang.reflect.Proxy, 
java.lang.reflect.ReflectPermission, 

java.io.FileReader,
java.io.FileWriter, 
java.io.FileInputStream, 
java.io.FileOutputStream, 

java.net.DatagramSocket, 
java.net.DatagramSocketImpl, 
java.net.HttpURLConnection, 
java.net.Inet4Address, 
java.net.Inet6Address, 
java.net.InetAddress, 
java.net.InetSocketAddress, 
java.net.JarURLConnection, 
java.net.MulticastSocket, 
java.net.ServerSocket, 
java.net.Socket, 
java.net.URL, 
java.net.URI, 
java.net.URLClassLoader, 
java.net.URLConnection, 
java.net.URLStreamHandler
Libraries supported in Java Code

When compiling user-defined code, the platform allows certain libraries like jars or internal java packages:

  • If a custom library is required, the jar can be placed in the ../tomcat/lib folder of the Apache Tomcat installation
  • To include these library files, enter a comma-separated list of such jar files for this option
  • Note that this will take effect only after the server is restarted.
 Empty


No. of Objects in Database Views

Database Views allow the creation of custom categories that join multiple objects

  • These database views can be used as the base category for a View or a Report
  • The maximum number of tables that are allowed is five (5), with a default value of three (3)
  • The number of joins in these tables is restricted to the maximum number + 1
 Default: 3, Range is 3-5
Maximum rows in a view

Maximum number of rows that are fetched in a List Display for an object is defined by this option

  • This number is limited by the maximum int value supported by Java/MySQL i.e. 2^16 = 4G
 10000
Maximum rows in a report
  • Maximum number of rows that are fetched in a report
  • This number is limited by the maximum int value supported by Java/MySQL i.e. 2^16 = 4G
 5000
Maximum rows in a Scheduled Report
  • Maximum number of rows that are fetched in a report that runs in the background queue.
  • This number is limited by the maximum int value supported by Java/MySQL i.e. 2^16 = 4G
 5000
Maximum Savepoints Intermediate placemarks, which identify points at which the data fields contain intact, legitimate values 5
Maximum Recursions in Java API Allow a function to call itself the specified number of times 10

Tenant Configuration

This section is used by:
Allow Unauthenticated Tenant Creation
Allows any prospective customer to create a new tenancy (a trial account).
  • Unchecked by default
  • If checked, trial accounts can be created by unauthenticated users who have a computer and network connection that meets the Minimum System Requirements
Enable Tenant Subdomains
This setting lets customers specify a URL subdomain when registering, giving them a unique URL they can use to access their platform applications.
Learn more: Tenant Subdomains

Catalog Configuration

Configuration for application Packages:

Package Catalog URL
The URL of the Application Catalog, where Packages are published.
Default is Service?t=8 (https://na.longjump.com/networking/Service?t=8)
Considerations
  • This is the older format used to display a list of published packages. In this format, only an image and a short description are displayed for each package. The newer Community Marketplace functionality can be selected in the Community section that follows. That format allows more Catalog Information to be displayed for each application package.
  • If you want to use this functionality, you should disable the Community Tenant defined in the next section. Otherwise, you should clear the Package Catalog URL field.
  • The list of Packages available for installation can vary, depending on whether packages are approved for publication, and whether the approval comes from the ISV or the MSP.
  • Packages approved by an MSP are available to MSP users and MSP tenants.
  • Packages approved by the ISV are available to ISV users.
  • By default, such packages are available to MSP users and their tenants, as long as the MSP has Include Global ISV Catalog option enabled in their MSP Settings.
Learn more: Manage Catalog

Community Site Configuration

The community site is not enabled, by default. When enabled, all users in all tenancies supported by an ISV can access and use the Community features.

Community Site settings
Enable Community
Checkbox. Disabled by default. Click it to enable the community feature.
Community Tenancy ID
Read-only display of the Community Tenant ID.
Community Site Name
Read-only display of the name displayed on each community page.
Marketplace Service Domain
The Community Marketplace is a newer format for a list of approved packages that are available for installation. It provides a richer interface than the older Catalog format, and allows much more Catalog Information to be displayed for application packages.
  • Providing a value in this field activates the Community Marketplace.
  • The value can be the service's domain name with an optional subdomain, or the service's IP address.
Considerations
  • The specified domain or IP address must match the Service Domain specified for this installation.
  • If Tenant Subdomains are enabled, a subdomain can be specified using the format {subdomain}.{domain}.
    For example: applicationcatalog.yourService.com.
  • If this value is specified, the Package Catalog URL field in the section above should be cleared.

Global Tenancy

From the designated tenancy, specified objects and the data they contain can be shared with other tenants who have installed a package that contains those objects.

Learn more: Global Data

Global Tenancy ID
The ID of tenant from which objects are shared.
Global Tenancy Shared Object List
A comma separated list of Object IDs that are shared.

Registration Configuration

Choose the default settings for new tenants:

Registration Sidebar
HTML for the Sidebar on the user registration page. (If empty, this section of the registration page is not displayed.)
App Center Sidebar
Specify HTML to display in the Sidebar of the App Center. For example, use it to display images that link to a package catalog, videos, training, and other resources.
Enable App Center
Gives tenants access to the My Applications / App Center functionality.
If enabled:
  • A [My Applications] button appears in the GUI.
  • Clicking it takes the user to the App Center.
  • Installed applications are listed in the My Applications tab
  • The specified HTML is displayed in the Sidebar.
  • The user has access to wizards to create objects, import spreadsheets, and establish Object Relationships.
  • Many-to-Many relationships can be created merely by specifying the desired relationship.
    (The inner Junction Objects are created automatically.)
If disabled:
  • An [Applications] button appears in the GUI.
  • Clicking it displays a dropdown list of applications.
  • A link in that list takes the user to the application Catalog.
  • Wizards are not available.
  • Many-to-Many relationships are established manually, by creating the junction object and creating the appropriate Lookup relationships to the endpoint objects.
URL for Terms of Service
URL of the Terms of Service page, created by the ISV
Optionally, MSPs can supply a URL to a custom Terms-of-Service page. (If empty, this section of the registration page is not displayed.)
Enable Relay for new Tenants
Enable the social-networking application, Relay, so users in a tenancy can form groups, follow posts, and track changes to data. (Each tenant can then turn it on or off in their Company Information settings.)

Starting Application Configuration

  • From this section, choose the starting application for newly registered users.
    Users can change the default starting application at a later time
Retrieved from "https://agileappscloud.info/ljwiki-src/index.php?title=Service_Configuration&oldid=10075"