Content of the config.ini file

From IASO Wiki
Jump to: navigation, search

Contents


Content of the config.ini file

Permanent constants

Config.ini file contains permanent (base) and possible constants, therefore firstly draw your attention to all basic parameters that are usually specified during Client installation.

[General]
Protocol=FTPS
Server=server_address
User=user_name
Password=password
UseProxy=false
ProxyType=0
ProxyAddress=
ProxyPort=0
UseProxyAuthorization=false
ProxyUsername=
ProxyPassword=
EncryptionKey=your_encryption_key

These parameters can be changed when it is needed using one of the values described below.

Protocol means a type of connection and could have following possible values:

  • FTPS[:port]
  • FS
  • WEBDAVS[:port] (combination of WebDAV protocol with SSL/TLS protocol)

443 port will be set by default if port value is not specified.

Server means server address that depends on protocol specified:

  • FTPS: Server=server_IP_address or host_name
  • FS: Server=Disk:\Folder_name (e.g. D:\Test01) where Test01 is folder to store the data. This folder should be created on your storage drive.
  • WEBDAVS: Server=WEBDAV_server_IP_address

User means account name of a contract for authentication (created via MC).

Password means users password for authentication (created via MC).

EncryptionKey means a word or a sentence of your choose used for encryption your files to keep your data confidential. The maximum length is 30, and the minimum is 6. Keep your encryption key safe: if you lose your key, your data gets useless!

Proxy means a security barrier between your internal network and the Internet, preventing other Internet users from accessing the information on your internal network. Proxy has two possible values: true to enable proxy, false to disable it. E.g.:

[General]
UseProxy=true

or

[General]
UseProxy=false

ProxyType has following possible values for choose:

  • HTTP
  • SOCKS4
  • SOCKS5
  • 0 (in case proxy is disabled)

ProxyAddress means proxy server IP address

ProxyPort correspondingly means proxy port

UseProxyAuthorization gives an ability to enable or disable Proxy authorization. It has following values for choose:

  • true (to enable)
  • false (to disable)

ProxyUsername — proxy username for authentication

ProxyPassword — password for authentication

Possible constants

Below you can find description of not permanent (possible) constants that could be specified in case when an appropriate functionality is needed. Please do not forget to specify (if it is not specified yet) an appropriate group ([Group]) name in the square brackets before every new section of parameters.

General:

[General]
PathToLocalStorage=path_to_local_storage
AllowExchangeRestart=1

PathToLocalStorage means a path to the local DB in case you choose a new place for it.

AllowExchangeRestart means an ability of a system to restart Exchange (Microsoft Exchange Information Store service) in case when VSS Writer is not in a stable state. Possible value is only 1.

[General]
CommunicationPort=7777 ; where 7777 is necessary port

CommunicationPort means TCP port 5314 that is set by default. But with this parameter you can easily change it to any port you need.

Logging:

[Logging]
LoggingLevel=Debug

LoggingLevel is a parameter that allows to get more detailed logs information.

Recovery:

[Recovery]
RecoveryMode=On

Recovery mode means that right on start FP performs BR consistency check/repair procedures. As such consistency check procedures can take pretty long time, recovery mode is switched off by default, with setting specified above you can switch it on. To switch it off back, delete or comment out last line.

Cache:

[Cache]
BackupCacheLocation=cache_destination
BackupCacheUser=username_for_authentication
BackupCachePassword=password_for_authentication

BackupCache (LocalSpeedVault) functionality means that your data will be cached on a local or network drive (depends on your choice).

BackupCacheLocation means a path to a directory where data register and storage are duplicated from the server in a local network during backup.

BackupCacheUser and BackupCachePassword are username and password required in case of Cache on a network drive.

RestoreCache allows using memory or disk cache for restore. Cabinet Cache for Restore is enabled by default and set to Memory Cache with 256Mb limitation. But you are able to set the limit for this cache yourself (when it is reached, old cabinets will be evicted) and change the type of this functionality from Memory Cache to Disk Cache. Just specify the strings mentioned below:

[Cache]
RestoreCacheSizeLimitInMb=N ; where N is required limitation in Mb
RestoreCacheType=FS
RestoreCacheLocation=cache_destination
RestoreCacheEnabled=0

RestoreCacheLocation means a path to a temporary location for restoring cabinets.

RestoreCacheEnabled=0 is necessary only in case you want to disable this functionality. (Do not forget that this functionality is enabled by default!)

Backup:

[Backup]
MaxCabinetSize=N ; where N is limit for maximum cabinet size

MaxCabinetSize means a limit for maximum summary cabinet size in Mb.

New options related to case when exchange backup meets error 1450 — "Insufficient system resources exist to complete the requested service" — became available. Most frequently this error occurs on Windows 2003 x86 when Exchange backup is running. If system resources are insufficient the system will retry the process with intervals. By default number of attempts is 3, of delay is 1000 (in milliseconds). To change number of attempts and delays you will be able using following strings:

AttemptNumber=N (N — desired number of attempts)

AttemptDelay=M (M — desired number of delays)

Restore:

[Restore]
ExpandSystemState

ExpandSystemState allows to expand system state tree on the restore tab.

Personal tools
Namespaces
Variants
Actions
Navigation
Downloads
Knowledge Base
Support
Toolbox