3.9 Resource properties - Studio sections
The Studio client application allows sections of resource property files to be edited.
When Studio creates a new project a unique project id is generated using the current date time.
When the Studio application publishes the project entries to the instance server, the resource properties file replaces the current studio-project section (Identified by the id attribute) and inserts the new data. If a studio-project section is not found a new section is appended to the end of the file.
A studio-project section with id="20000000-000000" is reserved by LANSA.
A studio-project section can be created manually using a text editor. The following example illustrates a manual entry with an id="20030101-000000" to hold some override property entries.
All property file entries must exist within a studio-project section, during an upgrade process any entries found outside a section will be placed in the studio-project id="00000000-000000" name="unassigned" section. They should be assigned to another section or deleted.
The following example illustrates how the shipped manager.properties file has had an extra section added to the bottom. The final tcp.port=4562 will be used, also manager and client tracing have been enabled. When LANSA Integrator is upgraded the upgrade process will replace the studio-project id="20000000-000000" with a new section but other sections in the properties file will remain. The section replacement will occur at the current location of the old section, so section order is maintained.
It is best practice not to modify entries in the LANSA studio section but add your own section to the bottom of the file. These entries will remain untouched during an upgrade.
#!<studio-project id="20000000-000000" name="lansa">
#
# Java Service Manager configuration
#
tcp.port=4560
tcp.backlog=20
tcp.interface=*all
#
# console.tcp.port=4561
# console.tcp.backlog=5
# console.tcp.interface=*all
#
# trace.manager=*yes
# trace.transport.address=*all
# trace.transport.error.address=*all
# trace.service.address=*all
# trace.service.error.address=*all
#
#!</studio-project>
#
#!<studio-project id="20030101-000000" name="user-override">
#
tcp.port=4562
tcp.backlog=20
tcp.interface=*all
#
console.tcp.port=4563
console.tcp.backlog=5
console.tcp.interface=*all
#
trace.manager=*yes
trace.service.address=*all
#
#!</studio-project>