Futurama Logo

Welcome to the Futurama Support Site

The Futurama Support Site is the website where you can find Futurama and Futurama Vision documentation. If you have any questions about the support pages or if you want to provide us feedback please send us an e-mail.




Index Installation Futurama Server
Previous  |  Next

 1      About Futurama
 1.1        Version information
 1.2        Getting Started
 1.2.1          Futurama Website
 1.2.1.1            Behavior of Futurama regarding TimeOuts, Login and Logoff
 1.2.1.2            Replacing an existing Futurama Session
 1.2.2          Futurama Webservice
 1.2.2.1            warmUpDocuments
 1.2.3          Futurama Export
 1.3        Overview - Futurama Modules
 1.3.1          Overview - Futurama Accounts
 1.3.2          Overview - Futurama Server
 1.3.3          Overview - Futurama Monitor
 1.3.4          Overview - Futurama Insight
 1.3.5          Overview - Futurama Console
 1.3.6          Overview - Futurama Webservice
 1.4        Loadbalancing Futurama applications
 1.4.1          Getting the most out of Futurama Web using the Load-Balancer
 1.4.2          Application Request Routing
 1.5        Text management and Multi-language
 2      Installation – Configuration – Testing
 2.1        Installation - Futurama Website Edition
 2.1.1          Installation Futurama HTML
 2.1.2          Installation Futurama Monitor
 2.1.3          Installation Futurama Insight
 2.1.4          Installation Futurama Accounts
 2.1.5          Installation SAML2LoadBalancer
 2.2        Installation - Futurama Export Edition
 2.2.1          Installation Futurama Console
 2.2.2          Installation Futurama Server
 2.3        Installation - Futurama Webservice Edition
 2.3.1          Installation Futurama Webservice
 2.4        Installation Futurama Editor
 2.5        Configuration
 2.5.1          Configuration - Cache
 2.5.2          Configuration - Calculation
 2.5.3          Configuration - Debug
 2.5.4          Configuration - File manager
 2.5.5          Configuration - Fileproviders
 2.5.6          Configuration - Format
 2.5.7          Configuration - History
 2.5.8          Configuration - Identity Provider
 2.5.9          Configuration - Log
 2.5.10           Configuration - Mail
 2.5.11           Configuration - Mapping
 2.5.12           Configuration - Monitor
 2.5.13           Configuration - PlugIns
 2.5.14           Configuration - Rendering
 2.5.15           Configuration - ScenarioRecording
 2.5.16           Configuration - Security
 2.5.17           Configuration - Server
 2.5.18           Configuration - Vision
 2.5.19           Configuration - WebAPI
 2.6        Logging
 2.7        Troubleshooting
 2.8        Security - hardening
 3      Updating and file compatibility
 3.1        Updating Futurama - Compatibility behavior
 3.2        Converting Futurama documents
 3.3        12819 - DataTable file updates
 3.4        12889 - DataTable file updates
 3.5        Conversion web.config to .NET Framework 4
 3.6        Deprecated conversion formulas
 4      Futurama Editor - How to
 4.1        At first glance
 4.2        Developing in the Futurama Editor
 4.2.1          Working with objects
 4.2.2          Evaluating objects
 4.2.3          Finding objects
 4.3        Transferring objects
 4.4        Testing objects
 4.5        Validating objects
 4.6        Troubleshooting objects
 4.7        Advanced/special functionality
 4.8        Checking the layout of objects
 5      Futurama - Formulas
 5.1        Futurama Formulas - Date and time
 5.1.1          Date
 5.1.2          Day
 5.1.3          Days360
 5.1.4          Days360Excel
 5.1.5          DaysInMonth
 5.1.6          DaysInPeriod
 5.1.7          Min
 5.1.8          Max
 5.1.9          Month
 5.1.10           Now
 5.1.11           WeekDay
 5.1.12           Year
 5.2        Futurama Formulas - Math
 5.2.1          Abs
 5.2.2          Add
 5.2.3          Divide
 5.2.4          Floor
 5.2.5          Ln
 5.2.6          Log
 5.2.7          Log10
 5.2.8          Mod
 5.2.9          Multiply
 5.2.10           Pi
 5.2.11           Power
 5.2.12           Rand
 5.2.13           Round
 5.2.14           RoundDown
 5.2.15           RoundUp
 5.2.16           SquareRoot
 5.2.17           Subtract
 5.3        Futurama Formulas - Statistical
 5.3.1          AverageDeviation
 5.3.2          Beta
 5.3.3          Binomial
 5.3.4          Covariance
 5.3.5          Factorial
 5.3.6          Gamma
 5.3.7          GeometricMean
 5.3.8          Lognormal
 5.3.9          Max
 5.3.10           Median
 5.3.11           Min
 5.3.12           Normal
 5.3.13           StandardDeviation
 5.3.14           Uniform
 5.3.15           Variance
 5.4        Futurama Formulas - Text
 5.4.1          CalculateBase64Hashcode
 5.4.2          CalculateXmlHashcode
 5.4.3          Concatenate
 5.4.4          ConcatenateBase64
 5.4.5          ContainsText
 5.4.6          Convert.CSV.2.XML
 5.4.7          ConvertFromBase64
 5.4.8          ConvertToBase64
 5.4.9          ConvertXml
 5.4.10           DecodeURL
 5.4.11           DecryptXml
 5.4.12           EncodeURL
 5.4.13           EncryptXml
 5.4.14           Find
 5.4.15           HashBase64EncodedFile
 5.4.16           HashBase64EncodedFileWithBase64
 5.4.17           HashText
 5.4.18           HashTextWithBase64
 5.4.19           Left
 5.4.20           Len
 5.4.21           Linefeed
 5.4.22           Lower
 5.4.23           Mid
 5.4.24           Proper
 5.4.25           ReadConfigKey
 5.4.26           ReadDirectoryNames
 5.4.27           ReadFile
 5.4.28           ReadFileAsBase64
 5.4.29           ReadFileNames
 5.4.30           ReadFileWithEncoding
 5.4.31           ReadXPathScalar
 5.4.32           ReadXPathVector
 5.4.33           Repeat
 5.4.34           Right
 5.4.35           Substitute
 5.4.36           Trim
 5.4.37           TrimLeft
 5.4.38           TrimRight
 5.4.39           Upper
 5.4.40           ValidatePattern
 5.4.41           XsdMessages
 5.5        Futurama Formulas - Logical
 5.5.1          And
 5.5.2          IsEmpty
 5.5.3          If
 5.5.4          IsEqual
 5.5.5          IsEven
 5.5.6          IsGreater
 5.5.7          IsGreaterEqual
 5.5.8          IsIBANChecksumValid
 5.5.9          IsLess
 5.5.10           IsLessEqual
 5.5.11           IsMemberOfGroup
 5.5.12           IsNotEqual
 5.5.13           IsOdd
 5.5.14           IsValidXml
 5.5.15           Not
 5.5.16           Or
 5.5.17           ValidateNPR
 5.6        Futurama Formulas - Table
 5.6.1          FindNextRow
 5.6.2          FindPreviousRow
 5.6.3          FindRow
 5.6.4          Sort
 5.6.5          VLookUp
 5.7        Futurama Formulas - Document
 5.7.1          CountErrors
 5.7.2          GetPathToDataFiles
 5.7.3          GetPortNumber
 5.7.4          GetRelativePathToDataFiles
 5.7.5          GetSessionID
 5.7.6          IsLicenceAvailable
 5.7.7          ReadError
 5.7.8          ReadIdentityProviderResult
 5.7.9          ReadRequestIP
 5.7.10           ReadRequestParameter
 5.7.11           ReadUserAgent
 5.7.12           ReadVersionNumber
 5.7.13           SessionTimeOut
 5.7.14           URL
 5.7.15           UserName
 5.8        Futurama Formulas - Conversion
 5.8.1          Convert.Excel.to.XML
 5.8.2          ConvertJSONtoXml
 5.8.3          ConvertTextToDate
 5.8.4          ConvertTextToNumber
 5.8.5          ConvertToBoolean
 5.8.6          ConvertToDouble
 5.8.7          ConvertToLong
 5.8.8          ConvertToString
 5.8.9          FormatDate
 5.8.10           FormatNumber
 5.8.11           Value
 5.9        Futurama Formulas - Matrix
 5.9.1          AddMatrices
 5.9.2          AddScalarToMatrix
 5.9.3          Cumulative
 5.9.4          CumulativeProductMatrix
 5.9.5          Distinct
 5.9.6          DivideMatrices
 5.9.7          DivideMatrixScalar
 5.9.8          DivideScalarMatrix
 5.9.9          Exponent
 5.9.10           First
 5.9.11           Floor
 5.9.12           If
 5.9.13           Index
 5.9.14           Inverse
 5.9.15           IsEqual
 5.9.16           IsGreater
 5.9.17           IsGreaterEqual
 5.9.18           IsNotEqual
 5.9.19           IsLess
 5.9.20           IsLessEqual
 5.9.21           Join
 5.9.22           Last
 5.9.23           Length
 5.9.24           MatrixProduct
 5.9.25           Max
 5.9.26           MaxScalarMatrix
 5.9.27           Mean
 5.9.28           Mid
 5.9.29           Min
 5.9.30           MinScalarMatrix
 5.9.31           MultiplyMatrices
 5.9.32           MultiplyMatrixVector
 5.9.33           MultiplyScalarMatrix
 5.9.34           Percentile
 5.9.35           PowerMatrix
 5.9.36           PowerMatrixScalar
 5.9.37           PowerScalarMatrix
 5.9.38           ReadMatrixFromXml
 5.9.39           Repeat
 5.9.40           Replace
 5.9.41           Reshape
 5.9.42           ReverseCumulativeProductMatrix
 5.9.43           ReverseMatrix
 5.9.44           Size
 5.9.45           Split
 5.9.46           SquareRootMatrix
 5.9.47           Step
 5.9.48           SubtractMatrices
 5.9.49           SubtractMatrixScalar
 5.9.50           SubtractScalarMatrix
 5.9.51           Sum
 5.9.52           Transpose
 5.9.53           UnitMatrix
 5.9.54           Vector
 5.10         Creating custom formulas in Futurama
 6      Futurama - Objects
 6.1        Action
 6.2        Aggregation
 6.3        Button
 6.4        ChangeValue
 6.5        CheckBox
 6.6        ClearCache
 6.7        DatabaseField
 6.8        DatabaseView
 6.9        DataTable
 6.10         DateBox
 6.11         DocConverter
 6.12         Document
 6.13         Download
 6.14         DropDownList
 6.15         EmailConverter
 6.16         ExcelConverter
 6.17         FileSaver
 6.18         FileUploader
 6.19         Fixed
 6.20         Formula
 6.21         GraphConverter
 6.22         HTMLInclude
 6.23         InterfacesNode
 6.24         LogMessage
 6.25         Navigator
 6.26         Node
 6.27         RadioButton
 6.28         RadioGroup
 6.29         Range
 6.30         Reference
 6.31         SubDocument
 6.32         TextBox
 6.33         UserTable
 6.34         UserVariable
 6.35         WebLabel
 6.36         WebListBox
 6.37         WebPage
 6.38         WebPanel
 6.39         WebReference
 6.39.1           WebReference - WCF Configuration
 6.40         WebService
 6.41         WebSlider
 6.42         WordConverter
 6.43         XmlBuilder
 6.44         XmlConverter
 6.45         XmlField
 6.46         XmlNode
 7      Futurama - Vision References
 7.1        Data
 7.1.1          ReadData
 7.1.2          WriteMessage
 7.1.3          GetPersonIdentifiers
 7.1.4          CreatePerson
 7.2        DataStore
 7.2.1          DeleteDataItem
 7.2.2          DeleteDataItemHierarchy
 7.2.3          DeleteDataItems
 7.2.4          GetDataItem
 7.2.5          GetDataItemHierarchy
 7.2.6          GetDataItems
 7.2.7          StoreData
 7.3        Accounts
 7.3.1          Activate Account
 7.3.2          Change Account
 7.3.3          Create Account
 7.3.4          GetQuestion
 7.3.5          GetQuestions
 7.3.6          Login
 7.3.7          ReadData
 7.3.8          ReinitializeAccount
 7.4        General
 7.4.1          TestConnection
 8      Futurama Vision
 8.1        Installation Futurama Vision
 8.1.1          Installation Futurama Vision Management Site
 8.1.2          Installation or Upgrade of the Futurama Vision Database
 8.2        Futurama Vision Management Site
 8.2.1          Futurama Vision Management Site - Admin
 8.2.2          Futurama Vision Management Site – Security
 8.2.3          Futurama Vision Management Site – Skinning
 8.2.4          Importing data into Futurama Vision
 8.2.4.1            Importing data by webservice
 8.2.4.2            Importing data from a Zip-file
 8.2.4.3            Importing data with Futurama Vision Batch
 8.2.4.4            Futurama Vision Webservice Security
 8.2.5          Further processing of data into Futurama Vision
 8.3        Futurama Vision File manager
 8.4        Activity overview
 8.5        Storing data in Vision from a Futurama application
 8.6        Futurama Vision – Data
 8.7        Futurama Accounts - Management Site
 8.7.1          Futurama Accounts - Table in Vision Database
 8.8        Futurama Server - Management Site
 8.8.1          Special Futurama Server Jobs
 8.9        Futurama Register - Management Site
 8.9.1          Configuration - Futurama Register
 8.10         Retrieving AppEvents from Futurama Vision
 8.11         Adding CustomPages to Vision
 9      Futurama Intermediate Control Output (FICO)
 9.1        FICO example - Change/Add HTML headers
 9.2        FICO example - Change Graph
 9.3        HTML5 Template
 10       Futurama Web API
 10.1         Postbacks of Futurama webcontrols
 10.2         Retrieving Resources using Web API
 10.3         WebAPI Session management
 11       Tutorials - Overview
 11.1         Tutorials - Examples and Downloads
 11.2         Beginners
 11.2.1           Creating formulas with Futurama
 11.2.1.1             Exercise 1: Pythagorean Theorem (Easy)
 11.2.1.2             Exercise 2: Newspaper stall (Medium)
 11.2.1.3             Exercise 3: Recursive functions (Difficult)
 11.2.1.4             Exercise 4: Leap Year (Difficult)
 11.2.1.5             Exercise 5: The Guessing Game I (Medium)
 11.2.2           Creating a Website Application
 11.2.2.1             Exercise 1: Creating a Website (Easy)
 11.2.3           Styling your website with CSS
 11.2.3.1             Exercise 1: Adding CSS (Easy)
 11.2.4           Adding interactivity to your website
 11.2.4.1             Exercise 1: Summation (Easy)
 11.2.4.2             Exercise 2: The Guessing Game II (Medium)
 11.2.4.3             Exercise 3: Nationality (Medium)
 11.2.4.4             Exercise 4: Nationality - RepeatTarget (Medium)
 11.2.4.5             Exercise 5: Reversed Guessing (Difficult)
 11.2.5           Working with Tables
 11.2.5.1             Exercise 1: Average (Easy)
 11.2.5.2             Exercise 2: Boundary values (Difficult)
 11.2.5.3             Exercise 3: Standard Deviation (Medium)
 11.2.6           Reading and processing XML-data in Futurama
 11.2.6.1             Exercise 1: Shares (Medium)
 11.2.7           Adding Graphs in Futurama
 11.2.7.1             Exercise 1: World Population (Easy)
 11.2.8           Working with Actions in Futurama
 11.2.8.1             Exercise 1: Changing Colors (Easy)
 11.2.8.2             Exercise 2: On and Off (Medium)
 11.2.8.3             Exercise 3: The ChangeValue object (Difficult)
 11.2.8.4             Exercise 4: The Guessing Game III (Medium)
 11.2.8.5             Exercise 5: CheckBox (Medium)
 11.2.9           Multiple Pages and Navigation
 11.2.10            Using XSLT to display data
 11.2.10.1              Exercise 1: Overview Summation (Easy)
 11.2.10.2              Exercise 2: Persons (Medium)
 11.2.10.3              Exercise 3: Leap Year Overview (Difficult)
 11.2.11            Webservices in Futurama
 11.2.11.1              Exercise 1: Example (Easy)
 11.2.12            Creating a Webservice Application
 11.2.12.1              Exercise 1: Add (Easy)
 11.2.12.2              Exercise 2: Webservice Nationality (Medium)
 11.2.13            Creating a Console Application
 11.2.13.1              Exercise 1: Adding extra fields (Easy)
 11.2.14            Generating Documents
 11.2.14.1              Exercise 1: Tax Rate (Medium)
 11.2.14.2              Exercise 2: Tax Rates Table (Difficult)
 11.3         Advanced
 11.3.1           Responsive Design
 11.3.1.1             Exercise 1: Orientation
 11.3.1.2             Exercise 2: Target different screen sizes
 11.4         Older Tutorials (Futurama Version 3.2)
 11.4.1           Futurama Editor Tutorial 1: The first sum
 11.4.2           Futurama Editor Tutorial 2: An annuity
 11.4.3           Futurama Editor Tutorial 3: Working with tables
 11.4.4           Futurama Editor Tutorial 4: Modelling a DB pension plan
 11.4.5           Futurama Editor Tutorial 5: Working with XML
 11.4.6           Futurama Web Tutorial 1: Hello world
 11.4.7           Futurama Web Tutorial 2: Buttons and Actions
 11.4.8           Futurama Web Tutorial 3: Textboxes
 11.4.9           Futurama Web Tutorial 4: DropdownLists
 12       Miscellaneous
 12.1         Responsive website
 12.2         Reducing memory usage for XmlNodes and XmlFields
 12.3         Explaining caching for websites and webservices
 12.4         Certificates - basic information
 12.5         Performance XML operations
 12.6         Creating XSD files and using them in combination with Futurama
 13       Templates
 14       Safe2Save WebAPI Sample
