Common Editor Operations

Problem

Writing a model file fails and prints the error “Unable to write model because it was opened read-only. Try a different name.”

Solution

Rename Model – The model file has acquired the “read-only” attribute due to some interaction with Modeler, and cannot be written out with the current name. The model file may be “locked” because it is in use in another editor or by another Modeler user. To recover from this situation, you should either

  • circulate through the open editors and look for a editor with that model loaded and exit that editor
  • write out the model with another name

Problem

During interactive use of Modeler, the cursor disappears or stays in the “hourglass” mode for a long time (several minutes). A simulation is not being executed, and the workstation or network does not seem to be excessively loaded (as evidenced by the ability to open up windows via the window system menus).

Solution

  • Kill modeler from the parent shell – Modeler is probably in an unrecoverable error state, and must be forcibly exited. If the parent shell window is visible or reachable via window manipulation, move the window system cursor into the shell window and halt Modeler by holding down the <Control> key and pressing <c>.

  • Kill modeler via alternative methods – If Modeler’s parent shell window is not accessible, kill the Modeler process from another shell or via a remote login. Under modeler, determine the process ID of Modeler via the ps command. The arguments to ps will depend on the type of host workstation and operating system. The ID of the Modeler process usually appears under the “PID” column of the program’s output listing. To kill the Modeler process, issue the kill command:

    kill -9 <process_id>
    

    Under Windows, bring up the Task Manager by typing <control> <esc> at any time. Select the modeler task and select “End Task” from the dialog box.

Note: If Modeler is killed, changes to models that were being edited in editor windows are lost if they had not been saved to disk. Although this type of situation is rare, it is typically a good idea to write models out to disk after major changes. Modeler has an automatic backup facility, which by default saves open models to disk every 15 minutes. After Modeler is killed, the user’s backup directory should be checked for the models undergoing edits, as a potential source for data recovery. A backup directory is located in each user’s home directory: <HOME>/op_admin/bk.

Problem

A model does not produce the results shown in the tutorial.

Solution

  • Confirm your work – Make sure you have followed all steps exactly. Double-check all code you entered and attribute values you set.

  • Compare your work to ours – Add the reference model subdirectory to the “mod_dirs” preference. To do this, choose File > Model File > Add Model Directory; then add the subdirectory within the top-level reference model directory. This directory is located at:

    <reldir>/models/tutorial_ref/
    

    If the reference model runs and generates the expected results, you probably introduced an error into your model while going through the tutorial. The most common errors are partially completing a step, omitting a step altogether, and typographical errors.

  • Verify that you have the latest models and documentation installed – If the reference model does not run, or if it generates different results, make sure that you are using the latest releases of both the model library and the documentation. Because the models and documentation are frequently updated, the instructions and results can differ from one release to the next. If you have updated your model library, but are using an older documentation release, you may be doing an out-dated tutorial. Upgrading to the latest model library and documentation should solve this problem. To determine which documentation and model library release you have, choose Help > About This Application. You can compare this information to the latest product updates, which are available for download from the Software & Documentation section of the support website (support.riverbed.com).