Installing Cassiopeia

To install Cassiopeia on your Mac go to the Advanced Science website, click on Download and get Cassiopeia.2.2.2.pkg. Upon completion of the download, locate the file in your Downloads folder and double-click on the package to install.

On newer MacOSX releases the Cassiopeia package might initially refuse to install and give the following or a similar message.


This problem can easily be solved by temporarily changing a MacOSX security setting. Click on the Apple in the upper left corner of the screen, go to System Preferences - Security & Privacy and change the following setting to Anywhere.

Double-click on the Cassiopeia package again. It installs fine now. Alternatively, right-click (Control-click) on the installer package and select "Open" from the contextual menu. In the resulting confirmation dialog, click Open. The installation will proceed as expected. Once installed drag /Applications/Cassiopeia.app into your dock and start the application. You may set your personal license key now (optional but recommended). Open the Cassiopeia preferences panel


switch to the License pane and copy/paste your key into the License field.


If you have not yet received a personal license key click on License and fill out the registration form. A key will be sent to you via Email.

Choose Database - Log On from the Cassiopeia menu now.


Cassiopeia will try to locate a FrontBase installation (required for the app to operate properly). If none is found FrontBase is automatically installed. In that case click Database - Log On again after the FrontBase installation has completed. Cassiopeia will also try to locate a default database named Cassiopeia.fb. If none is found an empty default database (readily configured) is installed automatically. Database - Log On should allow you to log in now.

Make sure the Cloud control in the lower left corner is not checked (see next section for information about connecting the cloud) and use ROOT for the username and leave the password fields blank. Note, the panel asks for a database account, not your system account. So do not enter the username and password you use to log into Mac OS X.

If a panel appears requesting permission for executing SQL statements on the database

click on Yes.

Cassiopeia is fully operational now and you may start creating documents (see Getting Started). However, when it comes to printing Cassiopeia generates LaTeX code. It needs a LaTeX installation to automatically compile the generated LaTeX code and open the resulting PDF. There are numerous sources for LaTeX packages for MacOSX available on the internet (google for MacTeX).

If you have no idea which package to choose download and install BasicTeX.pkg. Any other LaTeX distribution from a different source should do as well.

Connecting to the cloud

A default database on your local Mac is installed automatically as part of the Cassiopeia installation (see last section). You may connect to this local database by choosing Database - Log On from the menu, unchecking the Cloud control in the lower left corner and using ROOT for the usename and no password.

Alternatively you can connect to and make use of a remote database running in the Advanced Science Data Center. Making use of the Advanced Science Cloud gives you access to your documents whereever and on whichever machine you are without having to setup a VPN infrastructure on your own. You can for example access the cloud with your iMac when working in the office and have access to the same set of documents when being on the road with your Mac Book. No synchronisation is needed whatsoever. All you need is a connection to the internet and a Cassiopeia installation on all Macs you plan to access your documents with.

To connect to the cloud choose Database - Log On from the Cassiopeia menu and make sure the Cloud control in the lower left corner is checked. This automatically sets the connection parameters for cloud access.

Then enter the cloud username - the one you have selected while filling out the registration form on our website - in the User name: field and the password you have chosen in the User password: field and click on OK. Cassiopeia now connects to the cloud and loads the latest model and gui. This might take a couple of seconds depending on the speed of your internet connection. After successfully connecting to the cloud the following Object Browser window appears.

You can now start using Cassiopeia in the cloud, e.g. by creating a new document with Command-N. See Getting Started for a step-by-step introduction into using Cassiopeia.

Upgrading a local database

After upgrading Cassiopeia to a newer version the database schema of the local (pre-existing) database may have to be upgraded as well. This process is completely automated and requires hardly any user intervention. Choose Database - Log On as usual


and log into the local database. Use ROOT for the username and leave the password field blank. If Cassiopeia detects a discrepancy between the current database schema and the schema required by the new Cassiopeia version corresponding SQL statements are generated automatically to upgrade the schema. You may be asked a couple of times for permission to execute these statements.

Confirm by clicking on YES. Once the schema is completely upgraded the usual Object Browser window appears.


You may start using Cassiopeia now as usual. See Getting Started for a detailed introduction.

If you encounter any problems feel free to contact our support team at support@advanced-science.com. Your questions are welcome and feedback is greatly appreciated!

Advanced Science          Terms and Conditions          © Smartsoft GmbH 2015