View  |  Print  |  PDF

451 documents found.


Installation Futurama Server

Futurama-Server
System-administrator
Futurama-Export
Installation

 

Edition: Futurama Export

Module: Futurama Server

User: System administrator

Prerequisites

- License file

- User name and password for Futurama downloads

- Windows 2008 R2 server or higher

- .NET Framework 4.6.2

- Internet Information Server 7.5 or higher with ASP.Net to be installed

- Futurama Vision Management Site to be installed

- Futurama Vision Database to be installed

 

Description

To run Futurama Server jobs from the Futurama Vision Management Site, the module Futurama Server has to be installed. To install the module both the Futurama Service code and the Futurama Batch code has to be downloaded and installed. Futurama Service is a Windows Service. After installing the Futurama Service will be available in the Services console (to be opened via the control panel or the CMD command services.msc). The Futurama Service is controlled by the Futurama Vision Management Site. For the communication between the Management Site and the Futurama Services webservices are used. The default endpoint address of the Futurama Service is http://localhost:8080/FuturamaService. This location has to be configured in the configuration file of the Management Site. See the Futurama Server section of the 'Configuration' chapter of the installation of the Management Site for this configuration. 

For the installation of Futurama Service and Futurama Batch consult this installation page. 

Download

Visit the Futurama website www.futurama.eu to download the Futurama Server code:

  • Go to www.futurama.eu
  • Go to the download section of the Support menu
  • Log in with user name and password
  • Click the most recent Futurama release
  • Extract the zip-file

