Server Preferences

Copyright © MultiAd, Inc., 2002 - 2006

This document describes how to edit Creator Server's preferences file, which is located in the Resources directory. The ServerPrefsSchema.xsd file defines the proper format of Preferences.xml and can be used to validate your changes with an XML validation tool. The schema also defines what data type each tag expects. The following documentation describes the function of each of the Preferences.xml tags.

<StartupMode>: Specifies the mode Creator Server starts up in. May be Network, Console, Daemon, or File.

<StartupPort>: Specifies the port Creator Server listens on if starting up in Network mode.

<StartupFile>: Specifies the file Creator Server uses as a script input if starting up in File mode.

<AssertMode>: Specifies how Creator Server handles asserts in the code. Asserts fire when something very unexpected has happened and are only present in special debug builds. May be Ask, Throw, or Ignore. Ask will prompt the user for input via stdin/stdout. Throw will throw an exception and usually ends up in the command failing. Ignore will continue execution. Release builds ignore this option completely.

<SessionTimeout>: Sets how many seconds to wait until discarding a disconnected session.

<Logging>: Controls Creator Server's logging. You may turn it on or off by setting the tag attribute "On" to true or false. The following describes the sub tags:

<SaveDir>: What directory to save the log file in, must end with a /.

<LogErroredCommands>: Boolean (true/false). Log commands that fail.

<LogWarnedCommands>: Boolean (true/false). Log commands that succeed but return with a warning code (200-299).

<LogEveryCommand>: Boolean (true/false). Log every command.

<LogEveryReply>: Boolean (true/false). Log every reply.

<LogConnections>: Boolean (true/false). Log connections and disconnections.

<LogReconnects>: Boolean (true/false). Log reconnections.

<LogFonts>: Boolean (true/false). Log font information as the fonts are loaded.

<MaxSizeBytes>:
<MaxSizeKilobytes>:
<MaxSizeMegabytes>:
<MaxSizeGigabytes>:
Maximum size, in the tag's unit (bytes/kilobytes/megabytes/gigabytes), that the log file is allowed to get. This value must be greater than or equal to 1 kilobyte (1024 bytes), and less than or equal to 4 gigabytes (4,294,967,295 bytes), although it may be further limited by what your OS's filesystem may support. When a log file exceeds this value, it is rolled off in the same directory with ".n" extensions. For example, "creatorserver.log" will become "creatorserver.log.0", any existing "creatorserver.log.0" will become "creatorserver.log.1", and so on. If a MaxSize tag is not specified, it defaults to one gigabyte (1,073,741,824 bytes). Only one of these four tags should be used; if multiples are found, only the last one is used.

<GraphicPrefs>: No Attributes. These settings affect how graphics are places in a Creator Document. The following describes the sub tags:

<UsePhotoshopMasks>: The default mode for using photo shop masks in placed graphics. May be set to true or false. This setting is also controlled from the command language on a per-session basis.

<WarnIfGraphicIsMissingFonts>: The default mode for returning a warning if a graphic is missing fonts. May be set to true or false. This setting is also controlled from the command language on a per-session basis.

<PreprocessEPS>: The default mode for preprocessing compressed EPS files. May be set to true or false. This setting is also controlled from the command language on a per-session basis.

<SpotsAsProcess>: The default mode for using EPS spot colors as process colors. May be set to true or false. This setting is also controlled from the command language on a per-session basis.

<AddSpotColors>: The default mode for adding EPS spot colors to the colors palette. May be set to true or false. This setting is also controlled from the command language on a per-session basis.

<MaxResolution>: The maximum resolution that an image will be rendered at. While this doesn't control the resolution of the actual output files, it limits the internal resolution at which the document is rendered. This means the effective resolution of any output files will be capped by this setting. The default is set to 300 DPI. This setting would be useful when trying to render vector based files to bitmap output ( e.g. EPS -> JPEG ).

<EPSTruePreviews>: The default mode when dealing with EPS true preview generation. May be set to Always, IfNecessary, or Never. True previews are EPS previews that our own engine generates. If you have no need of previews, or if you know the EPS files you use already have previews, turning this option off can improve EPS loading time. This setting is also controlled from the command language on a per-session basis.

<PSIFontPreference>: The default mode for embedded font use in placed EPS and PDF files. May be set to UseSystem (use Creator Server's installed fonts) or UseEmbedded (use the embedded font). This setting is also controlled from the command language on a per-session basis.

<AntiAliasing>: The default mode for antialiasing. May be set to true or false. This setting is also controlled from the command language on a per-session basis.

<LPR>: Controls the ability of Creator Server to act as an LPR printer, this is further described in LPR Network Printing. You may turn it on or off by setting the tag attribute "On" to true or false. The following describes the sub tags:

<Port>: What port to listen for LPR print jobs on, 515 is standard.

<SaveDirectory>: What directory to save the PostScript files in, must end with a /.

<RestrictIPs>: Controls Creator Server's ability to filter incoming connections to a set list of IP addresses you provide. You may turn it on or off by setting the tag attribute "On" to true or false. The following describes the sub tags:

<Allow>: An IP address that should be allowed to connect. This tag may occur an unlimited number of times.

<MaxSessions>: The maximum number of simultaneous sessions allowed. This may be turned on or off by setting the tag attribute "On" to true or false.