Installing Service Release 2
Service Release 2 includes improvements to every area of MetaEdit+: the program itself, the modeling languages and reports included, and the HTML help files. In a clean 3.0 SR2 installation, these are of course immediately ready for use. To upgrade an existing installation, you can follow the instructions on this page.
To upgrade to 3.0 SR2, you must first upgrade to at least SR1. For upgrading a 3.0 SR1 installation to 3.0 SR2, some care must be taken, especially if you have made your own modifications to the modeling languages in the database, or changed or added reports. If you have made no such changes, you can follow the basic instructions; otherwise, you should also read the detailed instructions.
Basic Instructions: if you have changed no modeling languages or reports
When downloading the files that make up this Service Release, if your screen fills with rubbish you should select 'Save Link As...' or similar from the link's pop-up menu, rather than just clicking the link.
Program update
Download the image patch: me010322.pat
Download the new visual executable: vw31c.zip
Replace visual.exe (Windows) or visual (Linux) in your MetaEdit+ installation directory with the new
version from vw31c.zip. File the me010322.pat patch into your image in the normal way,
remembering that if you save the image with a different name, you should change your
shortcut for starting MetaEdit+ to use the new image name.
If you have a MetaEdit+ server, you will need to download this server image patch: mes010313.pat. Replace the server's visual.exe as above, restart the server program, file in the patch with Maintenance | Load Patch, and exit and save the server image. Please note that you must not mix pre-SR2 and SR2 clients and servers: all must be at the same version level.
Database update
These updates should only be applied to an existing standard SR1 demo or db database. They will overwrite any of your own changes made to the types supplied with the standard database. If you have your own database which does not include types from the original demo or db databases, you need not apply this update.
The new databases contain the following changes:
- New metamodelling tutorial and domain-specific modelling example with 100% code generation
- Improved reports for documentation and code generation
- All reports updated to use '_default directory' subreport to generate output to .\reports\ subdirectory
- UML Collaboration Diagram Bindings corrected: added client and supplier roles to dependency relationship
- UML Interface client role's and implements role's line color changed to darker grey
To apply the updates:
- Download the zipped update patches:
patch30u.zip
- Unzip the patches into your MetaEdit+ directory
- Backup your existing database
- Import the updated types to your existing database
- Start MetaEdit+ 3.0 SR2, and login as sysadmin to your existing database, opening all projects
- From the Main Launcher, select Repository | Options to open an Options Tool
- On the Repository page, press File in Patches
- Select the 01mcc.pat patch file, and choose 'file in' from the pop-up menu
- When prompted for the project for new types or instances, choose the one in the patch name, i.e. mcc
- Repeat steps d and e for each of the other type patch files 02*.pat-13*.pat
- Add the new Family Tree Evaluation Tutorial: only for 'demo' database
- From the Main Launcher, select Repository | New Project... and create a project Family Tree, giving access to all users
- File in Family Tree.pat as above
- Add the new Watch Example: only for 'demo' database
- From the Main Launcher, select Repository | New Project... and create a project Watch, giving access to all users
- File in Watch.pat as above
- Commit and exit
- If you have other standard databases, repeat steps 2-6 for each
Reports update
Download the new Word template and icons:
reportsSR2.zip
Unzip this file into your MetaEdit+ startup directory. It will create a
'reports' subdirectory with the new MetaEdit+.dot, and a 'reports\image'
subdirectory with the icons for the new HTML generation. You can delete the old
MetaEdit+.dot from your MetaEdit+ startup directory.
The reports themselves are updated by the program update and database update above. If you don't apply the database update, see the detailed instructions below for how to update the '_default directory' report and copy MetaEdit+.dot to the MetaEdit+ startup directory.
Documentation update
Download the zipped HTML manuals: manualsSR2.zip
Unzip this file into your manuals directory, allowing it to overwrite files and
create new directories as necessary. It contains an updated index.html, updated
System Administrator's Guide, and new Evaluation Tutorial and Watch Example.
Detailed instructions
Reports update
If you have changed any existing generic reports in the Graph metatype, or reused any from there as subreports from your own reports, you should be aware that filing in patch me010322.pat will add, change and delete some reports in the Graph metatype, possibly affecting your own reports. Similarly, if you have added or changed reports in Project Model, and file in the SR2 Project Model types into your existing database, your changes will be overwritten. In either of the above cases, you should thus check the report changes in SR2 before applying it, and integrate your own changes with them.
To use the new documentation reports requires four things:
- New and updated generic reports in Graph meta-type
- Makes all generated report files be output in subdirectory .\reports (specified in the '_default directory' report)
- Make the generated document use .\reports\ MetaEdit+.dot for its styles etc.
- Stored in the image
- Updated by filing in me010322.pat to the image
- New and updated reports in Project Model type
- Improve the layout of the report output
- Stored in the db and demo MetaEdit+ dbs, in project mcc.
- Updated by logging into your db as sysadmin, opening the mcc project, and filing in mcc.pat.
- Word template MetaEdit+.dot
- Contains AutoOpen macro which creates a single .DOC file from the .RTF file and .PCT files generated by the report
- Just a Word 97 template file
- Simply place the file in a new 'reports' subdirectory under the MetaEdit+ start-up directory
- Icons for HTML report
- Just GIF graphics files
- Simply place the files in a new 'reports\images' subdirectory under the MetaEdit+ start-up directory
Report changes in me010322.pat
Please note that this image patch also updates those reports stored in the Graph metatype, i.e. in the image. If you have changed any of these reports, or made other reports that rely on them, you should see the list of report changes below. Also, reports here now use the '_default directory' report to specify the directory for report output. If you will continue to use the reports supplied by MetaCase Consulting in previous versions, you should edit the '_default directory' report with Edit Reports from the Startup Launcher: change it to output nothing instead of the 'reports\' path, then save your image.
New:
- _default directory
- _graphs with icons in HTML
Updated:
- Export graph to HTML.rep
- _Dictionary in HTML.rep
- _Object properties in HTML
- _Relationships in HTML
- _Links in HTML.rep
- Export graph to Word.rep
- _RTF documentation cover page
- _Dictionary in RTF.rep