Installation Futurama Service

Release folder

Use the release code from the folder 'server'

Installation initial version

If this is the first installation of Futurama Service follow the steps in this paragraph. If you already have a Futurama Service installation, and want to upgrade this to a new version consult the next paragraph 'Upgrading existing version'. Follow the next steps to do the initial installation:

  • Create at the Windows webserver a new folder in which the code from the release folder can be installed
  • Copy the code from the release folder to this new folder
  • Copy the license file to this folder
  • Start a command prompt with full administrator permissions
  • Navigate in the command prompt to the directory where the Futurama Service code is installed
  • Execute the next command: C:\Windows\Microsoft.NET\Framework64\v4.0.30319\installutil futuramaserver.exe (for a 32 bit server this command has to be C:\Windows\Microsoft.NET\Framework\v4.0.30319\installutil futuramaserver.exe). Start the service within the services window (run -> services.msc). Look for the Futurama Service and right click on it and select 'start'.
  • Rename the default.config to FuturamaServer.exe.config (see the description in the chapter 'Configuration' for the way the FuturamaServer.exe.config can be configured)
  • Allow Windows permissions for the Futurama Service to listen on the required port by issuing the following command:
    netsh http add urlacl http://+:8080/ user=domain\user listen=yes delegate=no

Upgrading existing version

