ArrayServer.cfg

From Array Suite Wiki

Jump to: navigation, search

This is a comprehensive list of ArrayServer.cfg options. Options should be added to the proper section, indicated by [SectionName].

Contents

License section

Identified by [License] in configuration file.

[back to top]

Option section

Identified by [Option] in configuration file. Options include:

Administrative Options

[back to top]


Analytical Server Options

[back to top]

Cluster Options

Tips.png Also read Setup ArrayServer in Cluster.

[back to top]


Connection Options

Basic

Email Options

Only set these options if admin knows the SMTP service is working. Without setting these options, it will use Omicsoft Mail service to send job information to users.

FTP Options

[back to top]

Proxy Options

Other connection options

[back to top]


Database Options

Directory Options

[back to top]

Sample, SampleSets, and Project Options

[back to top]


Default URL Options

User Configuration Options

[back to top]

Genome Browser Options

Land

Cloud section

In the [Cloud] section:

Tips.png Also read ArrayServer Configuration with Cloud.

[back to top]

CloudFolder section

Mapped folders to Cloud should be listed here. For more information and examples, please see ArrayServer Configuration with Cloud.

[back to top]


CloudInstanceTag section

These parameters go in the [CloudInstanceTag] section, for labeling cloud instances for cost-control and tracking purposes. For more information, please see CloudInstanceTag.

CloudVolumeTag Section

These parameters go in the [CloudVolumeTag] section, for labeling cloud instances for cost-control and tracking purposes. For more information, please see CloudVolumeTag.

[back to top]


CFRPart11 section

In the [CFRPart11] section. Code of Federal Regulations Title 21, Part 11 specifies rules for electronic records. These parameters focus on password expiration and session timeout lengths. To be active, UserAuthorization must be set to True.

Land section

By default, land configuration file is a separate file, LandDataName.cfg, located in the $LandDirectory/LandDataName. However, user can also specify land directly in ArrayServer.cfg, identified by [Land] in the configuration file for each land data.

Tips.png Also read ArrayLand Configuration Options and LandDirectory

Filter section

