Homepage | About EASA | Contact
This section describes tasks involved in managing the content on your EASA system, which include:
Administrators can determine which of the available client types in EASA are allowed to be used by users to open EASAPs. Currently, in EASA there are two client types:
One or both of the clients can be made available to users. The default is to allow both client types. To adjust allowed clients per User, go to:
An Author may export an EASAP to an .easap file and then import it into a different EASA installation.
Go to:
See Author's Application Menu for more details.
EASA comes with a set of executable wizard tools that help migrate an EASA <SERVERDATA> folder to a new installation. The requirements to run each tool are identical to running the EASA installer itself with the additional condition that the new EASA installation has to be on the same machine and operating system as the previous source installation.
Note: Using any of the Import Tools will automatically invalidate any existing licenses on the target installation. As a result, having the new license ready before using the tool is recommended.
In the EASA 5.3 start menu group there are two tools:
These tools can be used to copy contents from an EASA <SERVERDATA> folder of an earlier EASA installation to a new EASA 5.3 installation.
The version number signifies the older version, thus:
The Import Data and Settings Wizard is intended for use on a new EASA installation as it will delete any existing content.
Use these instructions if the source installation version is 4.3.3 or older.
For two EASA installations on the same computer:
For two EASA installations on different computers:
If copying the entire EASA installation between computers is not a viable solution, you may choose to manually copy relevant content using the instructions provided below at Manual Import from EASA 4.3.3 or Older Versions.
From the start menu on Windows, navigate to the application:
Optionally there may be 'custom code' files obtained from EASA Technical Services. Determine whether the old versions of the custom code files can be carried forward to the new installation or else new files will need to be delivered. Review the class names stored in the .properties files. The following table details where these files are:
Source: <EASAROOT>… | Destination: <SERVERDATA>… | Description |
---|---|---|
\custom | \easa\custom | Custom code .jar files |
\client\custom | \easa\client\custom | Custom code .jar files for the EASA Client |
\admin\config | \easa\admin\config | .properties files |
Do not overwrite the .properties files above as this may replace important properties with defaults. Instead, compare, review, then merge the files line-by-line.
All EASA content should be imported and up to date for use by the EASA Server.
Follow the instructions detailed in this paragraph if the source installation version is 5.0 or newer.
If you are copying between EASA installations on the same computer:
If you are copying between EASA installations on different computers:
Ensure that the target EASA Server is stopped.
Note: If copying the entire EASA installation between computers is not a viable solution, you may choose to manually copy relevant content using the instructions provided below at Manual Import from EASA 5.0 or Newer Versions.
Optionally there are files related to custom codes. These are supplied by the EASA Technical Services team and should be reviewed whether the old versions of the custom code files can be carried forward to the new installation or new files are to be delivered. The class names stored in the .properties files should also be reviewed accordingly. The following table details where these files are:
Source: <SERVERDATA>… | Destination: <SERVERDATA>… | Description |
---|---|---|
\custom|\easa\custom | Custom code .jar files | |
\client\custom | \easa\client\custom | Custom code .jar files for the EASA Client |
\admin\config | \easa\admin\config | .properties files |
Note: The .properties files above should not be copied over as important properties could be lost by overwriting the default files. Instead, they should be compared and reviewed to determine which lines should be merged into the new files.
Next, start the EASA service on the target machine, log in and switch to Administrator.
All of EASA content should be imported and up to date for use with EASA.
Use of the 'Import Data and Settings Wizard' is recommended in most cases. However, in some cases (particularly under the advice of an EASA Support Representative), it may be necessary to take manual control of the migration process. If the new installation is on a different machine or operating system than the previous source installation or if the Import Tools cannot be used by any other reason, manual import is available. This method includes copying of the old files to the appropriate folders on the new installation folder structure and as a result you need access to both file systems (in case of different machines).
The table below will detail which files you need to copy from the source folder an where to put them in the new data folder. The <EASAROOT> designation refers to the EASA Installation Folder, while <SERVERDATA> refers to the EASA Server Data folder, both of which were specified at installation time.
Source: <EASAROOT>… | Destination: <SERVERDATA>… | Files To Copy |
---|---|---|
\webapps\jsf-easa\admin\custom_config | \jsf-easa\admin\config | ALL |
\webapps\easa-ws\admin\custom_config | \easa-ws\admin\config | ALL |
\webapps\compute\admin\custom_config | \compute\admin\config | ALL |
Source: <SERVERDATA>… | Destination: <SERVERDATA>… | Files To Copy | |
---|---|---|---|
\Shared | \easa\Shared | ALL | |
\admin\config\naming | \easa-share\naming | ALL except Jndi.properties | |
\drivers | \easa-share\drivers | ALL | |
\admin|\easa\admin | ALL files with the exceptions below: | ||
Files containing easarun | Ignore | ||
auth.properties | Ignore but keep a backup | ||
Authentication.properties | Ignore but keep a backup | ||
ldap.properties | Ignore but keep a backup | ||
context.properties | Merge contents as desired | ||
Menu.properties | Merge contents as desired | ||
System.properties | Merge contents as desired | ||
\db | \easa\db | ALL | |
\ew | \easa\ew | ALL | |
\testenv | \easa\testenv | ALL | |
\tmp | \easa\tmp | ALL | |
\users | \easa\users | ALL | |
\applications | \easa\applications | ALL |
Optionally there are files related to custom codes. These are supplied by the EASA Technical Services team and should be reviewed whether the old versions of the custom code files can be carried forward to the new installation or new files are to be delivered. The class names stored in the .properties files should also be reviewed accordingly. The following table details where these files are:
Source: <SERVERDATA>… | Destination: <SERVERDATA>… | Files Description |
---|---|---|
\custom | \easa\custom | Custom code .jar files |
\client\custom | \easa\client\custom | Custom code .jar files for the EASA Client |
\admin\config | \easa\admin\config | .properties files |
Note: The .properties files above should not be copied over as important properties could be lost by overwriting the default files. Instead, they should be compared and reviewed to determine which lines should be merged into the new files.
Once the file operations are done, carry on following these steps:
ThE last step ensures that all Results data is imported correctly.
Tables depicting file system locations of content to be copied are provided below. They represent the same processes used by the Import Data and Settings Wizard.
Note: Destination folders for Settings, Applications and Results must be emptied or deleted before old content is copied over. This is to say, data should not be merged.
The location of the EASA application files on the source installation will vary depending on version.
For EASA 4.3, the folder path was as follows:
<EASAROOT>\webapps\easa
For EASA versions 4.2 and earlier, the folder path was as follows:
<EASAROOT>\EASA
In the tables that follow, you will need to substitute <EASAROOT> with these paths.
Source: <EASAROOT>… | Destination: <SERVERDATA>… | Files To Copy | |
---|---|---|---|
\webapps\excel\admin\custom_config | \excel\admin\config | ALL (if source folder exists) | |
\webapps\jsf-easa\admin\cusom_config | \jsf-easa\admin\cusom_config | ALL (if source folder exists) | |
\webapps\easa-ws\admin\cusom_config | \easa-ws\admin\cusom_config | ALL (if source folder exists) | |
\webapps\compute\admin\cusom_config | \compute\admin\cusom_config | ALL (if source folder exists) | |
\webapps\easa\Shared|\easa\Shared | ALL | ||
\webapps\easa\admin\config\naming | \easa-share\naming | ALL | |
\easa\admin\config\naming\jdbc | ALL | ||
\easa\client | ALL | ||
\drivers | \easa-share\drivers | ALL (if not empty) | |
\webapps\easa\WEB-INF\lib\drivers | \easa\sync\data\drivers | ALL (if not empty) | |
\webapps\easa\admin | \easa\admin | ALL files with the exceptions below: | |
Files containing easarun | Ignore | ||
auth.properties | Ignore but keep a backup | ||
Authentication.properties | Ignore but keep a backup | ||
ldap.properties | Ignore but keep a backup | ||
context.properties | Merge contents as desired | ||
Menu.properties | Merge contents as desired | ||
System.properties | Merge contents as desired | ||
\webapps\easa\admin\custom_config | \easa\admin\custom_config|context.properties|| |\webapps\easa\ew | \easa\ew|ALL|| |\webapps\easa\testenv | \easa\testenv|ALL|| |\webapps\easa\tmp |
Should you require further explanation or assistance with the manual folder migration process, please email support@easasoftware.com.