If you already have a Futurama Service installation, and want to upgrade this to a new version follow the steps in this paragraph. If this is the first installation follow the steps in the preceding paragraph 'Installation initial version'. Follow the next steps to upgrade an existing version of the Futurama Service:

  • Stop the existing Futurama Service (via services console, Futurama Service)
  • Open the folder at the Windows webserver where you have installed the Futurama Service code
  • Copy the code from the release folder to this new folder
  • Convert existing Futurama documents used for the Futurama Server processes to the new Futurama version. See the chapter 'Converting Futurama Documents' at the page 'Installation Futurama Editor' for more information regarding the conversion of Futurama documents
  • Start the Futurama Service

Configuration Futurama Service

Description

After installing the Futurama Service some configuration has to done. See below for this configuration.

Configuration File

In the release folder we provided a default.config. In the Installation steps mentioned above this default.config is renamed to FuturamaServer.exe.config. In this configuration section the sections within this configuration file are explained.

configSections and futuramaSettings

Within the section 'configSections' you find a sectionGroup named futuramaSettings. This sectionGroup futuramaSettings is also a separate section in the config under the configSections section. Each section name within the sectionGroup futuramaSettings is also contained within the futuramaSettings section. Below a brief explanation of these futuramaSettings sections.

Configuration Log