Identified by the [Filter] section in configuration file.

  • Lists the meta data fields that can be used for filtering returned project searches, as well as criterion in the Custom tab for Add Criterion.
  • If the section is not specified, default fields will be returned ("Category", "Keywords", "PublishedBy", "PublishDate", "Organism", "StudyType", "Platform", "PlatformType", "PlatformOrganism", "PlatformTechnology", "SoftwareUsed, "Title").

Folder section

Identified by [Folder] section in configuration file.

  • Lists the folders that the user wants Array Server to monitor (for the client, they will be able to browse/search the files in the watched folders if they have read access to the files).
  • Each folder should be put on a separate line, and the format for each line is
  • for Windows single server configuration
FolderAlias=\\192.168.1.xxx\Data\TestDataSets
  • for Linux single server configuration,
FolderAlias=/media/Data/TestDataSets
  • for distributed server folder configuration (Master and Analytic servers).
FolderAlias=FullPathWindows | FullPathLinux | AnalyticalServerName
e.g DataTransfer=\\192.168.1.xxx\Data\DataTransfer|/media/Data/data_transfer|AnalyticServer1
In the example above, DataTransfer is the alias of the folder, and the Windows full path for the watched folder is "\\192.168.1.xxx\Data\DataTransfer", Linux full path is "/media/Data/data_transfer". The folder belongs to AnalyticServer1, which must be specified in the [AnalyticServers] section. The "ownership" of this folder can be used in some modules to redirect analysis to the appropriate analytic server.
  • Use Manage Users to specify folder permissions for read and write access.
  • It is not required to have both a Windows and Linux mapping, however, if this cannot be provided, the administrator should place instead an informative message that can be shown to the users, i.e
DataTransfer=\\192.168.1.xxx\Data\DataTransfer|No_Linux_Users_Folder_Mapped|AnalyticServer1

Tips.png Also read ArrayServer folder mapping and management

[back to top]


SearchProject section

Identified by [SearchProject] in configuration file.

Specifies the search project user interface tabs for the user. Each line in the section will specify either a branch of the category tree (e.g. Disease=Diseases) or a project meta data field (e.g. Organism and Platform).

For the first type of SearchProject tab, the format is “BranchAlias=BranchPath”. In the example above, Disease is the alias of the branch, and Diseases is the branch path. If the user would like to specify deeper levels of a branch, the user will need to use “\” to separate different levels (e.g. Location=CompanyName\By Location”).

For the second type of SearchProject tab, the meta data field must be either a Select type or a Combo InputType (it cannot be an "Input" InputType meta data field). The following user interface illustrates the concept.

SearchProjectTab.png

[back to top]


NextBio section

In the [NextBio] section. Specifies optional configuration for integration with NextBio.

Example:

[NextBio]
AutoCompleteUrl=http://?????.nextbio.com/c/nbapi/autocomplete.api?v=0&apikey=???????????????????????
ApiUrl=http://????.nextbio.com/c/nbapi
ApiKey=?????????????????
OntologyUrl=https://????????.nextbio.com/ont
FtpUrl=snbftp.nextbio.com
FtpUser=??????????
FtpPassword=?????????
NextBioIntegration=True
FtpPort=22

Administrator can also add NextBio specific fields to the default.template file, which controls the meta data using NextBio ontology.

[back to top]


AnalyticServers

Used to specify the location, name, ServerProjects, and Users folder location of each Analytic folder.

Each server should have the following format:

tcp://addressOfServer:port/RemoteServer | Name of Server | \\UsersFolderWindowsMapping | /UsersFolderLinuxMapping | \\ServerProjectsWindowsMapping | /ServerProjectsLinuxMapping | Server Description

An example is shown again below:

tcp://192.168.1.128:8065/RemoteServer|WindowsServer|\\192.168.1.xxx\Data\Users|/home/omicsoft/fileserver/Data/Users|\\192.168.1.xxx\Data\ServerProjects|/home/omicsoft/fileserver/Data/ServerProjects
|server#1 description

A few points of note:

  • It is not required to have both a Windows and Linux mapping, however, if this cannot be provided, the administrator should place instead an informative message that can be shown to the users, i.e
tcp://192.168.1.128:8065/RemoteServer|LinuxServer|No_Windows_Users_Folder_Mapped|/home/omicsoft/fileserver/Data/Users|No_Windows_ServerProjects_Folder_Mapped|/home/omicsoft/fileserver/Data/ServerProjects
|server#1 description
  • The name of the analytic server will need to match exactly the name provided in the [AnalyticServers] of the associated server
  • If the administrator wishes to use the master server as an analytic server, this information must also be specified in the [AnalyticServers] section. If the server is not specified, it will not be available as an analytic server. If it is specified, the administrator must also specify the option AnalyticServerName in the Option section, and as above, the name must match.

Tips.png Also read Master Server and Analytic Server.

[back to top]


Database

  • Provider: either Sqlite or Oracle or ODP (Windows ArrayServer only for direct ODP connection) (if Sqlite is specified the other options are ignored)
  • Server: specify the location of the Oracle server (IP address)
  • Port: specify the port of the Oracle server
  • DataSource: specify the name of the oracle database to be used
  • DataFileDirectory: species the location of the tablespace files
  • User: specify the oracle user to be used for accessing the database
  • Password: specify the password for the oracle user for accessing the database
  • UseSqliteForBigTables: set to True to use Sqlite for the larger tables (Inference Report, autofill, etc.). Set to True by default.

Database Backup section

In the [DBBackup] section. Example:

[DBBackup]
BackupDirectory=C:\__Working\ArrayServerHome Test\BACKUP
IntervalInDays=1
BackupStartTime=01:00
[back to top]

Updating ArrayServer.cfg

When an ArrayServer admin changes the contents of ArrayServer.cfg, changes will not be seen until ArrayServer is restarted.

[back to top]

Related Articles

[back to top]

EnvelopeLarge2.png