1 | initial version |

Dear Roland, you are right, the instructions are not up to date.

While we go to great lengths to ensure every piece of the code is properly documented, we sometimes lag behind when it comes to usage instructions.

I have made https://wiki.sagemath.org/SageAppliance an index page linking to different instructions pages for different versions of SageMath.

The 7.0 version still needs the appropriate updates but at least now it warns that the instructions are not up to date. I hope someone can figure out how to update the instructions. I myself don't have access to Windows.

I hope this gets settled soon, and thank you for alerting us to this situation.

2 | No.2 Revision |

Dear Roland, you are right, the instructions are not up to date.

While we go to great lengths to ensure every piece of the code is properly documented,
we sometimes lag behind when it comes to usage ~~instructions.~~instructions for the system as a whole.

I ~~have made ~~changed the wiki so that https://wiki.sagemath.org/SageAppliance ~~ ~~is now an index page
linking to different instructions pages for different versions of ~~SageMath.~~

SageMath.
The ~~7.0 version ~~page you referred to above is now
https://wiki.sagemath.org/SageAppliance/Sage-5-x-or-6-x

I will now comment on the 5-step instructions you suggest.

Are these the steps for Sage-7.0 for Windows / VM Virtualbox?

- load sage-7.0.ova as normal in VM Virtualbox
- Go to http://localhost:8000/tree within your browser
- On the top right select New and than SageMath 7.0
- You see at the top Jupyter Notebook Untitled
- You have to select Run instead of pressing Enter to perform a command

Yes, these are valid steps. In 5., to evaluate a cell, you can either select Run or press shift-Enter.

This should help to update the instructions page.

For new users, that is all. For users who have existing SageNotebook worksheets (.sws files) and want to use them with Sage 7.0, there is more to say.

There are basically two approaches, either

- either run the (legacy) Sage Notebook in Sage 7.0
(it is still
~~needs the appropriate updates but~~present) and keep using your .sws worksheets, - or convert your worksheets to Jupyter notebook worksheets.

We need to document how to run the legacy Sage Notebook. Possibly, lauching the command "notebook()" in a Jupyter notebook worksheet might launch the Sage Notebook and you could go from there. I haven't tried.

Converting the worksheets from .sws to .ipynb also needs
to be documented. There is a sws2sagews script at ~~least now
it warns that the instructions are not up to date. I hope someone can
figure out how to update the instructions. I myself don't have access to Windows.~~

I hope this gets settled soon, and thank you for alerting us to this situation.

SageMathCloud which goes from .sws to .sagews SageMathCloud worksheets, and a sagews2ipynb script to go from .sagews to .ipynb.So to convert your worksheets to .ipynb, you could upload them to SageMathCloud, and run sws2sagews followed by sagews2ipynb on them, then download them and use them with your Sage virtual machine.

3 | No.3 Revision |

Dear Roland, you are right, the instructions are not up to date.

While we go to great lengths to ensure every piece of the code is properly documented, we sometimes lag behind when it comes to usage instructions for the system as a whole.

I changed the wiki so that ~~https://wiki.sagemath.org/SageAppliance is ~~https://wiki.sagemath.org/SageAppliance
now ~~an index page
linking to different ~~points to instructions pages for different versions of SageMath.
The page you referred to above is now
~~https://wiki.sagemath.org/SageAppliance/Sage-5-x-or-6-x~~https://wiki.sagemath.org/SageAppliance/Sage-5-x-or-6-x
and I added one for Sage 7.0 and later.

I will now comment on the 5-step instructions you suggest.

Are these the steps for Sage-7.0 for Windows / VM Virtualbox?

- load sage-7.0.ova as normal in VM Virtualbox
- Go to http://localhost:8000/tree within your browser
- On the top right select New and than SageMath 7.0
- You see at the top Jupyter Notebook Untitled
- You have to select Run instead of pressing Enter to perform a command

Yes, these are valid steps. In ~~5., ~~step 5, to evaluate a cell,
you can either select Run or press shift-Enter.

This should help to update the instructions page.

For new users, that is all. For users who have existing SageNotebook worksheets (.sws files) and want to use them with Sage 7.0, there is more to say.

There are basically two approaches, either

- either run the (legacy) Sage Notebook in Sage 7.0 (it is still present) and keep using your .sws worksheets,
- or convert your worksheets to Jupyter notebook worksheets.

We need to document how to run the legacy Sage Notebook. Possibly, lauching the command "notebook()" in a Jupyter notebook worksheet might launch the Sage Notebook and you could go from there. I haven't tried.

Converting the worksheets from .sws to .ipynb also needs to be documented. There is a sws2sagews script at SageMathCloud which goes from .sws to .sagews SageMathCloud worksheets, and a sagews2ipynb script to go from .sagews to .ipynb.

So to convert your worksheets to .ipynb, you could upload them to SageMathCloud, and run sws2sagews followed by sagews2ipynb on them, then download them and use them with your Sage virtual machine.

4 | No.4 Revision |

Dear Roland, you are right, the instructions are not up to date.

While we go to great lengths to ensure every piece of the code is properly documented, we sometimes lag behind when it comes to usage instructions for the system as a whole.

I changed the wiki so that https://wiki.sagemath.org/SageAppliance now points to instructions pages for different versions of SageMath. The page you referred to above is now https://wiki.sagemath.org/SageAppliance/Sage-5-x-or-6-x and I added one for Sage 7.0 and later.

I will now comment on the 5-step instructions you suggest.

Are these the steps for Sage-7.0 for Windows / VM Virtualbox?

- load sage-7.0.ova as normal in VM Virtualbox
- Go to http://localhost:8000/tree within your browser
- On the top right select New and than SageMath 7.0
- You see at the top Jupyter Notebook Untitled
- You have to select Run instead of pressing Enter to perform a command

Yes, these are valid steps. In step 5, to evaluate a cell, you can either select Run or press shift-Enter.

This should help to update the instructions page.

For new users, that is all. For users who have existing SageNotebook worksheets (.sws files) and want to use them with Sage 7.0, there is more to say.

There are basically two approaches, either

~~either~~run the~~(legacy) Sage Notebook~~legacy Sage Notebook, still present in Sage~~7.0 (it is still present) and keep using~~7.0, and uplad your .sws~~worksheets,~~worksheets to it,- or convert your worksheets to Jupyter notebook worksheets.

We need to document how to run the legacy Sage Notebook. Possibly, lauching the command "notebook()" in a Jupyter notebook worksheet might launch the Sage Notebook and you could go from there. I haven't tried.

Converting the worksheets from .sws to .ipynb also needs to be documented. There is a sws2sagews script at SageMathCloud which goes from .sws to .sagews SageMathCloud worksheets, and a sagews2ipynb script to go from .sagews to .ipynb.

So to convert your worksheets to .ipynb, you could upload them to SageMathCloud, and run sws2sagews followed by sagews2ipynb on them, then download them and use them with your Sage virtual machine.

Copyright Sage, 2010. Some rights reserved under creative commons license. Content on this site is licensed under a Creative Commons Attribution Share Alike 3.0 license.