It is possible to log errors, warnings, information messages and developers messages with Futurama. In the chapter 'Configuration Log' you can find information how to configure the configuration file to log this information.

Configuration Server

In the chapter 'Configuration Server' you can find information about configuring the settings for running a Futurama Server job.

Bindings and endpoint

Within the <system.serviceModel> section of the configuration file the binding 'NetTcpBinding_Batch' is defined. This binding default has the endpoint address net.tcp://localhost:8081/FuturamaBatch. With this address the connection between Futurama Service and Futurama Batch is defined. It is possible to change this address of Futurama Batch to another port the 8081. For example when this port is already used by another process. If another port is chosen for this process both change the endpoint address and the chosen port in the server section.

Configuration file Futurama Vision Management Site

To start Futurama Server jobs from the Futurama Vision Management Site, in the configuration file of this Management Site some settings has to be done. See the Futurama Server section of the Configuration chapter of Installation Futurama Vision Management Site for these settings.

Read and write permissions

A commonly used application of the Futurama Server is to start jobs in order to create documents and save these documents to a specific location. In this process a Word-template is used to create these documents. This means that Futurama Service has to get read permissions (for reading the Word-template) and write permissions (for saving the documents). To configure these permissions go to FuturamaService within the Services console and select of create an identity with the read and write permissions to the locations.

Start the Futurama Service

The Futurama Service has to be started in order to perform Futurama Server tasks. Open the Services console and select FuturamaService. Then the Futurama Service can be started.

Restart the Futurama Service

If the configuration file of the Futurama Service is changed, the Futurama Service has to be restarted in order to use the new configuration file. To do this, open the Services console, navigate to FuturamaService, right click and select ‘restart’. After the restart a log will be created. This can also be used to check whether the log files are written in the correct folder.

Installation Futurama Batch

Release folder

Use the release code from the folder 'batch'

Installation initial version

If this is the first installation of Futurama Batch follow the steps in this paragraph. If you already have a Futurama Batch installation, and want to upgrade this to a new version consult the next paragraph 'Upgrading existing version'. Follow the next steps to do the initial installation:

  • Create at the Windows webserver a new folder in which the code from the release folder can be installed
  • Copy the code from the release folder to this new folder
  • Copy the license file to this folder
  • Rename the default.config to FuturamaBatch.exe.config (see the description in the chapter 'Configuration' for the way the FuturamaBatch.exe.config can be configured)

Upgrading existing version

If you already have a Futurama Batch installation, and want to upgrade this to a new version follow the steps in this paragraph. If this is the first installation the preceding paragraph 'Installation initial version'. Follow the next steps to upgrade an existing version of the Futurama Batch:

  • Open the folder at the Windows webserver where you have installed the Futurama Batch code
  • Copy the code from the release folder to this new folder

Configuration Futurama Batch

Description

After installing the Futurama Batch some configuration has to done. See below for this configuration.

Configuration File

In the release folder we provided a default.config. In the Installation steps mentioned above this default.config is renamed to FuturamaBatch.exe.config. In this configuration section the sections within this configuration file are explained.

configSections and futuramaSettings

Within the section 'configSections' you find a sectionGroup named futuramaSettings. This sectionGroup futuramaSettings is also a separate section in the config under the configSections section. Each section name within the sectionGroup futuramaSettings is also contained within the futuramaSettings section. Below a brief explanation of these futuramaSettings sections.

Configuration Log

It is possible to log errors, warnings, information messages and developers messages with Futurama. In the chapter 'Configuration Log' you can find information how to configure the configuration file to log this information.

Configuration Format

The format settings of for example dates and numbers are described in the chapter 'Configuration Format'.

Configuration Mapping

In the chapter 'Configuration Mapping' you can find information about configuring default locations of your Futurama applications. The attribute 'rootPath' can be used to indicate the location of the Futurama documents to be used while performing a Futurama Server job.  

appSettings

The appSettings section of the configuration file is a place to store connection strings, server names, file paths and other miscellaneous settings that can be used by a Futurama application. The items inside the appSettings are items that need to be configurable depending upon environment. For instance, any database connection strings will change as you move your application from a testing server into production. With the Futurama formula 'ReadConfigKey' the value of any of these keys can be read and used within the modelling of your application.

Defining a Futurama Server job

To perform Futurama Server jobs, these jobs have to be defined. See this page for the settings in these jobs.

Testing

The installation and the configuration can be tested. See below how to test. If you encounter problems, check the chapter 'Troubleshooting'.

Futurama Service in Services console

Open the services console (via the control panel or the CMD command services.msc). Check whether Futurama Service is one of the services in the list.

Futurama Service is running

Open the services console (via the control panel or the CMD command services.msc). Select FuturamaService and check whether this service is started.

WSDL Futurama Service is available

Browse to the url http://localhost:8080/?WSDL to check whether the WSDL is available.

Troubleshooting

If you encounter problems with the installation check the sections below.

Logging information

In the web.config the log section is configured. First step in troubleshooting is checking the information in the different log files. Make sure that the log information is actually created. If you don't see any log information consult the chapter 'Configuration Log' for the settings to get this information.

Futurama Services not in Services console

If the Futurama Services is not a service in the Services console, something went wrong with the installatin of Futurama Services. Make sure that the command prompt is opened with administrator permissions, and no errors occured while executing the install command in this prompt.

Futurama Service can not be started

Open the services console (via the control panel or the CMD command services.msc). Select FuturamaService and check whether this service is started. If this service is not started, then start the service. If the Futurama Service immediately after starting stops again, then the port 8080 (the port Futurama Service uses) is already used by another process on the server. See the next troubleshoot for more information.

Port Futurama Service is used by another process

Futurama Service default uses the 8080 port. It is possible that at the same server another process already uses this port. In that situation it is not possible to perform Futurama Server tasks. See the steps mentioned below to detect which process allreay uses the 8080 port:

  1. Start a command prompt with full administrator permissions
  2. Execute the command netstat -ao. A list of the active processes is displayed
  3. Check whether the port 8080 is in this list. If so, this means that another process uses this same port
  4. Find the corresponding process ID (PID) of this process
  5. Open the Windows taskmanager
  6. Dependable on your Windows server version find the tab where the PID are displayed. Find in this tab the process that has the PID found in step 4

In order to start the Futurama Service the process found in step 6 has to be stopped.

Changes in config of Futurama Service seems not to be applied

If changes have to made in FuturamaServer.exe.config, make sure to restart the Futurama Service via the services console. After restarting the Futurama Service the changes will be applied.

Port Futurama Batch is used by another process

Futurama Batch default uses the 8081 port. It is possible that at the same server another process already uses this port. See the preceding troubleshoot how to detect which process uses this port. It is possible to choose another port for Futurama Batch. See for explanation the chapter 'Configuration Futurama Service', paragraph 'Configuration File'. Make sure that both the endpoint address and the port at the server section is changed to the same port.

No endpoint listening error message in log Futurama Service

The error message 'There was no endpoint listening at http://localhost:8081/FuturamaBatch that could accept the message' (where http://localhost:8081/FuturamaBatch is the endpoint address of Futurama Batch defined in the configuration file of Futurama Service) in the log of Futurama Service implies that Futurama batch is not listening at this configured address. This error can be given in the situation the configuration file of Futurama Batch does not exist, or is not valid. Check in an XML editor whether this file is valid.

Futurama Batch can not be started

It is possible that Futurama Batch can not be started. This can have various reasons. For example the the lack of the license file or anti virus software preventing to start Futurama Batch. It is possible to check whether Futurama Batch can be started and what potentially is the reason if Futurama Batch can not be started. Follow the next steps:

  1. Start a command prompt with full administrator permissions
  2. Navigate in the command prompt to the directory where the Futurama Batch code is installed
  3. Execute the command futuramabatch 0 8081, where 8081 is the port that is chosen as the address of Futurama Batch (see also the preceding troubleshoot)
  4. If it is not possible to start Futurama Batch an error message will be displayed with the reason for not starting Futurama Batch

Related Topics

- Futurama Server menu of Futurama Vision Management Site: description of the Futurama Server part of the Management Site to start and monitor Futurama Server processes

- Defining server jobs: description how to define a Futurama Server job

Feedback

If you have any questions about this subject or if you want to provide us feedback please send us an e-mail.

Updated: 2018-02-14


Previous  |  Next